< Back

Start-AzureSiteRecoveryUnplannedFailoverJob

Wed Jan 30, 2019 5:55 pm

NAME Start-AzureSiteRecoveryUnplannedFailoverJob



SYNOPSIS

The Start-AzureSiteRecoveryUnplannedFailoverJob cmdlet starts the unplanned failover for a protectioned entity or for a recovery plan in Microsoft Azure

Site Recovery.

Check whether the job succeeds by using the Get-AzureSiteRecoveryJob cmdlet.





SYNTAX

Start-AzureSiteRecoveryUnplannedFailoverJob -Direction <string> -ProtectionContainerId <string> -ProtectionEntityId <string> [-PerformSourceSideActions]

[-WaitForCompletion] [<CommonParameters>]



Start-AzureSiteRecoveryUnplannedFailoverJob -Direction <string> -ProtectionEntity <ASRProtectionEntity> [-PerformSourceSideActions] [-WaitForCompletion]

[<CommonParameters>]



Start-AzureSiteRecoveryUnplannedFailoverJob -Direction <string> -RpId <string> [-PerformSourceSideActions] [-WaitForCompletion] [<CommonParameters>]



Start-AzureSiteRecoveryUnplannedFailoverJob -Direction <string> -RecoveryPlan <ASRRecoveryPlan> [-PerformSourceSideActions] [-WaitForCompletion]

[<CommonParameters>]





DESCRIPTION

Start the Unplanned Failover operation for a Protection Entity or Recovery Plan under Azure Site Recovery. This will start the failover job and success

of failover can be tracked state of the Job using Get-AzureSiteRecoveryJob





PARAMETERS

-Direction <string>

Direction of the failover, either PrimaryToRecovery or RecoveryToPrimary



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-WaitForCompletion [<SwitchParameter>]

Waits till the operation completes



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-RecoveryPlan <ASRRecoveryPlan>

Recovery Plan object



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-RpId <string>

Id of the Recovery Plan



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ProtectionEntity <ASRProtectionEntity>

Protection Entity object



Required? true

Position? named

Default value

Accept pipeline input? true (ByValue)

Accept wildcard characters? false



-ProtectionEntityId <string>

Id of the Protection Entity



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-ProtectionContainerId <string>

Id of the Protection Container



Required? true

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



-PerformSourceSideActions [<SwitchParameter>]

Its used for indicating whether can do source site operations.



Required? false

Position? named

Default value

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS









OUTPUTS









NOTES







Keywords: azure, azuresm, servicemanagement, management, service, site, recovery







-------------------------- EXAMPLE 1 --------------------------



C:\\PS>$PC = Get-AzureSiteRecoveryProtectionContainer; $PE = Get-AzureSiteRecoveryProtectionEntity -ProtectionContainer $PC;

Start-AzureSiteRecoveryUnplannedFailoverJob -ProtectionEntity $PE -Direction PrimaryToRecovery



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 : {}



Description



-----------













RELATED LINKS