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

Set-AzRecoveryServicesVaultProperty

更新保管库的属性。

语法

AzureRSVaultSoftDeleteParameterSet (默认值)

Set-AzRecoveryServicesVaultProperty
    [-SoftDeleteFeatureState <String>]
    [-SoftDeleteRetentionPeriodInDays <Int32>]
    [-DisableHybridBackupSecurityFeature <Boolean>]
    [-VaultId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-Token <String>]
    [-SecureToken <SecureString>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

AzureRSVaultCMKParameterSet

Set-AzRecoveryServicesVaultProperty
    -EncryptionKeyId <String>
    [-VaultId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-Token <String>]
    [-SecureToken <SecureString>]
    [-KeyVaultSubscriptionId <String>]
    [-InfrastructureEncryption]
    [-UseSystemAssignedIdentity <Boolean>]
    [-UserAssignedIdentity <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

Set-AzRecoveryServicesVaultProperty cmdlet 更新恢复服务保管库的属性。 此 cmdlet 可用于启用/禁用/AlwaysON 软删除或为具有两个不同参数集的保管库设置 CMK 加密。 仅当保管库中没有已注册的容器时,才能禁用保管库的 SoftDeleteFeatureState 属性。 只能在用户首次更新 CMK 保管库时设置 InfrastructureEncryption。

示例

示例 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设置为再次启用它。

示例 5:将 SoftDeleteFeatureState 和 HybridBackupSecurityFeature 更新为 AlwaysON

$vault = Get-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName"
$prop = Set-AzRecoveryServicesVaultProperty -VaultId $vault.Id -SoftDeleteFeatureState AlwaysON

第一个命令获取 Vault 对象,然后将其存储在$vault变量中。 第二个命令将保管库的 SoftDeleteFeatureState 设置为“AlwaysON”,该命令还将 HybridBackupSecurityFeature 设置为 AlwaysON。 此外,SoftDeleteRetentionPeriodInDays 参数用于将软删除保留期设置为 16 天。

参数

-Confirm

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

参数属性

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

参数集

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

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

-DisableHybridBackupSecurityFeature

可选标志($true/$false),用于针对意外删除的混合备份禁用/启用安全设置,并为关键作添加额外的身份验证层。 提供$false以启用安全性。

参数属性

类型:

Nullable<T>[Boolean]

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

参数集

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

-EncryptionKeyId

要用于 CMK 的加密密钥的 KeyId。

参数属性

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

参数集

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

-InfrastructureEncryption

在此保管库上启用基础结构加密。 配置加密时必须启用基础结构加密。

参数属性

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

参数集

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

-KeyVaultSubscriptionId

Key Vault 的订阅 ID。

参数属性

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

参数集

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

-SecureToken

用于授权受跨租户资源防护保护的作的参数。 使用命令(Get-AzAccessToken -TenantId“xxxxxxxx-xxxx-xxxx-xxxx-xxx”)。用于提取不同租户的授权令牌的令牌

参数属性

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

参数集

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

-SoftDeleteFeatureState

恢复服务保管库的 SoftDeleteFeatureState。 允许的值为 Disable、Enable、AlwaysON。

参数属性

类型:String
默认值:None
接受的值:Enable, Disable, AlwaysON
支持通配符:False
不显示:False

参数集

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

-SoftDeleteRetentionPeriodInDays

指定软删除项的保留期(以天为单位)。

参数属性

类型:

Nullable<T>[Int32]

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

参数集

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

-Token

用于对资源防护订阅的关键作进行身份验证的辅助访问令牌

参数属性

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

参数集

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

-UserAssignedIdentity

用于 CMK 加密的 UserAssigned 标识的 ARM ID。 如果 UseSystemAssignedIdentity $false,请提供此参数。

参数属性

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

参数集

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

-UseSystemAssignedIdentity

指示 SystemAssigned Identity 是否将用于 CMK 加密的布尔标志。 接受的值:$true、$false

参数属性

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

参数集

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

-VaultId

恢复服务保管库的 ARM ID。

参数属性

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

参数集

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。

参数属性

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

参数集

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

CommonParameters

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

输入

String

Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.VaultSoftDeleteFeatureState

输出

BackupResourceVaultConfigResource