|
|
 Data ONTAP® PowerShell Toolkit
|
Cmdlet: Add-NaCifsShare
NAME
Add-NaCifsShare
SYNOPSIS
Creates a new CIFS share rooted at the specified path.
SYNTAX
Add-NaCifsShare [-Share] <String> [-Path] <String> [-Comment <String>] [-Max
Users <Int32>] [-Group <String>] [-Widelink [<Boolean>]] [-SymlinkStrictSecu
rity [<Boolean>]] [-VirusScan [<Boolean>]] [-VirusScanRead [<Boolean>]] [-Br
owse [<Boolean>]] [-Umask <Int32>] [-DirectoryUmask <Int32>] [-FileUmask <In
t32>] [-Caching <String>] [-Controller <NaController>] [-WarningAction <Acti
onPreference>] [-WarningVariable <String>] [<CommonParameters>]
DESCRIPTION
Creates a new CIFS share rooted at the specified path.
PARAMETERS
-Share <String>
Name of the share to be added. The name cannot exceed 12 characters for
DOS-style shares and 256 characters for others.
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Path <String>
Full path name of the directory on the filer corresponding to the root o
f the new share.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Comment <String>
If specified, gives description of the new share. CIFS clients see this
description when browsing the filer's shares. If not specified, the desc
ription is blank.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-MaxUsers <Int32>
If specified, gives the maximum number of simultaneous connections to th
e new share. It must be a positive number. If not specified, the filer d
oes not impose a limit on the number of connections to the share.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Group <String>
If specified, provides name of the group to which files to be created in
the share belong. The groupname is the name of a group in the UNIX grou
p database. If it is an empty string or else not specified, then files t
o be created in the share do not belong to a particular UNIX group. That
is, each file belongs to the same group as the owner of the file.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Widelink [<Boolean>]
If true, allows clients to follow absolute symbolic links outside of thi
s share, subject to NT security. This feature requires an entry in the /
etc/symlink.translations file and it requires that the client supports
Microsoft's Distributed File System (DFS). If false or not specified, wi
delinks in the share are disabled.
Required? false
Position? named
Default value false
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-SymlinkStrictSecurity [<Boolean>]
If true or not specified, strict symlink security is enabled. If false,
allows clients to follow symbolic links to destinations on this filer bu
t outside of the current share. It is not checked if the client is authe
nticated to the symbolic link's destination.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-VirusScan [<Boolean>]
If true or not specified, virus scan is done when clients open files on
this share, else no virus scan is done.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-VirusScanRead [<Boolean>]
If true or not specified, virus scan is done when clients open files on
this share for read access, else no virus scan is done for read access o
n this share.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Browse [<Boolean>]
If true or not specified, shares are visible to browsing clients and can
be enumerated (e.g. "net view", SrvMgr, AD).
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Umask <Int32>
If specified, sets file mode creation mask for a share in qtrees with Un
ix or mixed security styles. The mask restricts the initial permissions
setting of a newly created file or directory. If not specified, the file
mode creation mask of the share is 0. This field is ignored when both D
irectoryUmask and FileUmask are present.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-DirectoryUmask <Int32>
If specified, sets file mode creation mask for a share in qtrees with Un
ix or mixed security styles. The mask restricts the initial permissions
setting of a newly created directory. For directories, this mask overrid
es one set with "Umask".
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-FileUmask <Int32>
If specified, sets file mode creation mask for a share in qtrees with Un
ix or mixed security styles. The mask restricts the initial permissions
setting of a newly created file. For files, this mask overrides one set
with "Umask".
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Caching <String>
If specified, the following is done based on the value of the string: "n
o_caching": disallow Windows clients from caching any files on this shar
e. This is the default value. "auto_document_caching": allow Windows cli
ents to cache user documents on this share. "auto_program_caching": allo
w Windows clients to cache programs on this share. The actual caching be
havior depends on the Windows client.
Required? false
Position? named
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
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
-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
<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.Cifs.CifsShareInfo
NOTES
Category: cifs
API: cifs-share-add
-------------- Example 1 --------------
C:\PS>Add-NaCifsShare MyFiles /vol/vol2
Add a CIFS share 'MyFiles' on volume 'vol2'.
Caching :
Description :
DirUmask :
FileUmask :
Forcegroup :
IsSymlinkStrictSecurity :
IsVolOffline :
IsVscan :
IsVscanread :
IsWidelink :
Maxusers :
MountPoint : /vol/vol2
ShareName : MyFiles
Umask :
DirUmaskSpecified : False
FileUmaskSpecified : False
IsSymlinkStrictSecuritySpecified : False
IsVolOfflineSpecified : False
IsVscanSpecified : False
IsVscanreadSpecified : False
IsWidelinkSpecified : False
MaxusersSpecified : False
UmaskSpecified : False
RELATED LINKS
Remove-NaCifsShare
Get-NaCifsShare
Set-NaCifsShare
| Copyright © 2010 NetApp. All rights reserved. Use is subject to license terms. |
|
Data ONTAP® PowerShell Toolkit
|