|
|
 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>] [-Controller <NaController>] [-Size] <Str
ing> [-SnapLockType <String>] [-WarningAction <ActionPreference>] [-WarningV
ariable <String>] [-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
-Controller <NaController>
The DataONTAP controller object, embodied by an NaController object. Th
is parameter is returned by the Connect-NaController cmdlet. If not spe
cified, 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 provided, this argument must be accompanied by
the 'Aggregate' parameter described 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
-WarningAction <ActionPreference>
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WarningVariable <String>
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
NetApp.Ontapi.Filer.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 © 2010 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|