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 |
輸入
Microsoft.Azure.Commands.RecoveryServices.Backup.Cmdlets.Models.VaultSoftDeleteFeatureState
輸出
BackupResourceVaultConfigResource