Set-AipServiceKeyProperties

Set-AipServiceKeyProperties
    [-Force]
    -KeyIdentifier <String>
    -Active <Boolean>
    [-WhatIf]
    [-Confirm]
    [-RefreshSlcName]
    [<CommonParameters>]

O cmdlet Set-AipServiceKeyProperties altera um status arquivado para um objeto de chave especificado para que o locatário seja Ativo. Como pode haver apenas uma chave de locatário ativa ao mesmo tempo, a chave de locatário ativa anteriormente é definida automaticamente como Arquivada.

Os novos usuários da Proteção de Informações do Azure usam imediatamente a chave de locatário identificada para proteger o conteúdo. Os usuários existentes do serviço fazem a transição gradual da chave de locatário anteriormente ativa para a chave de locatário recém-ativa, e essa transição escalonada pode levar algumas semanas para ser concluída. Você pode forçar a atualização nos clientes inicializando novamente o ambiente do usuário (também conhecido como inicialização). Documentos e arquivos protegidos com a chave de locatário anteriormente ativa permanecem acessíveis aos usuários autorizados usando a chave de locatário que agora está arquivada.

Definir o status do objeto de chave de locatário como Active também renuncia a todos os modelos de proteção com a chave de locatário recém-ativa. Como essa pode ser uma operação demorada, especialmente se você tiver muitos modelos de proteção, não recomendamos que você execute essa operação com frequência.

Para executar esse cmdlet, você deve especificar o KeyIdentifier para o objeto de chave de locatário que deseja definir como Ativo. Para obter esse valor, use o cmdlet Get-AipServiceKeys .

A menos que você esteja no meio de uma migração do AD RMS, não ative uma chave RSA de 1024 bits, que é considerada um nível inadequado de proteção. A Microsoft não endossa o uso de comprimentos de chave inferiores, como chaves RSA de 1024 bits e o uso associado de protocolos que oferecem níveis inadequados de proteção, como SHA-1. É recomendável mover para um comprimento de chave mais alto.

Para obter mais informações sobre a chave de locatário, consulte Planejando e implementando sua chave de locatário da Proteção de Informações do Azure.

PS C:\> Set-AipServiceKeyProperties -Force -KeyIdentifier "c0f102b3-02cc-4816-b732-fcee73edd0e6" -Active $True

Esse comando altera o status de um objeto de chave de locatário de Arquivado para Ativo. o parâmetro KeyIdentifier identifica o objeto de chave de locatário a ser alterado e esse valor pode ser encontrado executando Get-AipServiceKeys. O objeto de chave de locatário que anteriormente tinha um status de Active é automaticamente definido como Arquivado.

Como o comando especifica o parâmetro Force, o comando não solicita confirmação.

PS C:\> Set-AipServiceKeyProperties -KeyIdentifier "c0f102b3-02cc-4816-b732-fcee73edd0e6" -RefreshSlcName

Esse comando recupera o nome amigável do locatário atual do Azure Active Directory e atualiza o SLC para que as chaves de usuário reflitam o mesmo nome.

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.