共用方式為


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>]

Description

Set-AzRecoveryServicesVaultProperty Cmdlet 會更新復原服務保存庫的屬性。 此 Cmdlet 可用來啟用/停用/AlwaysON 虛刪除或設定具有兩個不同參數集之保存庫的 CMK 加密。 只有在保存庫中沒有已註冊的容器時,才能停用保存庫的SoftDeleteFeatureState 屬性。 InfrastructurEncryption 只能在使用者第一次更新 CMK 保存庫時設定。

範例

範例 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

金鑰保存庫 的訂用帳戶標識碼。

類型: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 識別碼。 如果 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 識別碼。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

String

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

輸出

BackupResourceVaultConfigResource