Add-PowerBIEncryptionKey

为分配给容量的 Power BI 工作区添加加密密钥。

语法

DefaultAndActivate (默认值)

Add-PowerBIEncryptionKey
    -Name <String>
    -KeyVaultKeyUri <String>
    [-Default]
    [-Activate]
    [<CommonParameters>]

Default

Add-PowerBIEncryptionKey
    -Name <String>
    -KeyVaultKeyUri <String>
    [-Default]
    [<CommonParameters>]

Activate

Add-PowerBIEncryptionKey
    -Name <String>
    -KeyVaultKeyUri <String>
    [-Activate]
    [<CommonParameters>]

说明

关联分配给高级容量的 Power BI 工作区的加密密钥。 请确保在 Azure Key Vault 中为 Power BI 服务授予包装和解包密钥权限。

运行此命令之前,请确保使用 Connect-PowerBIServiceAccount 登录。 此 cmdlet 要求调用用户成为 Power BI 服务的租户管理员。

示例

示例 1

PS C:\> Add-PowerBIEncryptionKey -Name 'Contoso Sales' -KeyVaultKeyUri 'https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2'

参数

-Activate

指示激活任何未激活的容量以将此密钥用于其加密

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

DefaultAndActivate
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
Activate
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Default

指示此密钥已设置为整个租户的默认值。 任何新的容量创建都将在创建时继承此密钥。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

DefaultAndActivate
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False
Default
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-KeyVaultKeyUri

要使用的“Azure Key Vault”密钥版本的 URI。 仅支持 4096 字节键。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

加密密钥的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

None

输出

Microsoft.PowerBI.Common.Api.Encryption.EncryptionKey