Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: Set-NcQtree


NAME
Set-NcQtree

SYNOPSIS
Modify the attributes of a qtree.

SYNTAX
Set-NcQtree [-Volume] <String> [[-Qtree] <String>] [-Mode <String>] [-Securi
tyStyle <String>] [-ExportPolicy <String>] [-EnableOplocks] [-DisableOplocks
] [-VserverContext <String>] [-Controller <NcController[]>] [<CommonParamete
rs>]


DESCRIPTION
Modify the attributes of a 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
".

Changing the security style of a qtree will change the visibility of exi
sting Windows security descriptors (i.e. ACLs). This may affect the disk
space usage values in the quota database. Turn quotas off and then on t
o re-compute disk space usage.

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

-ExportPolicy <String>
Export policy of the qtree.

If empty string, the qtree will inherit the export policy of the parent
volume.

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

-EnableOplocks
If specified, oplocks will be enabled.

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

-DisableOplocks
If specified, oplocks will be disabled.

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-modify
Family: vserver

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

C:\PS>Set-NcQtree /vol/vol1/qtree1 -SecurityStyle ntfs -EnableOplocks -Vserv
erContext vserver_1


Change the security style and enable oplocks for the given qtree.


Volume Qtree Status Sec
urityStyle Oplocks Vserver
------ ----- ------ ---
---------- ------- -------
vol1 qtree1 normal ntf
s enabled vserver_1



RELATED LINKS
New-NcQtree
Get-NcQtree
Remove-NcQtree
Rename-NcQtree







 Data ONTAP® PowerShell Toolkit