Set-HpcIScsiStorageArray
Sets an iSCSI storage array for an HPC cluster.
Syntax
Set-HpcIScsiStorageArray
-HpcIScsiStorageArray <HpcIScsiStorageArray>
[-Name <String>]
[-IpAddress <String>]
[-Description <String>]
[-ClusterConnectionString <String[]>]
[-Scheduler <String[]>]
[<CommonParameters>]
Description
The Set-HpcIScsiStorageArray cmdlet sets the name, description, or IP address of the specified Internet SCSI (iSCSI) storage array for an HPC cluster.
Examples
Example 1: Set the description for an iSCSI storage array
PS C:\>Get-HpcIScsiStorageArray -IpAddresses 10.0.0.10 | Set-HpcIScsiStorageArray -Description "First Storage Array"
This command gets an HpcIScsiStorageArray object for the iSCSI storage array that has a management IP address of 10.0.0.10, and then redirects this object as input to the Set-HpcIScsiStorageArray cmdlet to set its description to First Storage Array.
Example 2: Modify an iSCSI storage array stored as a variable
PS C:\>$SA = Get-HpcIScsiStorageArray -IpAddresses 10.0.0.11
PS C:\> Set-HpcIScsiStorageArray -HpcIScsiStorageArray $SA -Name "Storage Array 2" -Description "Second Storage Array"
Gets an HpcIScsiStorageArray object for the iSCSI storage array that has a management IP address of 10.0.0.11, and then saves the object in a variable.
The second command sets the name and description for the iSCSI storage array in $SA.
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Specifies a new description for the iSCSI storage array.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HpcIScsiStorageArray
Specifies the iSCSI storage array in the HPC cluster that you want to modify. Use the Get-HpcIScsiStorageArray cmdlet to get an HpcIScsiStorageArray for an iSCSI storage array in an HPC cluster.
Type: | HpcIScsiStorageArray |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-IpAddress
Specifies a new IP address for the iSCSI storage array.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Specifies a new name for the iSCSI storage array. The maximum length of the name is 400 characters.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Scheduler
Specifies the host name or the IP address of the head node for the HPC cluster that contains the storage array for which you want to set the name or description. 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Inputs
HpcIScsiStorageArray
Outputs
None
Notes
- Although the HpcIScsiStorageArray parameter accepts pipeline input, this cmdlet can only successfully set the name or IP address for the first HpcIScsiStorageArray object that is received through the pipeline, because multiple storage arrays cannot have the same name or IP address. So, if you redirect the output of a Get-HpcIScsiStorageArray cmdlet that gets multiple HpcIScsiStorageArray objects to the Set-HpcIScsiStorageArray cmdlet, you should not specify the Name or IpAddress parameters for the Set-HpcIScsiStorageArray cmdlet.
- You must be a cluster administrator to run this cmdlet successfully.
- This parameter was introduced in HPC Pack 2008 R2. It is not supported in previous versions.