Update-AzRecoveryServicesVault

Referencia

Módulo:: Az.RecoveryServices

Actualiza MSIdentity al almacén de Recovery Services.

Sintaxis

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

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.

Tipo:	SwitchParameter
Alias:	cf
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-CrossSubscriptionRestoreState

Estado de restauración entre suscripciones del almacén. Los valores permitidos son "Enabled", "Disabled", "PermanentlyDisabled".

Tipo:	Nullable<T>[CrossSubscriptionRestoreState]
Valores aceptados:	Enabled, Disabled, PermanentlyDisabled
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DefaultProfile

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

Tipo:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-DisableAzureMonitorAlertsForJobFailure

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

Tipo:	Nullable<T>[Boolean]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Nullable<T>[Boolean]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	String[]
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-IdentityType

Tipo msi asignado al almacén de Recovery Services.

Tipo:	MSIdentity
Valores aceptados:	SystemAssigned, None, UserAssigned
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Nullable<T>[ImmutabilityState]
Valores aceptados:	Disabled, Unlocked, Locked
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Name

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

Tipo:	String
Posición:	2
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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.

Tipo:	Nullable<T>[PublicNetworkAccess]
Valores aceptados:	Enabled, Disabled
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveSystemAssigned

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-RemoveUserAssigned

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

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-ResourceGroupName

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

Tipo:	String
Posición:	1
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Token

Parámetro para autorizar las operaciones protegidas por protección de recursos entre inquilinos. Use el comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"). Token para capturar el token de autorización para un inquilino diferente

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-WhatIf

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

Tipo:	SwitchParameter
Alias:	wi
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

Entradas

String

Salidas

Vault

Compartir a través de