|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: New-NaVol
NAME
New-NaVol
SYNOPSIS
Create a new flexible volume with the given name and characteristics.
SYNTAX
New-NaVol [-Name] <String> [-Aggregate] <String> [-SnapLock] [-LanguageCode
<String>] [-SpaceReserve <String>] [-VmAlignSector <Int32>] [-VmAlignSuffix
<String>] [-Controller <NaController>] [-Size] <String> [-SnapLockType <Stri
ng>] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Create a new flexible volume with the given name and characteristics. Up to
200 volumes can be created on each filer.
PARAMETERS
-Name <String>
Name of the volume to create. The volume name can contain letters, numb
ers, and the underscore character (_), but the first character must be a
letter or an underscore.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Aggregate <String>
The name of the aggregate in which to create the new flexible volume. I
f provided, this argument must be accompanied by the "Size" parameter de
scribed below.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SnapLock
By default, 'SnapLock' is not specified.
When 'SnapLock' is "true" the type of snaplock volume is determined in t
he following way
1> If snaplock-type is set, create the type specified in 'SnapLockType'
(see SnapLockType for more details)
2> Otherwise, create a Snaplock enterprise volume if a Snaplock enterpri
se license has been installed.
3> Otherwise, create a Snaplock compliance volume.
ESERVICENOTLICENSED is returned if the required Snaplock Compliance or E
nterprise license is not installed. EONTAPI_EWORMNOCLOCK is returned if
SnapLock Compliance Clock is not running. If you need to create a snap
lock volume, the suggested method is to specify 'SnapLockType' as "compl
iance" or "enterprise" and not specify 'SnapLock' at all. If you want to
create a non-snaplock volume, the suggested method is to specify neithe
r SnapLockType nor SnapLock.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-LanguageCode <String>
Specifies the language to use for the new volume via a language code.
The default language is the one used by the filer's root volume. Availa
ble language codes are:
C (POSIX)
da (Danish)
de (German)
en (English)
en_US (English (US))
es (Spanish)
fi (Finnish)
fr (French)
he (Hebrew)
it (Italian)
ja (Japanese euc-j)
ja_JP.PCK (Japanese PCK (sjis))
ko (Korean)
no (Norwegian)
nl (Dutch)
pt (Portuguese)
sv (Swedish)
zh (Simplified Chinese)
zh.GBK (Simplified Chinese (GBK))
zh_TW (Traditional Chinese euc-tw)
zh_TW.BIG5 (Traditional Chinese Big 5)
To use UTF-8 as the NFS character set, append '.UTF-8'.
To use UTF-8 as the NFS character set, append '.UTF-8'.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SpaceReserve <String>
Specifies the type of volume guarantee the new volume will use. Possibl
e values: none, file, volume. If this argument is not provided, the def
ault volume guarantee type is volume.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-VmAlignSector <Int32>
The Virtual Machine alignment 512 byte sector number. All files created
with the suffix specified by VmAlignSuffix parameter will have zero-fill
ed <512 * VmAlignSector> bytes data at the beginning so that it's actual
data starts at a different offset instead of zero. This is done so that
the read & writes to such files are aligned to WAFL's 4k block boundary
.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-VmAlignSuffix <String>
The Virtual Machine alignment suffix. The suffix such as '.xyz' is used
to identify the files which need to be aligned. This parameter is only v
alid when VmAlignSector is present.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Size <String>
The initial size of the new flexible volume. The format to use is:
<number>[k|m|g|t]
where "k" means kilobytes, "m" means megabytes, "g" means gigabytes, and
"t" means terabytes. If no units are specified, the number is interpre
ted as the number of bytes. For example: 10g, 1.5tb, 20GB. If provided
, this argument must be accompanied by the 'Aggregate' parameter describ
ed above.
Required? true
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SnapLockType <String>
Specifies the type of Snaplock volume to be created. Possible values - "
compliance" or "enterprise"
ESERVICENOTLICENSED is returned if the necessary Snaplock compliance or
enterprise license has not been installed.
EINVALIDINPUT is returned if 'SnapLockType' has an illegal value or if '
SnapLock' has been set to "false". EONTAPI_EWORMNOCLOCK is returned if
SnapLock Compliance Clock is not running.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm
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 and OutVariable. For more information, type,
"get-help about_commonparameters".
INPUTS
OUTPUTS
DataONTAP.Types.Volume.VolumeInfo
NOTES
Category: volume
API: volume-create
-------------- Example 1 --------------
C:\PS>New-NaVol vol10 aggr1 10g
Create a new volume 'vol10' in aggregate 'aggr1' with size 10 GB.
ChecksumStyle : block
CloneChildren :
CloneParent :
ContainingAggregate : aggr1
DiskCount : 8
FilesTotal : 311280
FilesUsed : 101
IsChecksumEnabled : True
IsInconsistent : False
IsSnaplock : False
IsUnrecoverable : False
MirrorStatus : unmirrored
Name : vol10
PercentageUsed : 0
PlexCount : 1
Plexes : {/aggr1/plex0}
QuotaInit : 0
RaidSize : 16
RaidStatus : raid_dp
Reserve : 0
ReserveRequired : 0
ReserveUsed : 0
Sis :
SizeAvailable : 8589828096
SizeTotal : 8589934592
SizeUsed : 98304
SnaplockType :
SpaceReserve : volume
SpaceReserveEnabled : True
State : online
Type : flex
Uuid : 2ca21586-11bc-11df-9caa-00a09806c227
IsUnrecoverableSpecified : True
PercentageUsedSpecified : True
SpaceReserveEnabledSpecified : True
RELATED LINKS
Remove-NaVol
Get-NaVol
| Copyright © 2012 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|