Update-AzRecoveryServicesVault
Atualiza a MSIdentity para o cofre dos serviços de recuperação.
Sintaxe
AzureRSVaultRemoveMSIdentity (Default)
Update-AzRecoveryServicesVault
[-ResourceGroupName] <String>
[-Name] <String>
[-IdentityId <String[]>]
[-RemoveUserAssigned]
[-RemoveSystemAssigned]
[-DisableClassicAlerts <Boolean>]
[-DisableAzureMonitorAlertsForJobFailure <Boolean>]
[-DisableEmailNotificationsForSiteRecovery <Boolean>]
[-DisableAzureMonitorAlertsForAllReplicationIssue <Boolean>]
[-DisableAzureMonitorAlertsForAllFailoverIssue <Boolean>]
[-PublicNetworkAccess <PublicNetworkAccess>]
[-ImmutabilityState <ImmutabilityState>]
[-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
[-DefaultProfile <IAzureContextContainer>]
[-Token <String>]
[-SecureToken <SecureString>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AzureRSVaultAddMSIdentity
Update-AzRecoveryServicesVault
[-ResourceGroupName] <String>
[-Name] <String>
-IdentityType <MSIdentity>
[-IdentityId <String[]>]
[-DisableClassicAlerts <Boolean>]
[-DisableAzureMonitorAlertsForJobFailure <Boolean>]
[-DisableEmailNotificationsForSiteRecovery <Boolean>]
[-DisableAzureMonitorAlertsForAllReplicationIssue <Boolean>]
[-DisableAzureMonitorAlertsForAllFailoverIssue <Boolean>]
[-PublicNetworkAccess <PublicNetworkAccess>]
[-ImmutabilityState <ImmutabilityState>]
[-CrossSubscriptionRestoreState <CrossSubscriptionRestoreState>]
[-DefaultProfile <IAzureContextContainer>]
[-Token <String>]
[-SecureToken <SecureString>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Esse cmdlet é usado para adicionar ou remover a MSI do cofre dos serviços de recuperação. Use -IdentityType parâmetro para adicionar uma identidade SystemAssigned/UserAssigned ao RSVault. Use o comutador RemoveSystemAssigned/RemoveUserAssigned para remover o MSI do cofre.
Exemplos
Exemplo 1: Adicionar a identidade SystemAssigned ao cofre dos 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 a identidade UserAssigned ao cofre dos 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 dos serviços de recuperação.
O segundo e terceiro cmdlet busca as MSIs criadas pelo usuário.
O quarto cmdlet adiciona as MSIs do usuário ao cofre.
O quinto cmdlet mostra as Identidades adicionadas ao cofre.
Exemplo 3: remover identidades SystemAssigned e UserAssigned do cofre
$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 dos serviços de recuperação.
O segundo cmdlet remove a identidade SystemAssigned do cofre.
O terceiro cmdlet busca todas as MSIs de 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 para serem removidas como separadas por vírgula, como no exemplo anterior.
O quinto cmdlet mostra as identidades no cofre, pois removemos todas as identidades, Type é exibido como Nenhum.
Exemplo 4: Atualizar PublicNetworkAccess, ImmutabilityState 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 dos 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: Habilitar/desabilitar 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 dos serviços de recuperação.
O segundo cmdlet atualiza CrossSubscriptionRestoreState do cofre dos serviços de recuperação.
O terceiro comando obtém o estado de restauração entre assinaturas do cofre.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: cf
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-CrossSubscriptionRestoreState
Estado de restauração entre assinaturas do cofre. Os valores permitidos são "Habilitado", "Desabilitado", "Permanentemente Desabilitado".
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.
Propriedades do parâmetro
Tipo: IAzureContextContainer
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: AzContext, AzureRmContext, AzureCredential
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DisableAzureMonitorAlertsForAllFailoverIssue
Habilita ou desabilita o monitoramento de alertas para o problema de failover no cofre do RS.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DisableAzureMonitorAlertsForAllReplicationIssue
Habilita ou desabilita o monitoramento de alertas para problema de replicação no cofre do RS.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DisableAzureMonitorAlertsForJobFailure
Parâmetro booliano para especificar se os alertas internos do Azure Monitor devem ser recebidos para cada falha de trabalho.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DisableClassicAlerts
Parâmetro booliano para especificar se os alertas de backup da solução clássica devem ser desabilitados ou habilitados.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-DisableEmailNotificationsForSiteRecovery
Habilita ou desabilita notificações de email clássicas para o Site Recovery no cofre do RS.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-IdentityId
IDs do ARM da Identidade UserAssigned a serem adicionadas/removidas. Esta é uma lista separada por vírgulas de IDs de Identidade.
Propriedades do parâmetro
Tipo: String [ ]
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-IdentityType
O tipo MSI atribuído ao Cofre dos Serviços de Recuperação.
Propriedades do parâmetro
Tipo: MSIdentity
Valor padrão: None Valores aceitos: SystemAssigned, None, UserAssigned Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AzureRSVaultAddMSIdentity
Cargo: Named Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ImmutabilityState
Estado de Imutabilidade do cofre. Os valores permitidos são "Desabilitado", "Desbloqueado", "Bloqueado".
Desbloqueado significa Habilitado e pode ser alterado, Bloqueado significa Habilitado e não pode ser alterado.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Name
Especifica o nome do cofre dos serviços de recuperação a ser atualizado.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: 2 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-PublicNetworkAccess
Parâmetro para habilitar/desabilitar o acesso à rede pública do cofre. Essa configuração é útil com pontos de extremidade privados.
Propriedades do parâmetro
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-RemoveSystemAssigned
Forneça essa opção para remover a Identidade SystemAssigned do cofre.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AzureRSVaultRemoveMSIdentity
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-RemoveUserAssigned
Forneça essa opção para remover a Identidade UserAssigned do cofre. Além disso, forneça o parâmetro IdentityId junto com essa opção.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
AzureRSVaultRemoveMSIdentity
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-ResourceGroupName
Especifica o nome do grupo de recursos do Azure em que o cofre dos serviços de recuperação está presente.
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: 1 Obrigatório: True Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-SecureToken
Parâmetro para autorizar operações protegidas pelo proteção de recursos entre locatários. Usar comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx"). Token para buscar token de autorização para locatário diferente
Propriedades do parâmetro
Tipo: SecureString
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-Token
Parâmetro para autorizar operações protegidas pelo proteção de recursos entre locatários. Usar comando (Get-AzAccessToken -TenantId "xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxx"). Token para buscar token de autorização para locatário diferente
Propriedades do parâmetro
Tipo: String
Valor padrão: None Dá suporte a curingas: False DontShow: False
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado.
O cmdlet não é executado.
Propriedades do parâmetro
Tipo: SwitchParameter
Valor padrão: None Dá suporte a curingas: False DontShow: False Aliases: wi
Conjuntos de parâmetros
(All)
Cargo: Named Obrigatório: False Valor do pipeline: False Valor do pipeline pelo nome da propriedade: False Valor dos argumentos restantes: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters .
Saídas
