Get-Volume
SYNOPSIS
Gets details of the volumes on a PowerMax array.
SYNTAX
All (Default)
Get-Volume [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Identify] [-Private] [<CommonParameters>]
ById
Get-Volume [-Unisphere] <UnisphereServer> [-ArrayId] <String> [-Id] <String[]> [<CommonParameters>]
ByStorageGroupId
Get-Volume [-Unisphere] <UnisphereServer> [-ArrayId] <String> -StorageGroupId <String>
[-VolumeIdentifier <String>] [-Identify] [<CommonParameters>]
ByWwn
Get-Volume [-Unisphere] <UnisphereServer> [-ArrayId] <String> -Wwn <String[]> [<CommonParameters>]
ByEffectiveWwn
Get-Volume [-Unisphere] <UnisphereServer> [-ArrayId] <String> -EffectiveWwn <String[]> [<CommonParameters>]
ByVolumeIdentifier
Get-Volume [-Unisphere] <UnisphereServer> [-ArrayId] <String> -VolumeIdentifier <String> [-Identify]
[<CommonParameters>]
DESCRIPTION
Returns a list of volumes on the PowerMax array. Options allow for listing the volumes in a storage group, listing volumes by its volume identifier, listing of private volumes, and listing by WWN or effective WWN. Note that listing by effective WWN requires Unisphere 9.2 or later.
Getting details of all volumes in an array is a time consuming operation and can impact the performance of the Unisphere server. Use the -Identify option to list only volume IDs.
EXAMPLES
Example 1
PS C:\> Get-Volume -Unisphere $unisphere -ArrayId 000123456789
Where $unisphere is a Unisphere server instance. Returns a list of all volumes in the PowerMax array 000123456789.
Example 2
PS C:\> Get-Volume -Unisphere $unisphere -ArrayId 000123456789 -Identify
Where $unisphere is a Unisphere server instance. Returns a list of all volume IDs in the PowerMax array 000123456789.
Example 3
PS C:\> Get-Volume -Unisphere $unisphere -ArrayId 00123456789 -Id 00228,'0022D'
Where $unisphere is a Unisphere server instance. Returns volumes with IDs 00228 and 0022D. Note that PowerShell interprets numbers ending in D as a decimal before converting to a string, i.e 0022D gets converted to ‘22’. For volume IDs ending in D you must quote the IDs.
Example 4
PS C:\> Get-Volume -Unisphere $unisphere -ArrayId 00123456789 -StorageGroupId sg1
Where $unisphere is a Unisphere server instance. Lists the volumes in storage group sg1.
Example 5
PS C:\> Get-Volume -Unisphere $unisphere -ArrayId 00123456789 -Wwn '60000970000197900714533030303239','60000970000197900714533030303243'
Where $unisphere is a Unisphere server instance. Lists the volumes with WWNs ‘60000970000197900714533030303239’ and ‘60000970000197900714533030303243’. The WWNs may need to be quoted in order to avoid being interpreted as numbers by PowerShell.
PARAMETERS
-Unisphere
The Unisphere server instance.
Type: UnisphereServer
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-ArrayId
The PowerMax array ID.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Id
Volume ID.
Type: String[]
Parameter Sets: ById
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-StorageGroupId
The storage group ID.
Type: String
Parameter Sets: ByStorageGroupId
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Identify
Returns IDs instead of objects.
Type: SwitchParameter
Parameter Sets: All, ByStorageGroupId, ByVolumeIdentifier
Aliases: List
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Private
Returns only private volumes. By default only host mappable volumes are returned.
Type: SwitchParameter
Parameter Sets: All
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-VolumeIdentifier
Query volumes with the specified volume identifier.
Type: String
Parameter Sets: ByStorageGroupId
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: String
Parameter Sets: ByVolumeIdentifier
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-EffectiveWwn
Query volumes with the specified effective WWNs. Requires Unisphere 9.2 or newer.
Type: String[]
Parameter Sets: ByEffectiveWwn
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Wwn
Query volumes with the specified WWNs.
Type: String[]
Parameter Sets: ByWwn
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
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.