Start-AzureRmSiteRecoveryTestFailoverJob

Starts a test failover for a Site Recovery protection entity.

Syntax

Start-AzureRmSiteRecoveryTestFailoverJob
     -ProtectionEntity <ASRProtectionEntity>
     -Direction <String>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzureRmSiteRecoveryTestFailoverJob
     -RecoveryPlan <ASRRecoveryPlan>
     -Direction <String>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzureRmSiteRecoveryTestFailoverJob
     -RecoveryPlan <ASRRecoveryPlan>
     -Direction <String>
     -VMNetwork <ASRNetwork>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzureRmSiteRecoveryTestFailoverJob
     -RecoveryPlan <ASRRecoveryPlan>
     -Direction <String>
     -AzureVMNetworkId <String>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzureRmSiteRecoveryTestFailoverJob
     -ProtectionEntity <ASRProtectionEntity>
     -Direction <String>
     -VMNetwork <ASRNetwork>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzureRmSiteRecoveryTestFailoverJob
     -ProtectionEntity <ASRProtectionEntity>
     -Direction <String>
     -AzureVMNetworkId <String>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzureRmSiteRecoveryTestFailoverJob
     -ReplicationProtectedItem <ASRReplicationProtectedItem>
     -Direction <String>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzureRmSiteRecoveryTestFailoverJob
     -ReplicationProtectedItem <ASRReplicationProtectedItem>
     -Direction <String>
     -VMNetwork <ASRNetwork>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]
Start-AzureRmSiteRecoveryTestFailoverJob
     -ReplicationProtectedItem <ASRReplicationProtectedItem>
     -Direction <String>
     -AzureVMNetworkId <String>
     [-DataEncryptionPrimaryCertFile <String>]
     [-DataEncryptionSecondaryCertFile <String>]
     [-DefaultProfile <IAzureContextContainer>]
     [<CommonParameters>]

Description

The Start-AzureRmSiteRecoveryTestFailoverJob cmdlet starts test failover of an Azure Site Recovery protection entity or recovery plan. You can check whether the job succeeded by using the Get-AzureRmSiteRecoveryJob cmdlet.

Required Parameters

-AzureVMNetworkId

Specifies the Azure virtual network ID.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Direction

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

  • PrimaryToRecovery
  • RecoveryToPrimary
Type:String
Parameter Sets:PrimaryToRecovery, RecoveryToPrimary
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ProtectionEntity

Specifies the Site Recovery protection entity object.

Type:Microsoft.Azure.Commands.SiteRecovery.ASRProtectionEntity
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-RecoveryPlan

Specifies a recovery plan object.

Type:Microsoft.Azure.Commands.SiteRecovery.ASRRecoveryPlan
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-ReplicationProtectedItem
Type:Microsoft.Azure.Commands.SiteRecovery.ASRReplicationProtectedItem
Position:Named
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-VMNetwork

Specifies the Site Recovery virtual machine network.

Type:Microsoft.Azure.Commands.SiteRecovery.ASRNetwork
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-DataEncryptionPrimaryCertFile

Specifies the primary certificate file.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DataEncryptionSecondaryCertFile

Specifies the secondary certificate file.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-DefaultProfile

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

Type:Microsoft.Azure.Commands.Common.Authentication.Abstractions.IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

ASRProtectionEntity

Parameter 'ProtectionEntity' accepts value of type 'ASRProtectionEntity' from the pipeline

Inputs

ASRRecoveryPlan

Parameter 'RecoveryPlan' accepts value of type 'ASRRecoveryPlan' from the pipeline

Inputs

ASRReplicationProtectedItem

Parameter 'ReplicationProtectedItem' accepts value of type 'ASRReplicationProtectedItem' from the pipeline

Outputs

Microsoft.Azure.Commands.SiteRecovery.ASRJob