Get-HpcIScsiStorageArray

Get-HpcIScsiStorageArray

Gets HpcIScsiStorageArray objects.

Syntax

Parameter Set: Default
Get-HpcIScsiStorageArray [[-Name] <String[]> ] [-ClusterConnectionString <String[]> ] [-IpAddresses <String[]> ] [-Scheduler <String[]> ] [ <CommonParameters>]




Detailed 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.

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

-IpAddresses<String[]>

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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String[]>

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


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Scheduler<String[]>

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>


Aliases

none

Required?

false

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.

  • 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.

Examples

Example 1: Get an iSCSI storage array by name

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


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

Example 2: Get iSCSI storage arrays by IP address

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.


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

Example 3: Get an iSCSI storage array and modify it

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.


PS C:\> Get-HpcIScsiStorageArray –IpAddresses 10.0.0.10 | Set-HpcIScsiStorageArray –Description "First Storage Array"

Related topics

Community Additions

ADD
Show: