Import-VMInitialReplication

Import-VMInitialReplication

Imports initial replication files for a Replica virtual machine to complete the initial replication when using external media as the source.

Syntax

Parameter Set: VMName
Import-VMInitialReplication [-VMName] <String[]> [-Path] <String> [-AsJob] [-ComputerName <String[]> ] [-PassThru] [ <CommonParameters>]

Parameter Set: VMObject
Import-VMInitialReplication [-VM] <VirtualMachine[]> [-Path] <String> [-AsJob] [-PassThru] [ <CommonParameters>]

Parameter Set: VMReplication
Import-VMInitialReplication [-VMReplication] <VMReplication[]> [-Path] <String> [-AsJob] [-PassThru] [ <CommonParameters>]

Detailed Description

The Import-VMInitialReplication cmdlet imports initial replication files on a Replica server. It completes the initial replication of a virtual machine when external is used as the source of the files for initial replication.

Parameters

-AsJob

Runs the cmdlet as a background job.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ComputerName<String[]>

Specifies one or more Hyper-V hosts on which initial replication files are to be imported. NetBIOS names, IP addresses, and fully-qualified domain names are allowable. The default is the local computer — use “localhost” or a dot (“.”) to specify the local computer explicitly.

Aliases

none

Required?

false

Position?

named

Default Value

.

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PassThru

Specifies that an object is to be passed through to the pipeline representing the virtual machine for which initial replication files are to be imported.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Path<String>

Specifies the path of the initial replication files to import.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VM<VirtualMachine[]>

Specifies the virtual machine for which the initial replication files are to be imported.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-VMName<String[]>

Specifies the name of the virtual machine for which the initial replication files are to be imported.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

true

-VMReplication<VMReplication[]>

Specifies the virtual machine replication object for which initial replication files are to be imported.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • None by default; Microsoft.Virtualization.Powershell.VirtualMachine if –PassThru is specified.

Examples

Example 1

This example imports the initial replication files for a virtual machine named VM01 from location d:\VMImportLocation\VM01.

PS C:\> Import-VMInitialReplication VM01 d:\VMImportLocation\VM01

Example 2

This example imports the initial replication files for a set of virtual machines using files located in D:\OOBLoc\

PS C:\> Get-VMReplication | % {$path = “D:\OOBLoc\” + $_.VMName + “_” + $_.VMID; if (Test-Path $path –PathType Container) {Import-VMInitialReplication $_ $path}}