Update-AzRecoveryServicesVault

Riferimento

Modulo:: Az.RecoveryServices

Aggiornamenti MSIdentity all'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>]
      [-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>]
      [-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 il parametro -IdentityType 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.

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

-CrossSubscriptionRestoreState

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

Type:	Nullable<T>[CrossSubscriptionRestoreState]
Accepted values:	Enabled, Disabled, PermanentlyDisabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-DisableAzureMonitorAlertsForJobFailure

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

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

-DisableClassicAlerts

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

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

-IdentityId

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

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

-IdentityType

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

Type:	MSIdentity
Accepted values:	SystemAssigned, None, UserAssigned
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	Nullable<T>[ImmutabilityState]
Accepted values:	Disabled, Unlocked, Locked
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

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

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

-PublicNetworkAccess

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

Type:	Nullable<T>[PublicNetworkAccess]
Accepted values:	Enabled, Disabled
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveSystemAssigned

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

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

-RemoveUserAssigned

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

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

-ResourceGroupName

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

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

Output

Vault