Get-HpcIScsiStorageArray
Get-HpcIScsiStorageArray
Gets information about or HpcIScsiStorageArray objects for the Internet SCSI (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.
Syntax
Parameter Set: Default
Get-HpcIScsiStorageArray [[-Name] <String[]> ] [-IpAddresses <String[]> ] [-Scheduler <String> ] [ <CommonParameters>]
Detailed Description
Gets information about or 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
-IpAddresses<String[]>
Specifies the 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 |
no default |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies the names of one or more iSCSI storage arrays for which you want to get information.
Aliases |
none |
Required? |
false |
Position? |
1 |
Default Value |
no default |
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 |
%CCP_SCHEDULER% |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. 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.
- One or more HpcIScsiStorageArray objects
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
Displays information about the iSCSI storage arrays for the HPC cluster that have a name of Windows Storage Server.
PS C:\>Get-HpcIScsiStorageArray –Name "Windows Storage Server"
EXAMPLE 2
Displays information about the iSCSI storage arrays for the HPC cluster 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
Gets an HpcIScsiStorageArray object for the iSCSI storage array for the HPC cluster 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"