< Back

Start-AzureRmRecoveryServicesAsrUnplannedFailoverJob

Tue Jan 29, 2019 10:03 pm

NAME Start-AzureRmRecoveryServicesAsrUnplannedFailoverJob



SYNOPSIS

Starts a unplanned failover operation.





SYNTAX

Start-AzureRmRecoveryServicesAsrUnplannedFailoverJob [-Confirm] [-DataEncryptionPrimaryCertFile <String>] [-DataEncryptionSecondaryCertFile

<String>] [-DefaultProfile <IAzureContextContainer>] -Direction {PrimaryToRecovery | RecoveryToPrimary} [-PerformSourceSideAction] -RecoveryPlan

<ASRRecoveryPlan> [-RecoveryTag {Latest | LatestAvailable | LatestAvailableApplicationConsistent | LatestAvailableCrashConsistent | Latest |

LatestAvailable | LatestAvailableApplicationConsistent | LatestAvailableCrashConsistent}] [-WhatIf] [<CommonParameters>]



Start-AzureRmRecoveryServicesAsrUnplannedFailoverJob [-Confirm] [-DataEncryptionPrimaryCertFile <String>] [-DataEncryptionSecondaryCertFile

<String>] [-DefaultProfile <IAzureContextContainer>] -Direction {PrimaryToRecovery | RecoveryToPrimary} [-PerformSourceSideAction] [-RecoveryPoint

<ASRRecoveryPoint>] -ReplicationProtectedItem <ASRReplicationProtectedItem> [-WhatIf] [<CommonParameters>]



Start-AzureRmRecoveryServicesAsrUnplannedFailoverJob [-Confirm] [-DataEncryptionPrimaryCertFile <String>] [-DataEncryptionSecondaryCertFile

<String>] [-DefaultProfile <IAzureContextContainer>] -Direction {PrimaryToRecovery | RecoveryToPrimary} [-PerformSourceSideAction] -RecoveryTag

{Latest | LatestAvailable | LatestAvailableApplicationConsistent | LatestAvailableCrashConsistent | Latest | LatestAvailable |

LatestAvailableApplicationConsistent | LatestAvailableCrashConsistent} -ReplicationProtectedItem <ASRReplicationProtectedItem> [-WhatIf]

[<CommonParameters>]





DESCRIPTION

The Start-AzureRmRecoveryServicesAsrTestFailoverJob cmdlet starts test failover of an Azure Site Recovery replication protected item or recovery

plan. You can check whether the job succeeded by using the Get-AzureRmRecoveryServicesAsrJob cmdlet.





PARAMETERS

-Confirm [<SwitchParameter>]

Prompts you for confirmation before running the cmdlet.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-DataEncryptionPrimaryCertFile <String>

Specifies the data encryption primary certificate file path for failover of Protected Item.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DataEncryptionSecondaryCertFile <String>

Specifies the data encryption secondary certificate file path for failover of Protected Item.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-DefaultProfile <IAzureContextContainer>

The credentials, account, tenant, and subscription used for communication with Azure.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Direction <String>

Specifies the failover direction. The acceptable values for this parameter are:



- PrimaryToRecovery



- RecoveryToPrimary



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-PerformSourceSideAction [<SwitchParameter>]

Perform operation in source side before starting unplanned failover.



Required? false

Position? named

Default value False

Accept pipeline input? False

Accept wildcard characters? false



-RecoveryPlan <ASRRecoveryPlan>

Specifies an ASR recovery plan object.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-RecoveryPoint <ASRRecoveryPoint>

Specifies a custom recovery point to failover the protected machine to.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-RecoveryTag <String>

Specifies the recovery tag to failover to.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-ReplicationProtectedItem <ASRReplicationProtectedItem>

Specifies an azure site recovery replication protected item.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-WhatIf [<SwitchParameter>]

Shows what would happen if the cmdlet runs. The cmdlet is not run.



Required? false

Position? named

Default value False

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 (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

Microsoft.Azure.Commands.RecoveryServices.SiteRecovery.ASRRecoveryPlan

Microsoft.Azure.Commands.RecoveryServices.SiteRecovery.ASRReplicationProtectedItem





OUTPUTS

Microsoft.Azure.Commands.RecoveryServices.SiteRecovery.ASRJob







NOTES









Example 1



PS C:\\> $currentJob = Start-AzureRmRecoveryServicesAsrTestFailoverJob -RecoveryPlan $RP -Direction PrimaryToRecovery -VMNetwork

$TestRecoveryNetwork



Starts the test failover operation for the recovery plan with the specified parameters and returns the ASR job used to track the operation.







RELATED LINKS

Online Version:

https://docs.microsoft.com/en-us/powers ... ailoverjob

Get-AzureRmRecoveryServicesAsrJob