Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP 7-mode documentation.

Cmdlet: New-NcDirectory


NAME
New-NcDirectory

SYNOPSIS
Create a directory.

SYNTAX
New-NcDirectory [-Path] <String> [-Permission] <String> [-VserverContext <St
ring>] [-Controller <NcController[]>] [-WhatIf] [-Confirm] [<CommonParameter
s>]


DESCRIPTION
Create a directory.


PARAMETERS
-Path <String>
Path of the directory to be created. The value is expected to begin with
/vol/<volumename>.

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

-Permission <String>
Permission of the directory to be created. It's similar to Unix style p
ermission bits: 0755 gives read/write/execute permissions to owner and r
ead/execute to group and other users. It consists of 4 octal digits der
ived by adding up bits 4, 2 and 1. Omitted digits are assumed to be zer
os. First digit selects the set user ID(4), set group ID (2) and sticky
(1) attributes. The second digit selects permission for the owner of t
he file: read (4), write (2) and execute (1); the third selects permissi
ons for other users in the same group; the fourth for other users not in
the group.

Required? true
Position? 2
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 Data ONTAP cluster-mode controller to receive this cmdlet, as embodied
by an NcController object. This parameter is returned by the Connect-N
cController cmdlet. If not specified, the value in the global variable
CurrentNcController is used. In the latter case, if CurrentNcController
contains a collection of NcController objects, this cmdlet is invoked o
n each controller in succession.

Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
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.C.File810.FileInfo


NOTES


Category: file
API: file-create-directory
Family: vserver

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

C:\PS>New-NcDirectory /vol/vol1/users 0755 | ft -AutoSize


Create a new directory 'users' in volume 'vol1'.


Name Type Size Created Modified Owner Group Perm Empty
---- ---- ---- ------- -------- ----- ----- ---- -----
users directory 4 KB 11/14/2011 11/14/2011 0 0 755 True



RELATED LINKS
Read-NcDirectory
Remove-NcDirectory







 Data ONTAP® PowerShell Toolkit