Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: New-NcQtree


NAME
New-NcQtree

SYNOPSIS
Create a new qtree.

SYNTAX
New-NcQtree [-Volume] <String> [[-Qtree] <String>] [-Mode <String>] [-Securi
tyStyle <String>] [-Oplocks <String>] [-VserverContext <String>] [-Controlle
r <NcController[]>] [<CommonParameters>]


DESCRIPTION
Create a new qtree.


PARAMETERS
-Volume <String>
Name of the volume on which to create the qtree. This parameter may als
o be the complete path of the new qtree in the format /vol/<volume>/<qtr
ee>, in which case the Qtree parameter should not be specified.

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

-Qtree <String>
The path of the qtree, relative to the volume.

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

-Mode <String>
The file permission bits of the qtree. Similar to UNIX permission bits:
0755 gives read/write/execute permissions to owner and read/execute to
group and other users. It consists of 4 octal digits derived by adding
up bits 4, 2, and 1. Omitted digits are assumed to be zeros. First dig
it selects the set user ID (4), set group ID (2), and sticky (1) attribu
tes. The second digit selects permissions for the owner of the file: re
ad (4), write (2), and execute (1); the third selects permissions for ot
her users in the same group; the fourth for other users not in the group
. If this argument is missing, the permissions of the volume are used.

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

-SecurityStyle <String>
Security style of the qtree. Possible values: "unix", "ntfs", or "mixed
". Default value is the security style of the volume.

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

-Oplocks <String>
Opportunistic locks mode of the qtree. Possible values: "enabled", "dis
abled". Default value is the oplock mode of the volume.

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

-VserverContext <String>
Vserver to which to direct this command. If the currently connected con
troller (as embodied by an NcController object) represents a cluster, th
ere are multiple means to address commands to one of its vservers. Eith
er set the Vserver field on the NcController object to direct all subseq
uent commands to that vserver, or supply the VserverContext parameter to
an individual cmdlet. Only cmdlets which may be invoked on vservers of
fer the VserverContext parameter.

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

<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.Qtree.QtreeInfo


NOTES


Category: qtree
API: qtree-create
Family: vserver

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

C:\PS>New-NcQtree /vol/test/qtree1 -SecurityStyle ntfs


Create a new qtree.


Volume Qtree Status SecurityStyle Oplocks Vserver
------ ----- ------ ------------- ------- -------
test qtree1 normal ntfs enabled Knight01



RELATED LINKS
Get-NcQtree







 Data ONTAP® PowerShell Toolkit