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