Replicate-HpcImage

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

Syntax

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

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.

Examples

Example 1: Replicate an operating system image to a storage array

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

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.

Example 2: Replicate an operating system to multiple storage arrays

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

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.

Required Parameters

-StorageArrays

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.

Type:HpcIScsiStorageArray[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WimFileName

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.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-ClusterConnectionString

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.

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-Scheduler

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

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.