Condividi tramite

Set-AzRecoveryServicesVaultProperty

Modulo:
Az.RecoveryServices Module

Aggiorna le proprietà di un insieme di credenziali.

Sintassi

AzureRSVaultSoftDeleteParameterSet (impostazione predefinita). 

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

AzureRSVaultCMKParameterSet 

Set-AzRecoveryServicesVaultProperty
    -EncryptionKeyId <String>
    [-VaultId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [-Token <String>]
    [-SecureToken <SecureString>]
    [-KeyVaultSubscriptionId <String>]
    [-InfrastructureEncryption]
    [-UseSystemAssignedIdentity <Boolean>]
    [-UserAssignedIdentity <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Descrizione

Il cmdlet Set-AzRecoveryServicesVaultProperty aggiorna le proprietà di un insieme di credenziali di Servizi di ripristino. Questo cmdlet può essere usato per abilitare/disabilitare/alwaysON l'eliminazione temporanea o impostare la crittografia cmk per un insieme di credenziali con due set di parametri diversi. La proprietà SoftDeleteFeatureState di un insieme di credenziali può essere disabilitata solo se nell'insieme di credenziali non sono presenti contenitori registrati. InfrastructureEncryption può essere impostato solo la prima volta che un utente aggiorna l'insieme di credenziali della chiave gestita dal cliente.

Esempio

Esempio 1: Aggiornare SoftDeleteFeatureState di un insieme di credenziali

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

Il primo comando ottiene un oggetto Vault e quindi lo archivia nella variabile $vault. Il secondo comando aggiorna la proprietà SoftDeleteFeatureState dell'insieme di credenziali allo stato "Enabled". I valori consentiti per SoftDeleteFeatureState sono Disable, Enable, AlwaysON.

Esempio 2: Aggiornare la crittografia cmk di un insieme di credenziali per usare 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

Il primo cmdlet ottiene RSVault per aggiornare le proprietà di crittografia. Il secondo cmdlet ottiene l'insieme di credenziali delle chiavi di Azure. Il terzo cmdlet ottiene la chiave dall'insieme di credenziali delle chiavi. Il quarto cmdlet aggiorna la chiave di crittografia gestita dal cliente all'interno di RSVault per l'accesso tramite l'identità SystemAssigned. Usare -InfrastructureEncryption param per abilitare la crittografia dell'infrastruttura per la prima volta.

Esempio 3: Aggiornare la crittografia cmk di un insieme di credenziali per usare msidentity assegnato dall'utente

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

Il primo cmdlet ottiene RSVault per aggiornare le proprietà di crittografia. Il secondo cmdlet ottiene l'insieme di credenziali delle chiavi di Azure. Il terzo cmdlet ottiene la chiave dall'insieme di credenziali delle chiavi. Il quarto cmdlet aggiorna la chiave di crittografia gestita dal cliente all'interno di RSVault per l'accesso tramite l'identità UserAssigned.

Esempio 4: Aggiornare HybridBackupSecurityFeature di un insieme di credenziali

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

Il primo comando ottiene un oggetto Vault e quindi lo archivia nella variabile $vault. Il secondo comando disabilita HybridBackupSecurityFeature dell'insieme di credenziali, imposta $true per abilitarlo di nuovo.

Esempio 5: Aggiornare SoftDeleteFeatureState e HybridBackupSecurityFeature a AlwaysON

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

Il primo comando ottiene un oggetto Vault e quindi lo archivia nella variabile $vault. Il secondo comando imposta SoftDeleteFeatureState dell'insieme di credenziali su "AlwaysON", che imposta anche HybridBackupSecurityFeature su AlwaysON. Inoltre, il parametro SoftDeleteRetentionPeriodInDays viene usato per impostare il periodo di conservazione dell'eliminazione temporanea su 16 giorni.

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DisableHybridBackupSecurityFeature

Flag facoltativo ($true/$false) per disabilitare/abilitare l'impostazione di sicurezza per i backup ibridi da eliminazioni accidentali e aggiungere ulteriore livello di autenticazione per le operazioni critiche. Fornire $false per abilitare la sicurezza.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultSoftDeleteParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-EncryptionKeyId

KeyId della chiave di crittografia da usare per la chiave gestita dal cliente.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultCMKParameterSet
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-InfrastructureEncryption

Abilita la crittografia dell'infrastruttura in questo insieme di credenziali. La crittografia dell'infrastruttura deve essere abilitata durante la configurazione della crittografia.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultCMKParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-KeyVaultSubscriptionId

ID sottoscrizione dell'insieme di credenziali delle chiavi.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultCMKParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SecureToken

Parametro per autorizzare le operazioni protette da Cross Tenant Resource Guard. Usare il comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxx"). Token per recuperare il token di autorizzazione per un tenant diverso

Proprietà dei parametri

Tipo:SecureString
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SoftDeleteFeatureState

SoftDeleteFeatureState dell'insieme di credenziali di Servizi di ripristino. I valori consentiti sono Disable, Enable, AlwaysON.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Valori accettati:Enable, Disable, AlwaysON
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultSoftDeleteParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SoftDeleteRetentionPeriodInDays

Specifica il periodo di conservazione per gli elementi eliminati soft in giorni.

Proprietà dei parametri

Tipo:

Nullable<T>[Int32]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultSoftDeleteParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Token

Token di accesso ausiliario per l'autenticazione dell'operazione critica per la sottoscrizione di Resource Guard

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UserAssignedIdentity

ID ARM dell'identità assegnata dall'utente da usare per la crittografia cmk. Specificare questo parametro se UseSystemAssignedIdentity è $false.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultCMKParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-UseSystemAssignedIdentity

Flag booleano per indicare se l'identità systemAssigned verrà usata per la crittografia cmk. Valori accettati: $true, $false

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultCMKParameterSet
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-VaultId

ID ARM dell'insieme di credenziali di Servizi di ripristino.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

String

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

Output

BackupResourceVaultConfigResource