Import-AipServiceTpd

Import-AipServiceTpd
    [-Force]
    -TpdFile <String>
    -ProtectionPassword <SecureString>
    [-FriendlyName <String>]
    [-KeyVaultKeyUrl <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

O cmdlet Import-AipServiceTpd importa um domínio de publicação confiável (TPD) do Ative Directory Rights Management Services (AD RMS) pela Internet para seu locatário da Proteção de Informações do Azure, para que você possa migrar seu serviço de proteção do local para a nuvem. O TPD contém a sua chave privada e modelos de proteção do AD RMS.

Você deve usar o PowerShell para configurar sua chave de locatário; Não é possível fazer essa configuração usando um portal de gerenciamento.

Esse cmdlet sempre define a chave do TPD importado para um estado arquivado. Depois de executar esse comando, a chave no TPD importado fica disponível para a Proteção de Informações do Azure para consumir conteúdo protegido pelo AD RMS usando essa chave. Use o cmdlet Set-AipServiceKeyProperties para alterar o estado do TPD importado para Ativo.

Se você migrar modelos do AD RMS como ativo, poderá editá-los no portal do Azure ou usando o PowerShell. Você pode publicar esses modelos para que os usuários possam selecioná-los a partir de aplicativos. Se os modelos migrados não forem ativados, eles só poderão ser usados para abrir documentos que eles protegeram anteriormente.

Tem de utilizar a consola de gestão do AD RMS para exportar o TPD. Se você usar um módulo de segurança de hardware (HSM) para suas chaves, deverá primeiro reempacotar as chaves TPD usando as ferramentas BYOK do Cofre de Chaves do Azure. Para obter mais informações, consulte Como gerar e transferir chaves protegidas por HSM para o Azure Key Vault.

PS C:\>$Password = Read-Host -AsSecureString -Prompt "Password: "
PS C:\> Import-AipServiceTpd -TpdFile "C:\aipservice_tpd.xml" -ProtectionPassword $Password -Verbose

O primeiro comando cria uma senha como uma cadeia de caracteres segura usando o cmdlet Read-Host e, em seguida, armazena a cadeia de caracteres segura na variável $Password. Para obter mais informações, digite Get-Help Read-Host.

O segundo comando importa um TPD com uma chave de software.

PS C:\>$Password = Read-Host -AsSecureString -Prompt "Password: "
PS C:\> Import-AipServiceTpd -TpdFile "C:\no_key_tpd.xml" -ProtectionPassword $Password -KeyVaultKeyUrl "https://contoso-byok-kv.vault.azure.net/keys/contosoaipservice-byok/aaaabbbbcccc111122223333" -FriendlyName "Contoso BYOK key" -Verbose

O primeiro comando cria uma senha como uma cadeia de caracteres segura e, em seguida, armazena a cadeia de caracteres segura na variável $Password.

O segundo comando importa um TPD para ser usado com uma chave armazenada no Cofre de Chaves do Azure. Além disso, o comando altera o nome amigável da chave para "Contoso BYOK key".

Nosso exemplo usa o nome do cofre da chave de contoso-byok-kv, o nome da chave de contosoaipservice-byoke o número da versão de aaaabbbbcccc111122223333.

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.