Update-AzRecoveryServicesVault

Módulo:
Az.RecoveryServices Module

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>]
    [-CostManagementGranularity <CostManagementGranularity>]
    [-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>]
    [-CostManagementGranularity <CostManagementGranularity>]
    [-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. Além disso, esse cmdlet pode ser usado para definir configurações de cofre, como granularidade de gerenciamento de custos, acesso à rede pública, estado de imutabilidade e estado de restauração entre assinaturas.

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.

Exemplo 6: Atualizar CostManagementGranularity 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 -CostManagementGranularity "VaultLevel"
$updatedVault.Properties.CostManagementSettings.GranularityLevel

VaultLevel

O primeiro cmdlet busca o cofre dos serviços de recuperação. O segundo cmdlet atualiza CostManagementGranularity para "VaultLevel". Os valores permitidos são "VaultLevel", "ProtectedItemLevel" e "ProtectedItemWithParentTag". O terceiro comando obtém o nível de granularidade do gerenciamento de custos 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

-CostManagementGranularity

Especifica o nível de granularidade para as configurações de gerenciamento de custos do cofre. Esse parâmetro controla o nível no qual os dados de custo são rastreados e relatados.

Propriedades do parâmetro

Tipo:

Nullable<T>[CostManagementGranularity]

Valor padrão:None
Valores aceitos:VaultLevel, ProtectedItemLevel, ProtectedItemWithParentTag
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

-CrossSubscriptionRestoreState

Estado de restauração entre assinaturas do cofre. Os valores permitidos são "Habilitado", "Desabilitado", "Permanentemente Desabilitado".

Propriedades do parâmetro

Tipo:

Nullable<T>[CrossSubscriptionRestoreState]

Valor padrão:None
Valores aceitos:Enabled, Disabled, PermanentlyDisabled
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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com 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

Tipo:

Nullable<T>[Boolean]

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

-DisableAzureMonitorAlertsForAllReplicationIssue

Habilita ou desabilita o monitoramento de alertas para problema de replicação no cofre do RS.

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

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

-DisableAzureMonitorAlertsForJobFailure

Parâmetro booliano para especificar se os alertas Azure Monitor internos devem ser recebidos para cada falha de trabalho.

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

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

-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

Tipo:

Nullable<T>[Boolean]

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

-DisableEmailNotificationsForSiteRecovery

Habilita ou desabilita notificações de email clássicas para Site Recovery no cofre do RS.

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

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

-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

Tipo:

Nullable<T>[ImmutabilityState]

Valor padrão:None
Valores aceitos:Disabled, Unlocked, Locked
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

-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

Tipo:

Nullable<T>[PublicNetworkAccess]

Valor padrão:None
Valores aceitos:Enabled, Disabled
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

-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 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.

Entradas

String

Saídas

Vault