Set-AzRecoveryServicesVaultProperty

模組:

Az.RecoveryServices

更新 保存庫的屬性。

Syntax

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

Set-AzRecoveryServicesVaultProperty
   [-VaultId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   -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 之前先提示您確認。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableHybridBackupSecurityFeature

選擇性旗標 （$true/$false） 以針對意外刪除停用/啟用混合式備份的安全性設定，併為關鍵作業新增額外的驗證層。 提供$false以啟用安全性。

Type:	Nullable<T>[Boolean]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EncryptionKeyId

要用於 CMK 之加密金鑰的 KeyId。

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-InfrastructureEncryption

啟用此保存庫的基礎結構加密。 設定加密時，必須啟用基礎結構加密。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-KeyVaultSubscriptionId

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SoftDeleteFeatureState

復原服務保存庫的 SoftDeleteFeatureState。 允許的值為 Disable、Enable、AlwaysON。

Type:	String
Accepted values:	Enable, Disable, AlwaysON
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Token

用來向資源防護訂用帳戶驗證重要作業的輔助存取令牌

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserAssignedIdentity

要用於 CMK 加密的 UserAssigned 身分識別的 ARM 識別碼。 如果 UseSystemAssignedIdentity $false，請提供此參數。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSystemAssignedIdentity

布爾值旗標，指出 SystemAssigned Identity 是否將用於 CMK 加密。 接受的 Vaules：$true、$false

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VaultId

復原服務保存庫的 ARM 識別碼。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

String

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

輸出

BackupResourceVaultConfigResource

相關連結

• Get-AzRecoveryServicesVault
• Get-AzRecoveryServicesVaultProperty