New-OVStorageVolumeTemplate

Syntax

New-OVStorageVolumeTemplate
    [-Name] <String>
    [-StoragePool <Object>]
    [-Capacity] <Int64>
    [-Description <String>]
    [-LockStoragePool]
    [-SnapshotStoragePool <Object>]
    [-LockSnapShotStoragePool]
    [-StorageSystem <Object>]
    [-LockCapacity]
    [-Full]
    [-ProvisioningType <String>]
    [-LockProvisionType]
    [-EnableDeduplication <Boolean>]
    [-LockEnableDeduplication]
    [-EnableCompression <Boolean>]
    [-LockEnableCompression]
    [-Shared]
    [-LockProvisionMode]
    [-Scope <HPEOneView.Appliance.ScopeCollection[]>]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

New-OVStorageVolumeTemplate
    [-Name] <String>
    [-StoragePool <Object>]
    [-Capacity] <Int64>
    [-PerformancePolicy <HPEOneView.Storage.PerformancePolicy>]
    [-Description <String>]
    [-LockStoragePool]
    [-LockCapacity]
    [-ProvisioningType <String>]
    [-LockProvisionType]
    [-Shared]
    [-LockProvisionMode]
    [-LockPerformancePolicy]
    [-EnableEncryption <Bool>]
    [-LockEnableEncryption]
    [-CachePinning <Bool>]
    [-LockCachePinning]
    [-VolumeSet <HPEOneView.Storage.VolumeSet>]
    [-LockVolumeSet]
    [-EnableIOPSLimit <Bool>]
    [-IOPSLimit <Int>]
    [-LockIOPSLimit]
    [-EnableDataTransferLimit <Bool>]
    [-DataTransferLimit <Int>]
    [-LockDataTransferLimit]
    [-Folder <HPEOneView.Storage.NimbleFolder>]
    [-LockFolder]
    [-Scope <HPEOneView.Appliance.ScopeCollection[]>]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

New-OVStorageVolumeTemplate
    [-Name] <String>
    [-StoragePool <Object>]
    [-Capacity] <Int64>
    [-Description <String>]
    [-LockStoragePool]
    [-StorageSystem <Object>]
    [-LockCapacity]
    [-Full]
    [-ProvisioningType <String>]
    [-LockProvisionType]
    [-Shared]
    [-LockProvisionMode]
    [-Scope <HPEOneView.Appliance.ScopeCollection[]>]
    [-ApplianceConnection <Object>]
    [<CommonParameters>]

Description

This Cmdlet supports creating Storage Volume Templates, which are then used to provision Storage Volumes.

Examples

Example 1

New-OVStorageVolumeTemplate -templateName yellow-svt -storagePool yellow -capacity 40

Create a new Storage Volume Template, setting the max size to 40GB, Thin Provisioning and Private.

Example 2

$storageVolTemplate = New-OVStorageVolumeTemplate -templateName vmware-shared-svt -storagePool R5-CPG12 -capacity 250 -shared

Create a new Storage Volume Template, setting the max size to 250GB, Thin Provisioning and Shareable.

Example 3

$storagePool = Get-OVStoragePool R5-CPG12
$storageVolTemplate = New-OVStorageVolumeTemplate -templateName vmware-shared-svt -storagePool $storagePool -capacity 250 -shared

Use the Get-OVStoragePool Cmdlet to get the "R5-CPG12" pool, and create a new Storage Volume Template, setting the max size to 250GB, Thin Provisioning and Shareable.

Example 4

$svt = Get-OVStoragePool R5-CPG12 | New-OVStorageVolumeTemplate -templateName vmware-shared-svt -SnapshotStoragePool "MySnapShotPool" -capacity 250 -shared

Use the Get-OVStoragePool Cmdlet to get the "R5-CPG12" pool, and create a new Storage Volume Template, setting the max size to 250GB, Thin Provisioning, Shareable, and providing the Snapshot Storage Pool.

Parameters

-Name <String>

Storage Volume Template name

Aliases	TemplateName
Required?	True
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Description <String>

Provide the description for the Storage Volume Template

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-StoragePool <Object>

Specify the Storage Pool (aka CPG) the Storage Volume Template will be associated with. Storage Pool must already be managed by OneView.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-SnapshotStoragePool <Object>

Specify the Storage Pool (aka CPG) the Storage Volume Template will use for volume snapshot use. The provided Storage Pool must already be managed by OneView. If you omit this value, then the StoragePool parameter value will be used. Only supported with HPE StoreServe platforms.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-StorageSystem <Object>

If there are multiple Storage Pool resources with the same name, use this parameter to filter for the correct pool object.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Capacity <Int64>

Max volume capacity in GB. [e.g]. 20 to specify 20GB.

Aliases	size
Required?	True
Position?	Named
Default value	0
Accept pipeline input?	false
Accept wildcard characters?	False

-Full <SwitchParameter>

Info

This parameter is being deprecated for the -ProvisionType parameter. Please update your scripts.

Include this switch to enable Thick volume provisioning. Omit to specify Thin storage provisioning. Default: Thin

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-Shared <SwitchParameter>

Include this switch to mark the Storage Volume Template as a Shareable resource for shared volume access.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-ProvisioningType <String>

