New-Volume

SYNOPSIS

Creates a volume on the PowerStore cluster.

SYNTAX

New-Volume [-Cluster] <Cluster> [-Name] <string> -Size <long> [-Description <string>] [-PerformancePolicy {Low | Medium | High}] [-ProtectionPolicy <string>] [-VolumeGroup <string>] [-Host <string>] [-HostGroup <string>] [-Lun <int>] [-ApplianceId <String>] [-Confirm] [-WhatIf] [<CommonParameters>]

DESCRIPTION

Creates a volume of the specified size on the PowerStore cluster. Optionally assign a performance policy, protection policy, volume group or host/host group mapping.

EXAMPLES

Example 1

PS C:\> New-Volume -Cluster $cluster -Name volume1 -Size 1073741824

Where $cluster is a PowerStore cluster instance. Creates new volume with name volume1, size 1073741824 (bytes) and MEDIUM as default performance policy.

Example 2

PS C:\> New-Volume -Cluster $cluster -Name volume1 -Size 1gb -PerformancePolicy High -Host host1

Where $cluster is a PowerStore cluster instance. Creates new volume with name volume1, size 1GB (1073741824 bytes) and HIGH as performance policy. Also the volume will be mapped to Host with name host1

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

-Name

Volume name.

Type: String
Parameter Sets: (All)
Aliases:

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

-Size

Volume size in bytes.

Type: Long
Parameter Sets: (All)
Aliases:

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

-Description

Volume description.

Type: String
Parameter Sets: (All)
Aliases:

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

-PerformancePolicy

Performance policy.

Type: String
Parameter Sets: (All)
Aliases:
Accepted values: Low, Medium, High

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

-ProtectionPolicy

Protection policy.

Type: String
Parameter Sets: (All)
Aliases:

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

-VolumeGroup

Volume group name.

Type: String
Parameter Sets: (All)
Aliases:

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

-Host

Host name.

Type: String
Parameter Sets: (All)
Aliases:

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

-HostGroup

Host group name.

Type: String
Parameter Sets: (All)
Aliases:

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

-Lun

Logical unit number.

Type: Int
Parameter Sets: (All)
Aliases:

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

-ApplianceId

Appliance Id.

Type: String
Parameter Sets: (All)
Aliases:

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

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

NOTES