Set-AipServiceKeyProperties
Atualizações as propriedades de um objeto de chave de locatário para o Proteção de Informações do Azure.
Syntax
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.
Observação
Você não pode usar esse cmdlet para alterar um status ativo a ser arquivado. Para definir um objeto de chave de locatário para ter um status de Arquivo Arquivado, você deve definir outro objeto de chave de locatário como Ativo.
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 $TrueEsse 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
Define o status do objeto de chave de locatário.
Esse parâmetro só pode ser usado com o valor de $True, que define o status como Ativo. Se você quiser alterar o status de um objeto de chave de locatário para Arquivado, deverá definir outro objeto de chave de locatário como Ativo.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-KeyIdentifier
Especifica o identificador de chave para o objeto de chave de locatário. Você pode obter esse valor executando Get-AipServiceKeys.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |