Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: New-NcVserver


NAME
New-NcVserver

SYNOPSIS
Create a new vserver.

SYNTAX
New-NcVserver [-Name] <String> [-RootVolume] <String> [-NameServerSwitch] <S
tring[]> [-RootVolumeSecurityStyle] <String> [-AntivirusOnAccessPolicy <Stri
ng>] [-Comment <String>] [-Language <String>] [-NameMappingSwitch <String[]>
] [-QuotaPolicy <String>] [-SnapshotPolicy <String>] [-RepositoryVserver] [-
Controller <NcController[]>] [-RootVolumeAggregate] <String> [<CommonParamet
ers>]


DESCRIPTION
Create a new vserver.


PARAMETERS
-Name <String>
The name of the new vserver.

Required? true
Position? 1
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-RootVolume <String>
Root volume of the vserver. This volume will be created automatically.

Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-NameServerSwitch <String[]>
Name server switch configuration details for the vserver. Possible valu
es: 'nis', 'file', 'ldap'.

Required? true
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-RootVolumeSecurityStyle <String>
Security style of the root volume. Possible values: 'unix', 'ntfs', 'mi
xed'.

Required? true
Position? 5
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false

-AntivirusOnAccessPolicy <String>
Antivirus policy. Default: default

Required? false
Position? named
Default value default
Accept pipeline input? false
Accept wildcard characters? false

-Comment <String>
Comment.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Language <String>
Specifies the language to use for the vserver. Default: C.

Available language codes are:

'C' .............. POSIX
'ar' ............. Arabic
'cs' ............. Czech
'da' ............. Danish
'de' ............. German
'en' ............. English
'en_US' .......... English (US)
'es' ............. Spanish
'fi' ............. Finnish
'fr' ............. French
'he' ............. Hebrew
'hr' ............. Croatian
'hu' ............. Hungarian
'it' ............. Italian
'ja' ............. Japanese euc-j*
'ja_v1' .......... Japanese euc-j
'ja_JP.PCK' ...... Japanese PCK (sjis)*
'ja_JP.932' ...... Japanese cp932*
'ja_JP.PCK_v2' ... Japanese PCK (sjis)
'ko' ............. Korean
'no' ............. Norwegian
'nl' ............. Dutch
'pl' ............. Polish
'pt' ............. Portuguese
'ro' ............. Romanian
'ru' ............. Russian
'sk' ............. Slovak
'sl' ............. Slovenian
'sv' ............. Swedish
'tr' ............. Turkish
'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'.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-NameMappingSwitch <String[]>
Name mapping switch configuration details for the vserver. Possible val
ues: 'file', 'ldap'. Default: file

Required? false
Position? named
Default value file
Accept pipeline input? false
Accept wildcard characters? false

-QuotaPolicy <String>
Quota policy. Default: default

Required? false
Position? named
Default value default
Accept pipeline input? false
Accept wildcard characters? false

-SnapshotPolicy <String>
Snapshot policy setting. Default: default

Required? false
Position? named
Default value default
Accept pipeline input? false
Accept wildcard characters? false

-RepositoryVserver
If specified, create a repository Vserver. A repository Vserver contains
a single InfiniteVol. Once a repository Vserver is created in a cluster
, additional Vservers cannot be created. Conversely, a repository Vs
erver cannot be created if non-repository Vservers already exist in a cl
uster.

This option is only available in Data ONTAP 8.1.1 and up.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Controller <NcController[]>
A clustered Data ONTAP controller to receive this cmdlet, as embodied by
an NcController object. This parameter is returned by the Connect-NcCo
ntroller cmdlet. If not specified, the value in the global variable Cur
rentNcController is used. In the latter case, if CurrentNcController co
ntains a collection of NcController objects, this cmdlet is invoked on e
ach controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false

-RootVolumeAggregate <String>
The aggregate on which the root volume will be created.

Required? true
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
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.C.Types.Vserver.VserverInfo


NOTES


Category: vserver
API: vserver-create
Family: cluster

-------------- Example 1 --------------

C:\PS>New-NcVserver vserver4 vserver4vol0 aggr1 -NameServerSwitch ldap -Root
VolumeSecurityStyle ntfs -Language en_US.UTF-8


Create a new vserver 'vserver4'.


Name State VserverType Comment
---- ----- ----------- -------
vserver4 running cluster



RELATED LINKS
Get-NcVserver







 Data ONTAP® PowerShell Toolkit