Update-AzDataProtectionBackupVault

Riferimento

Modulo:: Az.DataProtection

Aggiorna una risorsa BackupVault appartenente a un gruppo di risorse. Ad esempio, l'aggiornamento dei tag per una risorsa.

Sintassi

Update-AzDataProtectionBackupVault
      [-Token <String>]
      [-AzureMonitorAlertsForAllJobFailure <AlertsState>]
      [-CrossRegionRestoreState <CrossRegionRestoreState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-IdentityType <String>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-ImmutabilityState <ImmutabilityState>]
      [-ResourceGuardOperationRequest <String[]>]
      [-SoftDeleteRetentionDurationInDay <Double>]
      [-SoftDeleteState <SoftDeleteState>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      -ResourceGroupName <String>
      -VaultName <String>
      [-SubscriptionId <String>]
      [-CmkEncryptionState <EncryptionState>]
      [-CmkIdentityType <IdentityType>]
      [-CmkUserAssignedIdentityId <String>]
      [-CmkEncryptionKeyUri <String>]
      [-SecureToken <SecureString>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzDataProtectionBackupVault
      -InputObject <IDataProtectionIdentity>
      [-Token <String>]
      [-AzureMonitorAlertsForAllJobFailure <AlertsState>]
      [-CrossRegionRestoreState <CrossRegionRestoreState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-EncryptionSetting <IEncryptionSettings>]
      [-IdentityType <String>]
      [-IdentityUserAssignedIdentity <Hashtable>]
      [-ImmutabilityState <ImmutabilityState>]
      [-ResourceGuardOperationRequest <String[]>]
      [-SoftDeleteRetentionDurationInDay <Double>]
      [-SoftDeleteState <SoftDeleteState>]
      [-Tag <Hashtable>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Aggiorna una risorsa BackupVault appartenente a un gruppo di risorse. Ad esempio, l'aggiornamento dei tag per una risorsa.

Esempio

Esempio 1: Aggiungere tag a un insieme di credenziali di backup esistente

$tag = @{"Owner"="sarath";"Purpose"="AzureBackupTesting"}
Update-AzDataProtectionBackupVault -SubscriptionId "xxx-xxx-xxx" -ResourceGroupName sarath-rg -VaultName sarath-vault -Tag $tag

ETag IdentityPrincipalId                  IdentityTenantId                     IdentityType   Location      Name         Type
---- -------------------                  ----------------                     ------------   --------      ----         ----
     2ca1d5f7-38b3-4b61-aa45-8147d7e0edbc 72f988bf-86f1-41af-91ab-2d7cd011db47 SystemAssigned centraluseuap sarath-vault Microsoft.DataProtection/backupVaults

Il primo comando crea una nuova tabella hash tag con tag e i relativi valori. Il secondo comando aggiunge i tag specificati all'insieme di credenziali di backup.

Esempio 2: Disabilitare gli avvisi di Monitoraggio di Azure per gli errori del processo

Update-AzDataProtectionBackupVault -ResourceGroupName "rgName" -VaultName "vaultName" -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -AzureMonitorAlertsForAllJobFailure 'Disabled'

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned

Questo comando disabilita gli avvisi di monitoraggio per tutti gli errori del processo per l'insieme di credenziali di backup. I valori consentiti sono: Abilitato, Disabilitato. Si noti che per impostazione predefinita questa impostazione è abilitata.

Esempio 3: Aggiornare l'insieme di credenziali ImmutabilityState, CrossSubscriptionRestoreState, impostazioni di eliminazione temporanea

Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CrossSubscriptionRestoreState Disabled -ImmutabilityState Disabled -SoftDeleteRetentionDurationInDay 99 -SoftDeleteState Off

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned

Questo comando viene usato per modificare lo stato di immutabilità, lo stato di ripristino tra sottoscrizioni, le impostazioni di eliminazione temporanea dell'insieme di credenziali. Questi parametri sono facoltativi e possono essere usati in modo indipendente.

Esempio 4: Aggiornare l'insieme di credenziali CmkIdentityType da UserAssignedManagedIdentity a SystemAssignedManagedIdentity e CmkEncryptionKeyUri

$cmkKeyUri = "https://samplekvazbckp.vault.azure.net/keys/testkey/3cd5235ad6ac4c11b40a6f35444bcbe1"

Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CmkIdentityType SystemAssigned -CmkEncryptionKeyUri $cmkKeyUri

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned

Questo comando viene usato per modificare CmkIdentityType e CmkEncryptionKeyUri. Questi parametri sono facoltativi e possono essere usati in modo indipendente.

Esempio 5: Aggiornare l'insieme di credenziali CmkIdentityType da SystemAssignedManagedIdentity a UserAssignedManagedIdentity

$cmkIdentityId = "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/samplerg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sampleuami"

Update-AzDataProtectionBackupVault -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -CmkIdentityType UserAssigned -CmkUserAssignedIdentityId $cmkIdentityId

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults UserAssigned

Questo comando viene usato per modificare CmkIdentityType da SystemAssigned a UserAssgined. CmkIdenityId è un parametro obbligatorio.

Esempio 6: Aggiornare l'insieme di credenziali per assegnare un'identità gestita assegnata dall'utente

$UAMI = @{"/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/userAssignedIdentityName"=[Microsoft.Azure.PowerShell.Cmdlets.DataProtection.Models.Api40.UserAssignedIdentity]::new()}

$vault = Update-AzDataProtectionBackupVault -AssignUserIdentity $UAMI -SubscriptionId "00000000-0000-0000-0000-000000000000" -VaultName "vaultName" -ResourceGroupName "resourceGroupName" -IdentityType 'SystemAssigned,UserAssigned'

Name          Location      Type                                  IdentityType
----          --------      ----                                  ------------
vaultName southeastasia Microsoft.DataProtection/backupVaults SystemAssigned, UserAssigned

Creare prima di tutto una tabella hash per l'oggetto UAMI (User Assigned Managed Identity). Questo oggetto esegue il mapping dell'ID risorsa UAMI a una nuova istanza di UserAssignedIdentity. Usare quindi il cmdlet Update-AzDataProtectionBackupVault per assegnare uAMI all'insieme di credenziali di backup mantenendo l'identità gestita assegnata dal sistema. Il parametro -IdentityType specifica che vengono usate sia le identità SystemAssigned che UserAssigned.

Parametri

-AsJob

Eseguire il comando come processo

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AzureMonitorAlertsForAllJobFailure

Parametro per abilitare o disabilitare gli avvisi predefiniti di Monitoraggio di Azure per gli errori del processo. Gli avvisi di sicurezza non possono essere disabilitati.

Tipo:	AlertsState
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CmkEncryptionKeyUri

URI della chiave cmk da usare per la crittografia. Per abilitare la rotazione automatica delle chiavi, escludere il componente della versione dall'URI della chiave.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CmkEncryptionState

Abilitare lo stato di crittografia della chiave gestita dal cliente per un insieme di credenziali di backup.

Tipo:	EncryptionState
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CmkIdentityType

Tipo di identità da usare per la crittografia cmk - SystemAssigned o UserAssigned Identity.

Tipo:	IdentityType
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CmkUserAssignedIdentityId

Questo parametro è obbligatorio se il tipo di identità è UserAssigned. Aggiungere l'ID identità gestita assegnata dall'utente da usare che dispone delle autorizzazioni di accesso all'insieme di credenziali delle chiavi.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:	SwitchParameter
Alias:	cf
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CrossRegionRestoreState

Stato di ripristino tra aree dell'insieme di credenziali. I valori consentiti sono Disabled, Enabled.

Tipo:	CrossRegionRestoreState
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-CrossSubscriptionRestoreState

Stato di ripristino tra sottoscrizioni dell'insieme di credenziali. I valori consentiti sono Disabled, Enabled, PermanentlyDisabled.

Tipo:	CrossSubscriptionRestoreState
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

Il parametro DefaultProfile non è funzionale. Usare il parametro SubscriptionId quando disponibile se si esegue il cmdlet su una sottoscrizione diversa.

Tipo:	PSObject
Alias:	AzureRMContext, AzureCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-EncryptionSetting

Dettagli della chiave gestita dal cliente della risorsa. Per costruire, vedere la sezione NOTES per le proprietà ENCRYPTIONSETTING e creare una tabella hash.

Tipo:	IEncryptionSettings
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IdentityType

IdentityType che può essere SystemAssigned, UserAssigned, 'SystemAssigned,UserAssigned' o Nessuno

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IdentityUserAssignedIdentity

Ottiene o imposta le identità assegnate dall'utente.

Tipo:	Hashtable
Alias:	UserAssignedIdentity, AssignUserIdentity
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ImmutabilityState

Stato di immutabilità dell'insieme di credenziali. I valori consentiti sono Disabled, Unlocked, Locked.

Tipo:	ImmutabilityState
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-InputObject

Parametro Identity Per costruire, vedere la sezione NOTES per le proprietà INPUTOBJECT e creare una tabella hash.

Tipo:	IDataProtectionIdentity
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-NoWait

Eseguire il comando in modo asincrono

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ResourceGroupName

Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ResourceGuardOperationRequest

ResourceGuardOperationRequests su cui verrà eseguito il controllo LAC

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SecureToken

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

Tipo:	SecureString
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SoftDeleteRetentionDurationInDay

Durata della conservazione dell'eliminazione temporanea in giorni.

Tipo:	Double
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SoftDeleteState

Stato di eliminazione temporanea dell'insieme di credenziali. I valori consentiti sono Off, On, AlwaysOn.

Tipo:	SoftDeleteState
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-SubscriptionId

ID della sottoscrizione di destinazione. Il valore deve essere un UUID.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Tag

Tag di risorsa.

Tipo:	Hashtable
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Token

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-VaultName

Nome dell'insieme di credenziali di backup.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. Il cmdlet non viene eseguito.

Tipo:	SwitchParameter
Alias:	wi
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Input

IDataProtectionIdentity

Output

IBackupVaultResource

Condividi tramite