Set-AzRecoveryServicesVaultProperty

Uppdateringar egenskaper för ett valv.

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

Cmdleten Set-AzRecoveryServicesVaultProperty uppdaterar egenskaperna för ett Recovery Services-valv. Den här cmdleten kan användas för att aktivera/inaktivera/AlwaysON mjuk borttagning eller ange CMK-kryptering för ett valv med två olika parameteruppsättningar. Egenskapen SoftDeleteFeatureState för ett valv kan endast inaktiveras om det inte finns några registrerade containrar i valvet. InfrastructurEncryption kan bara anges första gången en användare uppdaterar CMK-valvet.

Exempel

Exempel 1: Uppdatera SoftDeleteFeatureState för ett valv

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

Det första kommandot hämtar ett Valvobjekt och lagrar det sedan i variabeln $vault. Det andra kommandot Uppdateringar egenskapen SoftDeleteFeatureState för valvet till tillståndet "Aktiverad". Tillåtna värden för SoftDeleteFeatureState är Inaktivera, Aktivera, AlwaysON.

Exempel 2: Uppdatera CMK-kryptering för ett valv för att använda 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

Första cmdleten hämtar RSVault för att uppdatera krypteringsegenskaper. Den andra cmdleten hämtar Azure Key Vault. Den tredje cmdleten hämtar nyckeln från nyckelvalvet. Den fjärde cmdleten uppdaterar den kundhanterade krypteringsnyckeln i RSVault som ska nås via SystemAssigned-identitet. Använd -InfrastructureEncryption param för att aktivera infrastrukturkryptering för första gången uppdateringen.

Exempel 3: Uppdatera CMK-kryptering för ett valv för att använda 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]

Första cmdleten hämtar RSVault för att uppdatera krypteringsegenskaper. Den andra cmdleten hämtar Azure Key Vault. Den tredje cmdleten hämtar nyckeln från nyckelvalvet. Den fjärde cmdleten uppdaterar den kundhanterade krypteringsnyckeln i RSVault så att den nås via användartilldelad identitet.

Exempel 4: Uppdatera HybridBackupSecurityFeature för ett valv

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

Det första kommandot hämtar ett Valvobjekt och lagrar det sedan i variabeln $vault. Det andra kommandot inaktiverar HybridBackupSecurityFeature för valvet och anger $true för att aktivera det igen.

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-DisableHybridBackupSecurityFeature

Valfri flagga ($true/$false) för att inaktivera/aktivera säkerhetsinställningar för hybridsäkerhetskopior mot oavsiktliga borttagningar och lägga till ytterligare autentiseringslager för kritiska åtgärder. Ange $false för att aktivera säkerheten.

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

-EncryptionKeyId

KeyId för krypteringsnyckeln som ska användas för CMK.

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

-InfrastructureEncryption

Aktiverar infrastrukturkryptering i det här valvet. Infrastrukturkryptering måste aktiveras när kryptering konfigureras.

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

-KeyVaultSubscriptionId

Prenumerations-ID för Key Vault.

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

-SoftDeleteFeatureState

SoftDeleteFeatureState för Recovery Services-valvet. Tillåtna värden är Inaktivera, Aktivera, AlwaysON.

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

-Token

Extra åtkomsttoken för autentisering av kritisk åtgärd till resource guard-prenumeration

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

-UserAssignedIdentity

ARM-ID för användartilldelad identitet som ska användas för CMK-kryptering. Ange den här parametern om UseSystemAssignedIdentity är $false.

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

-UseSystemAssignedIdentity

Boolesk flagga för att ange om SystemAssigned Identity ska användas för CMK-kryptering. Godkända vaule: $true, $false

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

-VaultId

ARM-ID för Recovery Services-valvet.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes.

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

Indata

String

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

Utdata

BackupResourceVaultConfigResource