Get-Volume

SYNOPSIS

Gets details of volumes on the PowerStore cluster.

SYNTAX

All (Default)

Get-Volume [-Cluster] <Cluster> [-Identify] [-Type {Primary | Clone}] [<CommonParameters>]

ByVolumeName

Get-Volume [-Cluster] <Cluster> [-Name] <String[]> [<CommonParameters>]

ByVolumeId

Get-Volume [-Cluster] <Cluster> -Id <String[]> [<CommonParameters>]

ByVolumeGroupName

Get-Volume [-Cluster] <Cluster> -VolumeGroup <String[]> [<CommonParameters>]

ByFamilyId

Get-Volume [-Cluster] <Cluster> -FamilyId <String[]> [-Type {Primary | Clone}] [<CommonParameters>]

ByParentId

Get-Volume [-Cluster] <Cluster> -ParentId <String[]> [-Type {Primary | Clone}] [<CommonParameters>]

BySourceId

Get-Volume [-Cluster] <Cluster> -SourceId <String[]> [-Type {Primary | Clone}] [<CommonParameters>]

DESCRIPTION

Provides queries for getting information on primary volumes and clones. Provides the ability to query by name, Id, family Id, source Id, parent Id, volume group, and volume type.

EXAMPLES

Example 1

PS C:\> Get-Volume -Cluster $cluster

Where $cluster is a PowerStore cluster instance. Returns all volumes on the PowerStore cluster.

Example 2

PS C:\> Get-Volume -Cluster $cluster -Identify

Where $cluster is a PowerStore cluster instance. Returns a list of Identity objects with the Id and Name of each volume on the PowerStore cluster.

Example 3

PS C:\> Get-Volume -Cluster $cluster -Type Clone

Where $cluster is a PowerStore cluster instance. Returns all clone volumes on the PowerStore cluster.

Example 4

PS C:\> Get-Volume -Cluster $cluster -Id uuid1,uuid2

Where $cluster is a PowerStore cluster instance. Returns full details of the volumes with Ids uuid1 and uuid2.

Example 5

PS C:\> Get-Volume -Cluster $cluster -Name name1,name2

Where $cluster is a PowerStore cluster instance. Returns full details of the volumes with names name1 and name2.

Example 6

PS C:\> Get-Volume -Cluster $cluster -VolumeGroup vg1,vg2

Where $cluster is a PowerStore cluster instance. Returns volumes associated with volume group names vg1 and vg2.

PARAMETERS

-Cluster

A PowerStore cluster instance.

Type: Cluster
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Identify

Returns Identity objects which contain the Id and Name properties of each entity.

Type: SwitchParameter
Parameter Sets: All
Aliases: List

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Name

A list of volume names.

Type: String[]
Parameter Sets: ByVolumeName
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Id

A list of volume Ids.

Type: String[]
Parameter Sets: ByVolumeId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-VolumeGroup

Filter results by volume group.

Type: String[]
Parameter Sets: ByVolumeGroupName
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-FamilyId

A list of family Ids.

Type: String[]
Parameter Sets: ByFamilyId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ParentId

A list of parent Ids.

Type: String[]
Parameter Sets: ByParentId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-SourceId

A list of source Ids.

Type: String[]
Parameter Sets: BySourceId
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Type

Filter results by volume type.

Type: String
Parameter Sets: All, ByFamilyId, ByParentId, BySourceId
Aliases:
Accepted values: Primary, Clone

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

System.String[]

OUTPUTS

Dell.PowerStore.Management.Model.Volume

Dell.PowerStore.Management.Model.Identity

NOTES

Getting all volumes on the cluster will return a significant amount of data if the cluster has a lot of volumes and the volumes are mapped to many hosts. Performance may be impacted so it may be more efficient to query a subset of volumes or use the -Identify option to get an initial list of Id,Name pairs for further processing.