Compartilhar via


Start-AzureSiteRecoveryPlannedFailoverJob

Inicia uma operação de failover planejada do Site Recovery.

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

Start-AzureSiteRecoveryPlannedFailoverJob
     -RPId <String>
     -Direction <String>
     [-WaitForCompletion]
     [-Optimize <String>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSiteRecoveryPlannedFailoverJob
     -ProtectionEntityId <String>
     -ProtectionContainerId <String>
     -Direction <String>
     [-WaitForCompletion]
     [-Optimize <String>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSiteRecoveryPlannedFailoverJob
     -RecoveryPlan <ASRRecoveryPlan>
     -Direction <String>
     [-WaitForCompletion]
     [-Optimize <String>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]
Start-AzureSiteRecoveryPlannedFailoverJob
     -ProtectionEntity <ASRProtectionEntity>
     -Direction <String>
     [-WaitForCompletion]
     [-Optimize <String>]
     [-Profile <AzureSMProfile>]
     [<CommonParameters>]

Description

O cmdlet Start-AzureSiteRecoveryPlannedFailoverJob inicia um failover planejado para uma entidade de proteção ou plano de recuperação do Azure Site Recovery. Você pode verificar se o trabalho foi bem-sucedido usando o cmdlet Get-AzureSiteRecoveryJob .

Exemplos

Exemplo 1: Iniciar um trabalho de failover planejado

PS C:\> $Container = Get-AzureSiteRecoveryProtectionContainer 
PS C:\> $Protected = Get-AzureSiteRecoveryProtectionEntity -ProtectionContainer $Container 
PS C:\> Start-AzureSiteRecoveryPlannedFailoverJob -Direction PrimaryToRecovery -ProtectionEntity $Protected -Optimize ForDowntime
ID               : c38eecdc-731c-405b-a61c-08db99aae2fe
ClientRequestId  : 32ace403-0916-4967-83a1-529176bd6e88-2014-49-06 15:49:24Z-P
State            : NotStarted
StateDescription : NotStarted
StartTime        : 
EndTime          : 
AllowedActions   : {}
Name             : 
Tasks            : {}
Errors           : {}

O primeiro comando obtém todos os contêineres protegidos no cofre atual do Azure Site Recovery usando o cmdlet Get-AzureSiteRecoveryProtectionContainer e, em seguida, armazena os resultados na variável $Container. Neste exemplo, há um único contêiner.

O segundo comando obtém as máquinas virtuais protegidas que pertencem ao contêiner armazenado no $Container usando o cmdlet Get-AzureSiteRecoveryProtectionEntity . O comando armazena os resultados na variável $Protected.

O comando final inicia o trabalho de failover na direção PrimaryToRecovery para as máquinas virtuais protegidas armazenadas no $Protected.

Parâmetros

-Direction

Especifica a direção do failover. Os valores aceitáveis para esse parâmetro são:

  • PrimaryToRecovery
  • RecoveryToPrimary
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Optimize

Especifica o que otimizar. Esse parâmetro se aplica ao failover de um site do Azure para um site local que requer uma sincronização de dados significativa. Os valores aceitáveis para esse parâmetro são:

  • ParaTempo de Inatividade
  • ForSynchronization

Quando ForDowntime é especificado, isso indica que os dados são sincronizados antes do failover para minimizar o tempo de inatividade. A sincronização é executada sem desligar a máquina virtual. Após a conclusão da sincronização, o trabalho é suspenso. Retome o trabalho para fazer uma operação de sincronização adicional que desliga a máquina virtual.

Quando ForSynchronization é especificado, isso indica que os dados são sincronizados apenas durante o failover, portanto, a sincronização de dados é minimizada. Como essa configuração está habilitada, a máquina virtual é desligada imediatamente. A sincronização é iniciada após o desligamento para concluir a operação de failover.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProtectionContainerId

Especifica a ID do contêiner protegido para o qual iniciar o trabalho.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ProtectionEntity

Especifica o objeto de entidade de proteção do Site Recovery.

Tipo:ASRProtectionEntity
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ProtectionEntityId

Especifica um objeto ASRProtectionEntity para o qual iniciar o trabalho. Para obter um objeto ASRProtectionEntity , use o cmdlet Get-AzureSiteRecoveryProtectionEntity .

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RecoveryPlan

Especifica um objeto de plano de recuperação.

Tipo:ASRRecoveryPlan
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RPId

Especifica a ID de um plano de recuperação para o qual iniciar o trabalho.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WaitForCompletion

Indica que o cmdlet aguarda a conclusão da operação antes de retornar o controle ao console do Windows PowerShell.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False