Update-AzRecoveryServicesVault

Référence

Module:: Az.RecoveryServices

Met à jour MSIdentity vers le coffre Recovery Services.

Syntaxe

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
Alias:	cf
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CrossSubscriptionRestoreState

État de restauration entre abonnements du coffre. Les valeurs autorisées sont « Enabled », « Disabled », « PermanentlyDisabled ».

Type:	Nullable<T>[CrossSubscriptionRestoreState]
Valeurs acceptées:	Enabled, Disabled, PermanentlyDisabled
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-IdentityType

Type MSI affecté au coffre Recovery Services.

Type:	MSIdentity
Valeurs acceptées:	SystemAssigned, None, UserAssigned
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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]
Valeurs acceptées:	Disabled, Unlocked, Locked
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Name

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

Type:	String
Position:	2
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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]
Valeurs acceptées:	Enabled, Disabled
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-RemoveSystemAssigned

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

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-ResourceGroupName

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

Type:	String
Position:	1
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	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
Alias:	wi
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

Sorties

Vault

Partager via