Condividi tramite

Update-AzRecoveryServicesVault

Modulo:
Az.RecoveryServices Module

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

Sintassi

AzureRSVaultRemoveMSIdentity (impostazione predefinita). 

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

AzureRSVaultAddMSIdentity 

Update-AzRecoveryServicesVault
    [-ResourceGroupName] <String>
    [-Name] <String>
    -IdentityType <MSIdentity>
    [-IdentityId <String[]>]
    [-DisableClassicAlerts <Boolean>]
    [-DisableAzureMonitorAlertsForJobFailure <Boolean>]
    [-DisableEmailNotificationsForSiteRecovery <Boolean>]
    [-DisableAzureMonitorAlertsForAllReplicationIssue <Boolean>]
    [-DisableAzureMonitorAlertsForAllFailoverIssue <Boolean>]
    [-PublicNetworkAccess <PublicNetworkAccess>]
    [-ImmutabilityState <ImmutabilityState>]
    [-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
    [-DefaultProfile <IAzureContextContainer>]
    [-Token <String>]
    [-SecureToken <SecureString>]
    [-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 state rimosse tutte le identità, 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.

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

-CrossSubscriptionRestoreState

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

Proprietà dei parametri

Tipo:

Nullable<T>[CrossSubscriptionRestoreState]

Valore predefinito:None
Valori accettati:Enabled, Disabled, PermanentlyDisabled
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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare 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

-DisableAzureMonitorAlertsForAllFailoverIssue

Abilita o disabilita gli avvisi di monitoraggio per problemi di failover nell'insieme di credenziali RS.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

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

-DisableAzureMonitorAlertsForAllReplicationIssue

Abilita o disabilita gli avvisi di monitoraggio per il problema di replica in RS vault.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

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

-DisableAzureMonitorAlertsForJobFailure

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

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

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

-DisableClassicAlerts

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

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

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

-DisableEmailNotificationsForSiteRecovery

Abilita o disabilita le notifiche di posta elettronica classiche per Site Recovery in RS vault.

Proprietà dei parametri

Tipo:

Nullable<T>[Boolean]

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

-IdentityId

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

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

-IdentityType

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

Proprietà dei parametri

Tipo:MSIdentity
Valore predefinito:None
Valori accettati:SystemAssigned, None, UserAssigned
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

AzureRSVaultAddMSIdentity
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti: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.

Proprietà dei parametri

Tipo:

Nullable<T>[ImmutabilityState]

Valore predefinito:None
Valori accettati:Disabled, Unlocked, Locked
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

-Name

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

Proprietà dei parametri

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

Set di parametri

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

-PublicNetworkAccess

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

Proprietà dei parametri

Tipo:

Nullable<T>[PublicNetworkAccess]

Valore predefinito:None
Valori accettati:Enabled, Disabled
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

-RemoveSystemAssigned

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

Proprietà dei parametri

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

Set di parametri

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

-RemoveUserAssigned

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

Proprietà dei parametri

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

Set di parametri

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

-ResourceGroupName

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

Proprietà dei parametri

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

Set di parametri

(All)
Posizione:1
Obbligatorio:True
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

-Token

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: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

-WhatIf

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

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

Output

Vault