你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Set-AzRecoveryServicesVaultProperty
更新保管库的属性。
语法
Set-AzRecoveryServicesVaultProperty
[-SoftDeleteFeatureState <String>]
[-DisableHybridBackupSecurityFeature <Boolean>]
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-Token <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-AzRecoveryServicesVaultProperty
[-VaultId <String>]
[-DefaultProfile <IAzureContextContainer>]
[-Token <String>]
-EncryptionKeyId <String>
[-KeyVaultSubscriptionId <String>]
[-InfrastructureEncryption]
[-UseSystemAssignedIdentity <Boolean>]
[-UserAssignedIdentity <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
Set-AzRecoveryServicesVaultProperty cmdlet 更新恢复服务保管库的属性。 此 cmdlet 可用于启用/禁用/AlwaysON 软删除或为具有两个不同参数集的保管库设置 CMK 加密。 仅当保管库中没有已注册的容器时,才能禁用保管库的 SoftDeleteFeatureState 属性。 只能在用户首次更新 CMK 保管库时设置 InfrastructurEncryption。
示例
示例 1:更新保管库的 SoftDeleteFeatureState
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$props = Set-AzRecoveryServicesVaultProperty -VaultId $vault.Id -SoftDeleteFeatureState Enable
第一个命令获取 Vault 对象,然后将其存储在$vault变量中。 第二个命令将保管库的 SoftDeleteFeatureState 属性更新为“已启用”状态。 SoftDeleteFeatureState 的允许值为 Disable、Enable、AlwaysON。
示例 2:更新保管库的 CMK 加密以使用 SystemAssigned MSIdentity
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$keyVault = Get-AzKeyVault -VaultName "keyVaultName" -ResourceGroupName "RGName"
$key = Get-AzKeyVaultKey -VaultName "keyVaultName" -Name "keyName"
Set-AzRecoveryServicesVaultProperty -EncryptionKeyId $key.ID -InfrastructureEncryption -VaultId $vault.ID -UseSystemAssignedIdentity $true
第一个 cmdlet 获取用于更新加密属性的 RSVault。 第二个 cmdlet 获取 Azure 密钥保管库。 第三个 cmdlet 从密钥保管库获取密钥。 第四个 cmdlet 更新 RSVault 中的客户托管加密密钥,以便通过 SystemAssigned 标识进行访问。 使用 -InfrastructureEncryption 参数首次更新时启用基础结构加密。
示例 3:更新保管库的 CMK 加密以使用 userAssigned MSIdentity
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$keyVault = Get-AzKeyVault -VaultName "keyVaultName" -ResourceGroupName "RGName"
$key = Get-AzKeyVaultKey -VaultName "keyVaultName" -Name "keyName"
Set-AzRecoveryServicesVaultProperty -EncryptionKeyId $key.ID -VaultId $vault.ID -UseSystemAssignedIdentity $false -UserAssignedIdentity $vault.Identity.UserAssignedIdentities.Keys[0]
第一个 cmdlet 获取用于更新加密属性的 RSVault。 第二个 cmdlet 获取 Azure 密钥保管库。 第三个 cmdlet 从密钥保管库获取密钥。 第四个 cmdlet 更新 RSVault 中的客户托管加密密钥,以便通过 UserAssigned 标识进行访问。
示例 4:更新保管库的 HybridBackupSecurityFeature
$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$prop = Set-AzRecoveryServicesVaultProperty -VaultId $vault.Id -DisableHybridBackupSecurityFeature $false
第一个命令获取 Vault 对象,然后将其存储在$vault变量中。 第二个命令禁用保管库的 HybridBackupSecurityFeature,将$true设置为再次启用它。
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableHybridBackupSecurityFeature
可选标志($true/$false),用于针对意外删除的混合备份禁用/启用安全设置,并为关键操作添加额外的身份验证层。 提供$false以启用安全性。
类型: | Nullable<T>[Boolean] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EncryptionKeyId
要用于 CMK 的加密密钥的 KeyId。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-InfrastructureEncryption
在此保管库上启用基础结构加密。 配置加密时必须启用基础结构加密。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-KeyVaultSubscriptionId
密钥库的订阅 ID。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SoftDeleteFeatureState
恢复服务保管库的 SoftDeleteFeatureState。 允许的值为 Disable、Enable、AlwaysON。
类型: | String |
接受的值: | Enable, Disable, AlwaysON |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Token
用于对资源防护订阅的关键操作进行身份验证的辅助访问令牌
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-UserAssignedIdentity
用于 CMK 加密的 UserAssigned 标识的 ARM ID。 如果 UseSystemAssignedIdentity $false,请提供此参数。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-UseSystemAssignedIdentity
指示 SystemAssigned Identity 是否将用于 CMK 加密的布尔标志。 接受的 Vaules:$true、$false
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-VaultId
恢复服务保管库的 ARM ID。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-WhatIf
显示运行该 cmdlet 时会发生什么情况。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
输入
Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.VaultSoftDeleteFeatureState
输出
BackupResourceVaultConfigResource