Compartilhar via


Start-AzureSiteRecoveryPlannedFailoverJob

Inicia uma operação de failover planejada de Recuperação de Site.

Observação

Os cmdlets mencionados 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, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado 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 é 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 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:

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

-Optimize

Especifica para 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:

  • Tempo 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 executar uma operação de sincronização adicional que desliga a máquina virtual.

Quando ForSynchronization é especificado, isso indica que os dados são sincronizados durante o failover somente para que a sincronização de dados seja 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 a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do 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 da Recuperação de Site.

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