Get-HpcIScsiStorageArray

  • Reference
Module:
HPCPack2016

Gets HpcIScsiStorageArray objects.

Syntax

Get-HpcIScsiStorageArray
   [[-Name] <String[]>]
   [-IpAddresses <String[]>]
   [-ClusterConnectionString <String[]>]
   [-Scheduler <String[]>]
   [<CommonParameters>]

Description

The Get-HpcIScsiStorageArray cmdlet gets HpcIScsiStorageArray objects for the iSCSI storage arrays with the specified names and management IP addresses, or it gets all of the iSCSI storage arrays for the HPC cluster if no names or management IP addresses are specified.

Examples

Example 1: Get an iSCSI storage array by name

PS C:\>Get-HpcIScsiStorageArray -Name "Windows Storage Server"

This command displays information about the iSCSI storage array named Windows Storage Server.

Example 2: Get iSCSI storage arrays by IP address

PS C:\>Get-HpcIScsiStorageArray -IpAddresses 10.0.0.*

This command displays information about the iSCSI storage arrays that have a management IP address that starts with 10.0.0 and has any value between 0 and 255 for the last part of the address.

Example 3: Get an iSCSI storage array and modify it

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 the description for the storage array to First Storage Array.

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

-IpAddresses

Specifies an array of management IP addresses for one or more iSCSI storage arrays for which you want to get information.

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

-Name

Specifies an array of names of iSCSI storage arrays for which you want to get information.

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

-Scheduler

Specifies the host name or IP address of the head node for the cluster for which you want to get information about iSCSI storage arrays. 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

None

Outputs

HpcIScsiStorageArray[]

Notes

  • If you specify the Name and IpAddresses parameters, the Get-HpcIScsiStorageArray cmdlet gets information or HpcIScsiStorageArray objects for only iSCSI storage arrays that match both one of the specified names and one of the specified management IP addresses. For example, if the HPC cluster has an iSCSI storage array with a name of Array 1 and a management IP address of 10.0.0.10, the Get-HpcIScsiStorageArray -Name "Array 1","Array 2" -IpAddresses 10.0.0.10,10.0.0.11 cmdlet gets information about that iSCSI storage array, but the Get-HpcIScsiStorageArray -Name "Array 2" -IpAddresses 10.0.0.10,10.0.0.11 and Get-HpcIScsiStorageArray -Name "Array 1","Array 2" -IpAddresses 10.0.0.11 cmdlets do not.
  • 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.