Data ONTAP® PowerShell Toolkit

Switch to clustered Data ONTAP documentation.

Cmdlet: New-NaUser


NAME
New-NaUser

SYNOPSIS
Adds a user given the information provided.

SYNTAX
New-NaUser [-User] <String> [-Password] <String> [-FullName <String>] [-Comm
ent <String>] [-Groups <String[]>] [-PasswordMinAge <Int64>] [-PasswordMaxAg
e <Int64>] [-Controller <NaController>] [<CommonParameters>]

New-NaUser -Credential <PSCredential> [-FullName <String>] [-Comment <String
>] [-Groups <String[]>] [-PasswordMinAge <Int64>] [-PasswordMaxAge <Int64>]
[-Controller <NaController>] [<CommonParameters>]


DESCRIPTION
Adds a user given the information provided.


PARAMETERS
-User <String>
New user name.

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

-Password <String>
New user password.

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

-FullName <String>
Optional full name of user.

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

-Comment <String>
Optional user comment.

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

-Groups <String[]>
Groups to which this user will belong.

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

-PasswordMinAge <Int64>
Number of days that this user's password must be active before the user
can change it. Default value is 0.

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

-PasswordMaxAge <Int64>
Number of days that this user's password can be active before the user m
ust change it. Default value is 2^31-1 days.

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

-Credential <PSCredential>
A PSCredential object containing the Username for the new user to be cre
ated along with the Password to be used for the new user.

Required? true
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
DataONTAP.Types.Useradmin.UseradminUserInfo


NOTES


Category: useradmin
API: useradmin-user-add

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

C:\PS>New-NaUser krusty s1deshowbob Administrators


Add a new user 'krusty' and add to the Administrators group.


Name : krusty
FullName :
Comment :
UseradminGroups : {Administrators}
AllowedCapabilities : {login-*, cli-*, api-*, security-*}
PasswordMaximumAgeTS : 10675199.02:48:05.4775807
PasswordMinimumAgeTS : 00:00:00
Rid : 131094
Status : enabled



RELATED LINKS
Get-NaUser
Set-NaUser
Remove-NaUser







 Data ONTAP® PowerShell Toolkit