你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Use-AipServiceKeyVaultKey

告知 Azure 信息保护在 Azure 密钥保管库中使用客户管理的租户密钥。

语法

Use-AipServiceKeyVaultKey
   -KeyVaultKeyUrl <String>
   [-FriendlyName <String>]
   [-Force]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

Use-AipServiceKeyVaultKey cmdlet 告知 Azure 信息保护在 Azure 密钥保管库中使用客户管理的密钥 (BYOK) 。

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

可以在激活 Azure Rights Management () 保护服务之前或之后运行此 cmdlet。

运行此 cmdlet 之前,请确保已向 Azure Rights Management 服务主体授予对包含要用于 Azure 信息保护密钥的密钥保管库的权限。 通过运行 Azure 密钥保管库 cmdlet Set-AzKeyVaultAccessPolicy 授予这些权限。

出于安全原因,Use-AipServiceKeyVaultKey cmdlet 不允许在 Azure 密钥保管库中设置或更改密钥的访问控制。 运行 Set-AzKeyVaultAccessPolicy 授予该访问权限后,请运行 Use-AipServiceKeyVaultKey,告知 Azure 信息保护使用使用 KeyVaultKeyUrl 参数指定的密钥和版本。

有关详细信息,请参阅有关选择 Azure 密钥保管库位置的最佳做法

备注

如果在向密钥保管库授予权限之前运行此 cmdlet,则会看到显示 Rights Management 服务未能添加密钥的错误。

若要查看更多详细信息,请使用 -Verbose 再次运行命令。 如果未授予权限,则会看到 VERBOSE:无法访问 Azure KeyVault

成功运行命令后,会将密钥添加为组织的 Azure 信息保护存档的客户管理的租户密钥。 若要使其成为 Azure 信息保护的活动租户密钥,必须运行 Set-AipServiceKeyProperties cmdlet。

使用 Azure 密钥保管库集中管理和监视你指定的密钥的使用。 对租户密钥的所有调用都将对组织拥有的密钥保管库进行。 可以使用 Get-AipServiceKeys cmdlet 确认你在密钥保管库中使用哪个密钥。

有关 Azure 信息保护支持的租户密钥类型的详细信息,请参阅规划和实现 Azure 信息保护租户密钥

有关 Azure Key Vault 的详细信息,请参阅什么是 Azure Key Vault

示例

示例 1:将 Azure 信息保护配置为在 Azure 密钥保管库中使用客户管理的密钥

PS C:\>Use-AipServiceKeyVaultKey -KeyVaultKeyUrl "https://contoso.vault.azure.net/keys/contoso-aipservice-key/aaaabbbbcccc111122223333"

此命令告知 Azure 信息保护在名为 contoso 的密钥保管库中使用名为 contoso-aipservice-key 的密钥(版本 aaaabbbbcccc1111222233333)。

Azure 密钥保管库中的此密钥和版本将成为 Azure 信息保护的客户管理的租户密钥。

参数

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

-Force

强制运行命令而不要求用户确认。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FriendlyName

指定受信任的发布域 (TPD) 和从 AD RMS 导入的 SLC 密钥的友好名称。

如果用户运行 Office 2016 或 Office 2013,请在“服务器证书”选项卡上为 AD RMS 群集属性指定相同的友好名称值。

此参数是可选的。 如果不使用它,则改用密钥标识符。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-KeyVaultKeyUrl

指定要用于租户密钥的 Azure 密钥保管库中的密钥和版本的 URL。

Azure 信息保护将此密钥用作租户的所有加密操作的根密钥。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False