Update-AzRecoveryServicesVault

Référence

Module:: Az.RecoveryServices

Mises à jour MSIdentity au coffre Recovery Services.

Syntax

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

Description

Cette applet de commande est utilisée pour ajouter ou supprimer le msi du coffre Recovery Services. Utilisez -IdentityType param pour ajouter une identité SystemAssigned/UserAssigned à RSVault. Utilisez le commutateur RemoveSystemAssigned/RemoveUserAssigned pour supprimer le MSI du coffre.

Exemples

Exemple 1 : Ajouter une identité SystemAssigned au coffre Recovery Services

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

Cette applet de commande permet d’ajouter une identité SystemAssigned à un coffre Recovery Services.

Exemple 2 : Ajouter une identité UserAssigned au coffre Recovery Services

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

La première applet de commande récupère le coffre Recovery Services. La deuxième et la troisième applet de commande récupère les MSIs créées par l’utilisateur. La quatrième applet de commande ajoute les MSIs utilisateur au coffre. La cinquième applet de commande affiche les identités ajoutées au coffre.

Exemple 3 : Supprimer les identités SystemAssigned et UserAssigned du coffre

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

La première applet de commande récupère le coffre Recovery Services. La deuxième applet de commande supprime l’identité SystemAssigned du coffre. La troisième applet de commande récupère toutes les MSIs utilisateur sous forme de liste à partir du coffre. La quatrième applet de commande supprime toutes les MSIs utilisateur du coffre. Si vous le souhaitez, vous pouvez fournir des identités utilisateur sélectionnées à supprimer en tant que virgule séparées, comme dans l’exemple précédent. La cinquième applet de commande affiche les identités dans le coffre, car nous avons supprimé tous les identites, type est affiché en tant que Aucun.

Exemple 4 : Mettre à jour PublicNetworkAccess, ImmutabilityState du coffre Recovery Services

$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

La première applet de commande récupère le coffre Recovery Services. La deuxième applet de commande met à jour Les propriétés PublicNetworkAccess, ImmutabilityState du coffre Recovery Services. La troisième et la quatrième commande sont utilisées pour récupérer l’accès au réseau public et l’état d’immuabilité du coffre.

Exemple 5 : Activer/désactiver CrossSubscriptionRestore pour le coffre Recovery Services

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

Disabled

La première applet de commande récupère le coffre Recovery Services. La deuxième applet de commande met à jour CrossSubscriptionRestoreState du coffre Recovery Services. La troisième commande obtient l’état de restauration entre abonnements du coffre.

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

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

-CrossSubscriptionRestoreState

État de restauration entre abonnements du coffre. Les valeurs autorisées sont « 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

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

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

-DisableAzureMonitorAlertsForJobFailure

Paramter booléen pour spécifier si les alertes Azure Monitor intégrées doivent être reçues pour chaque échec de travail.

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

-DisableClassicAlerts

Paramter booléen pour spécifier si les alertes de sauvegarde de la solution classique doivent être désactivées ou activées.

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

-IdentityId

ID ARM de l’identité UserAssigned à ajouter/supprimer. Il s’agit d’une liste séparée par des virgules d’ID d’identité.

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

-IdentityType

Type MSI affecté au coffre Recovery Services.

Type:	MSIdentity
Accepted values:	SystemAssigned, None, UserAssigned
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ImmutabilityState

État d’immuabilité du coffre. Les valeurs autorisées sont « Désactivé », « Déverrouillé », « Verrouillé ». Les moyens déverrouillés activés et peuvent être modifiés, Les moyens verrouillés sont activés et ne peuvent pas être modifiés.

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

Spécifie le nom du coffre Recovery Services à mettre à jour.

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

-PublicNetworkAccess

Paramètre permettant d’activer/désactiver l’accès au réseau public du coffre. Ce paramètre est utile avec les points de terminaison privés.

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

-RemoveSystemAssigned

Indiquez ce commutateur pour supprimer l’identité SystemAssigned du coffre.

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

-RemoveUserAssigned

Indiquez ce commutateur pour supprimer l’identité UserAssigned du coffre. Fournissez également le paramètre IdenityId avec ce commutateur.

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

-ResourceGroupName

Spécifie le nom du groupe de ressources Azure où le coffre Recovery Services est présent.

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

-Token

Paramètre permettant d’autoriser les opérations protégées par la protection des ressources interlocataires. Utilisez la commande (Get-AzAccessToken -TenantId « xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx »). Jeton permettant d’extraire le jeton d’autorisation pour un locataire différent

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

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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

Entrées

String

Sorties

Vault