Update-AzRecoveryServicesVault

Riferimento

Modulo:: Az.RecoveryServices

Aggiorna MSIdentity nell'insieme di credenziali dei servizi di ripristino.

Sintassi

Update-AzRecoveryServicesVault
      [-ResourceGroupName] <String>
      [-Name] <String>
      [-IdentityId <String[]>]
      [-RemoveUserAssigned]
      [-RemoveSystemAssigned]
      [-DisableClassicAlerts <Boolean>]
      [-DisableAzureMonitorAlertsForJobFailure <Boolean>]
      [-PublicNetworkAccess <PublicNetworkAccess>]
      [-ImmutabilityState <ImmutabilityState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-DefaultProfile <IAzureContextContainer>]
      [-Token <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzRecoveryServicesVault
      [-ResourceGroupName] <String>
      [-Name] <String>
      -IdentityType <MSIdentity>
      [-IdentityId <String[]>]
      [-DisableClassicAlerts <Boolean>]
      [-DisableAzureMonitorAlertsForJobFailure <Boolean>]
      [-PublicNetworkAccess <PublicNetworkAccess>]
      [-ImmutabilityState <ImmutabilityState>]
      [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
      [-DefaultProfile <IAzureContextContainer>]
      [-Token <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Descrizione

Questo cmdlet viene usato per aggiungere o rimuovere l'identità del servizio gestito dall'insieme di credenziali dei servizi di ripristino. Usare -IdentityType param per aggiungere un'identità SystemAssigned/UserAssigned a RSVault. Usare l'opzione RemoveSystemAssigned/RemoveUserAssigned per rimuovere l'identità del servizio gestito dall'insieme di credenziali.

Esempio

Esempio 1: Aggiungere l'identità SystemAssigned all'insieme di credenziali dei servizi di ripristino

Update-AzRecoveryServicesVault -ResourceGroupName "rgName" -Name "vaultName" -IdentityType SystemAssigned

Questo cmdlet viene usato per aggiungere un'identità SystemAssigned a un insieme di credenziali dei servizi di ripristino.

Esempio 2: Aggiungere l'identità UserAssigned all'insieme di credenziali dei servizi di ripristino

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$identity1 = Get-AzUserAssignedIdentity -ResourceGroupName "resourceGroupName" -Name "UserIdentity1"
$identity2 = Get-AzUserAssignedIdentity -ResourceGroupName "resourceGroupName" -Name "UserIdentity2"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -IdentityType UserAssigned -IdentityId $identity1.Id, $identity2.Id
$updatedVault.Identity | Format-List

PrincipalId            :
TenantId               : xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
Type                   : UserAssigned
UserAssignedIdentities : {[/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/UserIdentity1,
                         Microsoft.Azure.Management.RecoveryServices.Models.UserIdentity],
                         [/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/resourceGroupName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/UserIdentity2,
                         Microsoft.Azure.Management.RecoveryServices.Models.UserIdentity]}

Il primo cmdlet recupera l'insieme di credenziali dei servizi di ripristino. Il secondo e il terzo cmdlet recuperano gli account del servizio gestito creati dall'utente. Il quarto cmdlet aggiunge l'istanza gestita dall'utente all'insieme di credenziali. Il quinto cmdlet mostra le identità aggiunte all'insieme di credenziali.

Esempio 3: Rimuovere le identità SystemAssigned e UserAssigned dall'insieme di credenziali

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -RemoveSystemAssigned
$AllUserIdentities =  $vault.Identity.UserAssignedIdentities.Keys | ForEach-Object {$_} 
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -RemoveUserAssigned -IdentityId $AllUserIdentities
$updatedVault.Identity | Format-List

PrincipalId            :
TenantId               :
Type                   : None
UserAssignedIdentities :

Il primo cmdlet recupera l'insieme di credenziali dei servizi di ripristino. Il secondo cmdlet rimuove l'identità SystemAssigned dall'insieme di credenziali. Il terzo cmdlet recupera tutti gli elementi del servizio gestito dall'utente come elenco dall'insieme di credenziali. Il quarto cmdlet rimuove tutti gli elementi dell'istanza gestita dall'insieme di credenziali. Se si vuole, è possibile specificare identità utente selezionate da rimuovere come delimitate da virgole, come nell'esempio precedente. Il quinto cmdlet mostra le identità nell'insieme di credenziali, man mano che sono stati rimossi tutti gli identiti, type viene visualizzato come Nessuno.

Esempio 4: Aggiornare PublicNetworkAccess, ImmutabilityState dell'insieme di credenziali dei servizi di ripristino

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -PublicNetworkAccess "Disabled" -ImmutabilityState "Unlocked"
$updatedVault.Properties.PublicNetworkAccess
$updatedVault.Properties.ImmutabilitySettings.ImmutabilityState

Disabled
Unlocked

Il primo cmdlet recupera l'insieme di credenziali dei servizi di ripristino. Il secondo cmdlet aggiorna le proprietà PublicNetworkAccess, ImmutabilityState dell'insieme di credenziali dei servizi di ripristino. Il terzo e il quarto comando vengono usati per recuperare l'accesso alla rete pubblica e lo stato di immutabilità dell'insieme di credenziali.

Esempio 5: Abilitare/disabilitare CrossSubscriptionRestore per l'insieme di credenziali dei servizi di ripristino

$vault = Get-AzRecoveryServicesVault -Name "vaultName" -ResourceGroupName "resourceGroupName"
$updatedVault = Update-AzRecoveryServicesVault -ResourceGroupName $vault.ResourceGroupName -Name $vault.Name -CrossSubscriptionRestoreState Disabled
$updatedVault.Properties.RestoreSettings.CrossSubscriptionRestoreSettings.CrossSubscriptionRestoreState

Disabled

Il primo cmdlet recupera l'insieme di credenziali dei servizi di ripristino. Il secondo cmdlet aggiorna CrossSubscriptionRestoreState dell'insieme di credenziali dei servizi di ripristino. Il terzo comando ottiene lo stato di ripristino tra sottoscrizioni dell'insieme di credenziali.

Parametri

-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

-CrossSubscriptionRestoreState

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

Tipo:	Nullable<T>[CrossSubscriptionRestoreState]
Valori accettati:	Enabled, Disabled, PermanentlyDisabled
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DefaultProfile

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

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

-DisableAzureMonitorAlertsForJobFailure

Parametro booleano per specificare se gli avvisi predefiniti di Monitoraggio di Azure devono essere ricevuti per ogni errore del processo.

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DisableClassicAlerts

Parametro booleano per specificare se gli avvisi di backup della soluzione classica devono essere disabilitati o abilitati.

Tipo:	Nullable<T>[Boolean]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IdentityId

ID ARM dell'identità UserAssigned da aggiungere/rimuovere. Si tratta di un elenco delimitato da virgole di ID identità.

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

-IdentityType

Tipo msi assegnato all'insieme di credenziali di Servizi di ripristino.

Tipo:	MSIdentity
Valori accettati:	SystemAssigned, None, UserAssigned
Posizione:	Named
Valore predefinito:	None
Necessario:	True
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". Sbloccato significa abilitato e può essere modificato, Bloccato significa Abilitato e non può essere modificato.

Tipo:	Nullable<T>[ImmutabilityState]
Valori accettati:	Disabled, Unlocked, Locked
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Name

Specifica il nome dell'insieme di credenziali dei servizi di ripristino da aggiornare.

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

-PublicNetworkAccess

Parametro per abilitare/disabilitare l'accesso alla rete pubblica dell'insieme di credenziali. Questa impostazione è utile con endpoint privati.

Tipo:	Nullable<T>[PublicNetworkAccess]
Valori accettati:	Enabled, Disabled
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RemoveSystemAssigned

Specificare questa opzione per rimuovere l'identità SystemAssigned dall'insieme di credenziali.

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

-RemoveUserAssigned

Specificare questa opzione per rimuovere UserAssigned Identity dall'insieme di credenziali. Specificare anche il parametro IdenityId insieme a questa opzione.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse di Azure in cui è presente l'insieme di credenziali dei servizi di ripristino.

Tipo:	String
Posizione:	1
Valore predefinito:	None
Necessario:	True
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

-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

String

Output

Vault

Condividi tramite