Specify the type of volume to provision. Allowed values are:

• Thin
• Full
• TPDD (Thin Provision Dedup) - Only available for HPE StoreServ storage systems with SSD storage pools (aka CPG"s).

Aliases	ProvisionType
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockProvisionType <SwitchParameter>

Specify to lock the ProvisionType value in the template.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockStoragePool <SwitchParameter>

Specify to lock the StoragePool value in the template.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-LockSnapShotStoragePool <SwitchParameter>

Specify to lock the SnapshotStoragePool value in the template.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-LockCapacity <SwitchParameter>

Specify to lock the Capacity value in the template.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-LockProvisionMode <SwitchParameter>

Specify to lock the Provision Mode (Shared or Private) value in the template.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-ApplianceConnection <Object>

Specify one [HPEOneView.Appliance.Connection] object or Name property value. If Resource object is provided via Pipeline, the ApplianceConnection property of the object will be used.

Aliases	Appliance
Required?	False
Position?	Named
Default value	(${Global:ConnectedSessions} | ? Default)
Accept pipeline input?	true (ByPropertyName)
Accept wildcard characters?	False

-Scope <HPEOneView.Appliance.ScopeCollection[]>

Provide an [HPEOneView.Appliance.ScopeCollection] resource object to initially associate with. Resource can also be added to scope using the Add-OVResourceToScope Cmdlet.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-EnableCompression <Boolean>

Enable compression for StoreServe (3PAR) supported resources. Please verify the InformOS version installed supports Compression.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-EnableDeduplication <Boolean>

Enable deduplication for SSD-based Storage Pools (CPG).

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-LockEnableDeduplication <SwitchParameter>

Lock the EnableDeduplication value.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-LockEnableCompression <SwitchParameter>

Lock the EnableCompression value.

Aliases	None
Required?	False
Position?	Named
Default value	False
Accept pipeline input?	false
Accept wildcard characters?	False

-CachePinning <Bool>

This is applicable for hybrid (a mix of flash and mechanical storage) arrays, and provides a 100 percent cache hit rate for specific volumes (for example, volumes dedicated to critical applications), and delivers the response times of an all-flash storage system. A volume is pinned when the entire active volume is placed in cache; associated snapshot (inactive) blocks are not pinned. All incoming data after that point is pinned. The number of volumes that can be pinned is limited by the size of the volumes and amount of available cache.

When defined in the Performance Profile, select to enable Cache Pinnning for the Nimble volume to be created.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-DataTransferLimit <Int>

Specify the data transfer limit in MiB/S.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-EnableDataTransferLimit <Bool>

Enable data transfer limit. If enabled, the -DataTransferLimit parameter must be set. By default, data transfer limit is not set.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-EnableEncryption <Bool>

When the storage system has encryption enabled, the volume can also be encrypted. Specify if the volume should be encrypted during creation.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-EnableIOPSLimit <Bool>

Set to enable or disable IOPS limit. If enabled, the -IOPSLimit parameter must be set. By default, IOPS limit is not set.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-Folder <HPEOneView.Storage.NimbleFolder>

Specify the Nimble folder where the volume should be created. To get availabe folder objects, use the Get-OVStoragePool Cmdlet. Folders are defined as a device specific attribute.

Example:

 (`Get-OVStoragePool` `-name` default).DeviceSpecificAttributes.Folders

ID Name -- ---- 2f1ca8a5d76e271722000000000000000000000001 POSH

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-IOPSLimit <Int>

When enabling IOPS limit, provide a value that is greater than or equal to 256.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-PerformancePolicy <HPEOneView.Storage.PerformancePolicy>

A Nimble Performance Policy is associated with a storage system. Using the Show-OVStorageSystemPerformancePolicy, choose an available performance policy.

Example:

Get-OVStorageSystem `-Name` MyNimbleSys | Show-OVStorageSystemPerformancePolicy

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-VolumeSet <HPEOneView.Storage.VolumeSet>

Use to specify a Volume Set the volume will be associated with, from Get-OVStorageVolumeSet.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockCachePinning <SwitchParameter>

Lock the CachePinning value.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockDataTransferLimit <SwitchParameter>

Lock the DataTransferLimit value.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockEnableEncryption <SwitchParameter>

Lock the EnableEncryption value.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockFolder <SwitchParameter>

Lock the Folder value.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockIOPSLimit <SwitchParameter>

Lock the IOPSLimit value.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockPerformancePolicy <SwitchParameter>

Lock the PerformancePolicy value.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

-LockVolumeSet <SwitchParameter>

Lock the VolumeSet value.

Aliases	None
Required?	False
Position?	Named
Default value
Accept pipeline input?	false
Accept wildcard characters?	False

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216)

Input Types

HPEOneView.Storage.System.Pool [System.Management.Automation.PSCustomObject]

Managed Storage Pool resource

Return Values

System.Management.Automation.PSCustomObject

Created Storage Volume Template resource

Related Links

• Get-OVStorageVolumeTemplate
• Get-OVStorageVolumeTemplatePolicy
• Remove-OVStorageVolumeTemplate
• Set-OVStorageVolumeTemplate
• Set-OVStorageVolumeTemplatePolicy