Data ONTAP® PowerShell Toolkit

Switch to Data ONTAP Cluster-mode documentation.

Cmdlet: Remove-NaCifsShareAcl


NAME
Remove-NaCifsShareAcl

SYNOPSIS
Deletes an access control entry of the given share.

SYNTAX
Remove-NaCifsShareAcl [-Share] <String> [-User] <String> [-Controller <NaCon
troller>] [-WhatIf] [-Confirm] [<CommonParameters>]

Remove-NaCifsShareAcl [-Share] <String> [-UnixGroup] <String> [-Controller <
NaController>] [-WhatIf] [-Confirm] [<CommonParameters>]


DESCRIPTION
Deletes an access control entry of the given share. This API is equivalent
to "cifs access <share> [-g] <user|group>" CLI.


PARAMETERS
-Share <String>
CIFS share name. It specifies name of the share for which the access ri
ghts have to be deleted. This is a case insensitive field. The maximum
size of the share name is 256 characters.

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

-User <String>
Name of the user. This API deletes the access rights of the specified u
ser. This is a case sensitive field. If specified user does not exist,
this API fails with the reason "Unknown user <username>".

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

-Controller <NaController>
The Data ONTAP controller object, embodied by an NaController object. T
his parameter is returned by the Connect-NaController cmdlet. If not sp
ecified, the value in the global variable CurrentNaController is used.

Required? false
Position? named
Default value
Accept pipeline input? false
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

-UnixGroup <String>
Name of the unix group. This field specifies the unix group for which t
he access rights are to be deleted. This is a case sensitive field. If
the specified group does not exist, this API fails with the reason "Unk
nown Unix group <group-name>".

Required? true
Position? 2
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.Types.Cifs.CifsShareInfo


NOTES


Category: cifs
API: cifs-share-ace-delete

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

C:\PS>Remove-NaCifsShareAcl HOME root | Get-NaCifsShareAcl


Remove the root user from the access control list of CIFS share 'HOME'.


ShareName UserAclInfo
--------- -----------
HOME {everyone}



RELATED LINKS
Get-NaCifsShare
Get-NaCifsShareAcl
Set-NaCifsShareAcl







 Data ONTAP® PowerShell Toolkit