Export (0) Print
Expand All

Replicate-HpcImage

Updated: January 10, 2014

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

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 was introduced in HPC Pack 2008 R2. It is not supported in previous versions.

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.


PS C:\>$sa = Get-HpcIScsiStorageArray –IpAddresses 10.0.0.11Replicate-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.


PS C:\>$sa_all = Get-HpcIScsiStorageArrayReplicate-HpcImage –StorageArray $sa_all –WimFileName "iSCSI Base Image.wim"

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft