Data ONTAP® PowerShell Toolkit

Cmdlet: Set-NaUserPassword


NAME
Set-NaUserPassword

SYNOPSIS
Changes the password of a specified user.

SYNTAX
Set-NaUserPassword [-User] <String> [-OldPassword] <String> [-NewPassword] <
String> [-Controller <NaController>] [-WarningAction <ActionPreference>] [-W
arningVariable <String>] [<CommonParameters>]

Set-NaUserPassword [-User] <String> [-NewPassword] <String> -ChangeOther [-C
ontroller <NaController>] [-WarningAction <ActionPreference>] [-WarningVaria
ble <String>] [<CommonParameters>]


DESCRIPTION
Changes the password of a specified user.

Note that if the password changes for the user whose credentials are being u
sed to run this cmdlet, subsequent cmdlets will fail with an authentication
error. In this case, follow this cmdlet with another call to Connect-NaCont
roller with the new credentials.


PARAMETERS
-User <String>
The user who's password should be changed.

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

-OldPassword <String>
Current password for the user. A user with the capability 'security-pass
wd-change-others' and at least the same capabilities as the user being c
hanged, does not need to enter the current password in order to change i
t to a new one.

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

-NewPassword <String>
New password for the user. Please see documentation for constraints on t
he password.

Required? true
Position? 3
Default value
Accept pipeline input? true (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

-ChangeOther
Specify if changing another user's password. OldPassword will not be re
quired.

Required? true
Position? named
Default value false
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.UseradminUserInfo


NOTES


Category: useradmin
API: useradmin-user-modify-password

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

C:\PS>Set-NaUserPassword krusty s1deshowbob data4you


Change password for user 'krusty'.


AllowedCapabilities : {login-*, cli-*, api-*, security-*}
Comment :
FullName :
Name : krusty
PasswordMaximumAge : 4294967295
PasswordMinimumAge : 0
Rid : 131086
Status : enabled
UseradminGroups : {Administrators}
PasswordMaximumAgeSpecified : True
PasswordMinimumAgeSpecified : True



RELATED LINKS
Get-NaUser
New-NaUser
Remove-NaUser







 Data ONTAP® PowerShell Toolkit