Data ONTAP® PowerShell Toolkit

Cmdlet: New-NaRole


NAME
New-NaRole

SYNOPSIS
Adds a role given the information provided.

SYNTAX
New-NaRole [-Role] <String> [-Comment <String>] -Capabilities <String[]> [-C
ontroller <NaController>] [-WarningAction <ActionPreference>] [-WarningVaria
ble <String>] [<CommonParameters>]


DESCRIPTION
Adds a role given the information provided.


PARAMETERS
-Role <String>
The new role name.

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

-Comment <String>
Comment for the new role.

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

-Capabilities <String[]>
Set of capabilities the new role will have.

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


NOTES


Category: useradmin
API: useradmin-role-add

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

C:\PS>New-NaRole script -Comment "Role for running storage mgt scripts" api-
*


Create a new role 'script' with full 'api-*' capabilities.


AllowedCapabilities Comment Name
------------------- ------- ----
{api-*} Role for running storag... script



RELATED LINKS
Get-NaRole
Set-NaRole
Remove-NaRole







 Data ONTAP® PowerShell Toolkit