Update-AzRecoveryServicesVault

Referência

Módulo:: Az.RecoveryServices

Atualiza o MSIdentity para o cofre de serviços de recuperação.

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

Esse cmdlet é usado para adicionar ou remover o MSI do cofre de serviços de recuperação. Use -IdentityType param para adicionar uma identidade SystemAssigned/UserAssigned ao RSVault. Use a opção RemoveSystemAssigned/RemoveUserAssigned para remover o MSI do cofre.

Exemplos

Exemplo 1: Adicionar identidade SystemAssigned ao cofre de serviços de recuperação

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

Esse cmdlet é usado para adicionar uma identidade SystemAssigned a um cofre de serviços de recuperação.

Exemplo 2: Adicionar identidade UserAssigned ao cofre de serviços de recuperação

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

O primeiro cmdlet busca o cofre de serviços de recuperação. O segundo e o terceiro cmdlet buscam os MSIs criados pelo usuário. O quarto cmdlet adiciona os MSIs do usuário ao cofre. O quinto cmdlet mostra as Identidades adicionadas ao cofre.

Exemplo 3: Remover identidades SystemAssigned e UserAssigned do vault

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

O primeiro cmdlet busca o cofre de serviços de recuperação. O segundo cmdlet remove a identidade SystemAssigned do cofre. O terceiro cmdlet busca todos os MSIs do usuário como uma lista do cofre. O quarto cmdlet remove todas as MSIs do usuário do cofre. Caso deseje, você pode fornecer identidades de usuário selecionadas a serem removidas como separadas por vírgula, como no exemplo anterior. O quinto cmdlet mostra as identidades no cofre, como removemos todas as identificações, Type é exibido como None.

Exemplo 4: Atualizar PublicNetworkAccess, ImmutabilidadeEstado do cofre de serviços de recuperação

$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

O primeiro cmdlet busca o cofre de serviços de recuperação. O segundo cmdlet atualiza as propriedades PublicNetworkAccess, ImmutabilityState do cofre de serviços de recuperação. O terceiro e o quarto comando são usados para buscar o acesso à rede pública e o estado de imutabilidade do cofre.

Exemplo 5: Ativar/desativar CrossSubscriptionRestore para o cofre de serviços de recuperação

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

Disabled

O primeiro cmdlet busca o cofre de serviços de recuperação. O segundo cmdlet atualiza CrossSubscriptionRestoreState do cofre de serviços de recuperação. O terceiro comando obtém o estado de restauração de assinatura cruzada do cofre.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-CrossSubscriptionRestoreState

Estado de restauração de assinatura cruzada do cofre. Os valores permitidos são "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

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

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

-DisableAzureMonitorAlertsForJobFailure

Paramter booleano para especificar se os alertas internos do Azure Monitor devem ser recebidos para cada falha de trabalho.

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

-DisableClassicAlerts

Paramter booleano para especificar se os alertas de backup da solução clássica devem ser desabilitados ou habilitados.

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

-IdentityId

Ids ARM da UserAssigned Identity a serem adicionadas/removidas. Esta é uma lista separada por vírgulas de IDs de identidade.

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

-IdentityType

O tipo MSI atribuído ao Cofre de Serviços de Recuperação.

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 imutabilidade do cofre. Os valores permitidos são "Desativado", "Desbloqueado", "Bloqueado". Desbloqueado significa Habilitado e pode ser alterado, Bloqueado significa Habilitado e não pode ser alterado.

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 o nome do cofre de serviços de recuperação a ser atualizado.

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

-PublicNetworkAccess

Parâmetro para Ativar/Desativar o acesso à rede pública do vault. Essa configuração é útil com pontos de extremidade 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

Forneça essa opção para remover SystemAssigned Identity do cofre.

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

-RemoveUserAssigned

Forneça essa opção para remover UserAssigned Identity do cofre. Além disso, forneça o parâmetro IdenityId junto com essa opção.

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

-ResourceGroupName

Especifica o nome do grupo de recursos do Azure onde o cofre de serviços de recuperação está presente.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Entradas

String

Saídas

Vault