HP StoreServ Application Suite for Microsoft Hyper-V Media manual Create-vCopyparameters

Create-vCopy

The create-vCopyCmdlet creates a new Virtual Copy of a VM and includes the following supported parameters. The first five parameters are for user authentication and is optional if a successful Login-Rmhand/or login-InServCmdlets are executed previously.

Preconditions

The user must first login with Login-Rmh.

Syntax

Any optional parameters require square brackets [ ] around them.

Create-vCopy -RmhServerName <RmhServerName> -HypervName <HypervName> -VmNamesUuids <VmNamesUuids> [-VcNamePrefix] [-Expiry] [-Retention] [-SavedStateBackups] [-Verbose]

Table 28 Create-vCopyparameters

Parameter	Optional/Required	Description
-RmhServerName	Required	Host name of the RMH Server. This is
		FQDN or IP address.
-HypervName	Required	Optionally select Hyper-V host/cluster
		to use. If not specified, Hyper-V
		host/cluster must be selected using
		Select-Hyperv. This is FQDN or IP
		address. Synonyms for Hyper-V are
		supported. The localhost is not
		supported.
-VmNamesUuids	Required	Comma separated VM names (or
		UUIDs) .
		For best practice, if more than one VM
		name specified, ensure all VMs use the
		same Storage System volume.
-VcNamePrefix	Optional	The Virtual Copy name prefix. A unique
		timestamp will be generated for this
		new Virtual Copy and appended to this
		prefix. If not specified, the VC name
		will be vc-timestampwhere
		timestamp is generated for this new
		Virtual Copy.
-Expiry	Optional	Integer value followed by letter h or d
		for Hours and Days respectively Default:
		use the RMH Policy.
-Retention	Optional	Integer value followed by letter h or d
		for Hours and Days respectively Default:
		use the RMH Policy.
-SavedStateBackups	Optional	Disabled or enabled.
		Default: use the RMH policy.
-Verbose	Optional	Displays progress messages

This Cmdlet returns a list of custom objects of type RmhCreateVirtualcopyResult, each for every VM being used and includes following properties:

•VM Name or UUID

•Success/Failure status of the create-vCopyoperation for the VM

50 Using PowerShell Snap-in Command Line Interface