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 之前,提示你进行确认。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DisableHybridBackupSecurityFeature
可选标志($true/$false),用于针对意外删除的混合备份禁用/启用安全设置,并为关键作添加额外的身份验证层。 提供$false以启用安全性。
参数属性
参数集
AzureRSVaultSoftDeleteParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-EncryptionKeyId
要用于 CMK 的加密密钥的 KeyId。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
AzureRSVaultCMKParameterSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-InfrastructureEncryption
在此保管库上启用基础结构加密。 配置加密时必须启用基础结构加密。
参数属性
参数集
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”)。用于提取不同租户的授权令牌的令牌
参数属性
参数集
(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
指定软删除项的保留期(以天为单位)。
参数属性
参数集
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 运行时会发生什么情况。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.VaultSoftDeleteFeatureState
输出