Replicate-HpcImage

Replicate-HpcImage

Copies a base-node operating system image from a Windows image (.wim) file to an Internet SCSI (iSCSI) storage array.

Syntax

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




Detailed Description

The Replicate-HpcImage cmdlet copies the base-node operating system image from the specified Windows image (.wim) file to the specified iSCSI storage array.

Parameters

-ClusterConnectionString<String[]>

Specifies an array of cluster connection strings for the cluster to which you want to add the device drivers. The value format is host1,host2,host3. If you do not specify the ClusterConnectionString parameter, this cmdlet uses the connection string on the head node that the CCP_CONNECTIONSTRING environment variable specifies. To set this environment variable, run the following cmdlet: Set-Content Env: CCP_CONNECTIONSTRING <head_node_name>.

This parameter was introduced in HPC Pack 2016.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-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

none

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, and then specify that variable with this parameter.


Aliases

none

Required?

true

Position?

named

Default Value

none

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

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. 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: Replicate an operating system image to a storage array

The first command gets an HpcIScsiStorageArray object for the storage array with an IP address of 10.0.0.11, and then stores that object in the $SA variable.

The second command copies the image specified in the iSCSI Base Image.wim file to the storage array in $SA.


PS C:\> $SA = Get-HpcIScsiStorageArray –IpAddresses 10.0.0.11 
PS C:\> Replicate-HpcImage –StorageArray $SA –WimFileName "iSCSI Base Image.wim"

Example 2: Replicate an operating system to multiple storage arrays

The first command gets all of the storage arrays for the cluster, and then stores them in the $SA_All variable.

The second command copies the image specified in the iSCSI Base Image.wim file to the storage arrays in $SA_All.


PS C:\> $SA_All = Get-HpcIScsiStorageArray 
PS C:\> Replicate-HpcImage –StorageArray $SA_All –WimFileName "iSCSI Base Image.wim"

Related topics

Community Additions

ADD
Show: