Import-AipServiceTpd

语法

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

说明

Import-AipServiceTpd cmdlet 通过 Internet 将 Active Directory Rights Management Services（AD RMS）受信任的发布域（TPD）导入到 Azure 信息保护的租户中，以便可以将保护服务从本地迁移到云。 TPD 包含 AD RMS 中的私钥和保护模板。

必须使用 PowerShell 配置租户密钥;无法使用管理门户执行此配置。

此 cmdlet 始终将导入的 TPD 中的密钥设置为存档状态。 运行此命令后，导入的 TPD 中的密钥可供 Azure 信息保护使用，以使用此密钥保护 AD RMS 保护的内容。 使用 Set-AipServiceKeyProperties cmdlet 将导入的 TPD 的状态更改为 Active。

如果以活动方式从 AD RMS 迁移模板，则可以在 Azure 门户中或使用 PowerShell 编辑这些模板。 可以发布这些模板，以便用户可以从应用程序中选择它们。 如果未激活已迁移的模板，则它们只能用于打开以前保护的文档。

必须使用 AD RMS 管理控制台导出 TPD。 如果对密钥使用硬件安全模块（HSM），则必须首先使用 Azure Key Vault BYOK 工具重新打包 TPD 密钥。 有关详细信息，请参阅 如何为 Azure Key Vault生成和传输受 HSM 保护的密钥。

示例

示例 1：使用软件密钥导入 TPD

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

第一个命令使用 Read-Host cmdlet 创建密码作为安全字符串，然后将安全字符串存储在$Password变量中。 有关详细信息，请键入 Get-Help Read-Host。

第二个命令使用软件密钥导入 TPD。

示例 2：使用 HSM 密钥导入 TPD

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

第一个命令将密码创建为安全字符串，然后将安全字符串存储在 $Password 变量中。

第二个命令导入要与存储在 Azure Key Vault 中的密钥一起使用的 TPD。 此外，该命令会将密钥的友好名称更改为 “Contoso BYOK 键”。

我们的示例使用 contoso-byok-kv、contosoaipservice-byok的密钥保管库名称以及 aaaabbbbcccc111122223333的版本号。

参数

-Confirm

-Force

-FriendlyName

-KeyVaultKeyUrl

-ProtectionPassword

-TpdFile

-WhatIf

相关链接

• Set-AipServiceKeyProperties
• 从 AD RMS 迁移到 Azure 信息保护
• 如何为 Azure Key Vault 生成和传输受 HSM 保护的密钥