Set-AipServiceKeyProperties

Sintaxe

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

Description

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.

Novos usuários do Azure Proteção de Informações usar imediatamente a chave de locatário identificada para proteger o conteúdo. Os usuários existentes do serviço passam gradualmente da chave de locatário ativa anteriormente 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 ativa anteriormente permanecem acessíveis para 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 você 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. Recomendamos mover para um comprimento de chave mais alto.

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

Exemplos

Exemplo 1: alterar o status de um objeto de chave de locatário para estar ativo

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 do Active é automaticamente definido como Arquivado.

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

Parâmetros

-Active

-Confirm

-Force

-KeyIdentifier

-WhatIf

Links Relacionados

• Get-AipServiceKeys