Update-AzRecoveryServicesVault

Referencia

Módulo:: Az.RecoveryServices

Novedades MSIdentity en el almacén de 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>]
      [-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>]

Description

Este cmdlet se usa para agregar o quitar el MSI del almacén de Recovery Services. Use el parámetro -IdentityType para agregar una identidad SystemAssigned/UserAssigned a RSVault. Use el modificador RemoveSystemAssigned/RemoveUserAssigned para quitar el MSI del almacén.

Ejemplos

Ejemplo 1: Adición de la identidad SystemAssigned al almacén de Recovery Services

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

Este cmdlet se usa para agregar una identidad SystemAssigned a un almacén de Recovery Services.

Ejemplo 2: Adición de la identidad UserAssigned al almacén de 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]}

El primer cmdlet captura el almacén de Recovery Services. El segundo y el tercer cmdlet capturan los MSIs creados por el usuario. El cuarto cmdlet agrega los MSIs de usuario al almacén. El quinto cmdlet muestra las identidades agregadas al almacén.

Ejemplo 3: Eliminación de identidades SystemAssigned y UserAssigned del almacén

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

El primer cmdlet captura el almacén de Recovery Services. El segundo cmdlet quita la identidad SystemAssigned del almacén. El tercer cmdlet captura todos los MSIs de usuario como una lista del almacén. El cuarto cmdlet quita todos los MSIs de usuario del almacén. En caso de que desee, puede proporcionar identidades de usuario seleccionadas que se van a quitar como separadas por comas, como en el ejemplo anterior. El quinto cmdlet muestra las identidades en el almacén, ya que hemos quitado todas las identidades, Type se muestra como None.

Ejemplo 4: Actualización de PublicNetworkAccess, ImmutabilityState del almacén de 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

El primer cmdlet captura el almacén de Recovery Services. El segundo cmdlet actualiza las propiedades PublicNetworkAccess, ImmutabilityState del almacén de Recovery Services. El tercer y cuarto comando se usan para capturar el acceso a la red pública y el estado de inmutabilidad del almacén.

Ejemplo 5: Habilitar o deshabilitar CrossSubscriptionRestore para el almacén de 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

El primer cmdlet captura el almacén de Recovery Services. El segundo cmdlet actualiza CrossSubscriptionRestoreState del almacén de Recovery Services. El tercer comando obtiene el estado de restauración entre suscripciones del almacén.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

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

-CrossSubscriptionRestoreState

Estado de restauración entre suscripciones del almacén. Los valores permitidos son "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

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

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

-DisableAzureMonitorAlertsForJobFailure

Parámetro booleano para especificar si se deben recibir alertas integradas de Azure Monitor para cada error de trabajo.

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

-DisableClassicAlerts

Parámetro booleano para especificar si las alertas de copia de seguridad de la solución clásica deben estar deshabilitadas o habilitadas.

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

-IdentityId

Id. de ARM de la identidad UserAssigned que se va a agregar o quitar. Se trata de una lista separada por comas de identificadores de identidad.

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

-IdentityType

Tipo msi asignado al almacén de 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

Estado de inmutabilidad del almacén. Los valores permitidos son "Disabled", "Unlocked", "Locked". Desbloqueado significa Habilitado y se puede cambiar, Bloqueado significa Habilitado y no se puede cambiar.

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

Especifica el nombre del almacén de Recovery Services que se va a actualizar.

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

-PublicNetworkAccess

Parámetro para habilitar o deshabilitar el acceso a la red pública del almacén. Esta configuración es útil con puntos de conexión privados.

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

-RemoveSystemAssigned

Proporcione este modificador para quitar SystemAssigned Identity del almacén.

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

-RemoveUserAssigned

Proporcione este modificador para quitar UserAssigned Identity del almacén. Además, proporcione el parámetro IdenityId junto con este modificador.

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

-ResourceGroupName

Especifica el nombre del grupo de recursos de Azure donde está presente el almacén de Recovery Services.

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

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

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

Entradas

String

Salidas

Vault