Replicate-HpcImage

Copies the base-node operating system image from the specified Windows image (.wim) file to the specified Internet SCSI (iSCSI) storage arrays.

Syntax

	Copy Code
Parameter Set: Default Replicate-HpcImage -StorageArrays <HpcIScsiStorageArray[]> -WimFileName <String> [-Scheduler <String> ] [ <CommonParameters>]

Copy Code

Parameter Set: Default


Replicate-HpcImage -StorageArrays <HpcIScsiStorageArray[]> -WimFileName <String> [-Scheduler <String> ] [ <CommonParameters>]

Detailed Description

Copies the base-node operating system image from the specified Windows image (.wim) file to the specified iSCSI storage arrays.

Parameters

-Scheduler<String>

Specifies the host name or IP address of the head node of the HPC cluster that contains the storage arrays to which you want to copy the operating system image and the image that you want to copy. The value must be a valid computer name or IP address. If you do not specify the Scheduler parameter, this cmdlet uses the scheduler on the head node that the CCP_SCHEDULER environment variable specifies. To set this environment variable, run the following cmdlet:

Set-Content Env:CCP_SCHEDULER <head_node_name>

Aliases	none
Required?	false
Position?	named
Default Value	%CCP_SCHEDULER%
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-StorageArrays<HpcIScsiStorageArray[]>

Specifies the storage arrays to which you want to copy the operating system image. Use the Get-HpcIScsiStorageArray cmdlet to get the HpcIScsiStorageArray objects for one or more storage arrays and save them to a variable, then specify that variable with this parameter.

Aliases	none
Required?	true
Position?	named
Default Value	no default
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WimFileName<String>

Specifies the name of the Windows image (.wim) file that contains the operating system image that you want to copy to the storage arrays. Use the Get-HpcImage cmdlet to see the images and their corresponding .wim files that are available for the cluster.

Aliases	none
Required?	true
Position?	named
Default Value	no default
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters

Inputs

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

None

Outputs

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

None

Notes

The replication process can take a long time to complete, so this cmdlet can take a long time to run.
You must be a cluster administrator to run this cmdlet successfully.
This cmdlet is supported only for Windows HPC Server 2008 R2.

Examples

EXAMPLE 1

Gets an HpcIScsiStorageArray object for the storage array with an IP address of 10.0.0.11, then copies the image that the iSCSI Base Image.wim file specifies to that storage array by specifying that object in the Replicate-HpcImage cmdlet.

	Copy Code
$sa = Get-HpcIScsiStorageArray –IpAddresses 10.0.0.11 Replicate-HpcImage –StorageArray $sa –WimFileName "iSCSI Base Image.wim"

EXAMPLE 2

Gets HpcIScsiStorageArray objects for all of the storage arrays for the cluster, then copies the image that the iSCSI Base Image.wim file specifies to those storage arrays by specifying that object in the Replicate-HpcImage cmdlet.

	Copy Code
$sa_all = Get-HpcIScsiStorageArray Replicate-HpcImage –StorageArray $sa_all –WimFileName "iSCSI Base Image.wim"