Set-AzRecoveryServicesVaultProperty

  • Referentie
Module:
Az.RecoveryServices

Hiermee worden eigenschappen van een kluis bijgewerkt.

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

De cmdlet Set-AzRecoveryServicesVaultProperty werkt eigenschappen van een Recovery Services-kluis bij. Deze cmdlet kan worden gebruikt om voorlopig verwijderen/AlwaysON in te schakelen of CMK-versleuteling in te stellen voor een kluis met twee verschillende parametersets. De eigenschap SoftDeleteFeatureState van een kluis kan alleen worden uitgeschakeld als de kluis geen geregistreerde containers bevat. InfrastructurEncryption kan alleen worden ingesteld wanneer een gebruiker de CMK-kluis voor het eerst bijwerken.

Voorbeelden

Voorbeeld 1: SoftDeleteFeatureState van een kluis bijwerken

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

Met de eerste opdracht wordt een Kluisobject opgehaald en vervolgens opgeslagen in de $vault variabele. Met de tweede opdracht wordt de eigenschap SoftDeleteFeatureState van de kluis bijgewerkt naar de status Ingeschakeld. Toegestane waarden voor SoftDeleteFeatureState zijn Disable, Enable, AlwaysON.

Voorbeeld 2: CMK-versleuteling van een kluis bijwerken om SystemAssigned MSIdentity te gebruiken

$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

De eerste cmdlet haalt de RSVault op om versleutelingseigenschappen bij te werken. Met de tweede cmdlet wordt de Azure Key Vault opgehaald. Met de derde cmdlet wordt de sleutel opgehaald uit de sleutelkluis. Met de vierde cmdlet wordt de door de klant beheerde versleutelingssleutel in rsVault bijgewerkt voor toegang via systemAssigned-identiteit. Gebruik de param -InfrastructureEncryption om infrastructuurversleuteling in te schakelen voor de eerste keer bijwerken.

Voorbeeld 3: CMK-versleuteling van een kluis bijwerken om userAssigned MSIdentity te gebruiken

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

De eerste cmdlet haalt de RSVault op om versleutelingseigenschappen bij te werken. Met de tweede cmdlet wordt de Azure Key Vault opgehaald. Met de derde cmdlet wordt de sleutel opgehaald uit de sleutelkluis. Met de vierde cmdlet wordt de door de klant beheerde versleutelingssleutel in rsVault bijgewerkt voor toegang via userAssigned-identiteit.

Voorbeeld 4: HybridBackupSecurityFeature van een kluis bijwerken

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

Met de eerste opdracht wordt een Kluisobject opgehaald en vervolgens opgeslagen in de $vault variabele. Met de tweede opdracht wordt de HybridBackupSecurityFeature van de kluis uitgeschakeld. Stel $true in om deze opnieuw in te schakelen.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

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

-DisableHybridBackupSecurityFeature

Optionele vlag ($true/$false) om de beveiligingsinstelling voor hybride back-ups uit te schakelen/in te schakelen tegen onbedoelde verwijderingen en extra verificatielaag toe te voegen voor kritieke bewerkingen. Geef $false op om de beveiliging in te schakelen.

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

-EncryptionKeyId

KeyId van de versleutelingssleutel die moet worden gebruikt voor CMK.

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

-InfrastructureEncryption

Hiermee schakelt u infrastructuurversleuteling in voor deze kluis. Infrastructuurversleuteling moet zijn ingeschakeld bij het configureren van versleuteling.

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

-KeyVaultSubscriptionId

Abonnements-id van de sleutelkluis.

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

-SoftDeleteFeatureState

SoftDeleteFeatureState van de Recovery Services-kluis. Toegestane waarden zijn Uitschakelen, Inschakelen, AlwaysON.

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

-Token

Hulptoegangstoken voor verificatie van kritieke bewerking voor resource guard-abonnement

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

-UserAssignedIdentity

ARM-id van UserAssigned Identity die moet worden gebruikt voor CMK-versleuteling. Geef deze parameter op als UseSystemAssignedIdentity is $false.

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

-UseSystemAssignedIdentity

Booleaanse vlag om aan te geven of SystemAssigned Identity wordt gebruikt voor CMK-versleuteling. Geaccepteerde vaules: $true, $false

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

-VaultId

ARM-id van de Recovery Services-kluis.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert.

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

Invoerwaarden

String

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

Uitvoerwaarden

BackupResourceVaultConfigResource