Set-HcsPassword
Set-HcsPassword
Sets the password for a user account.
Syntax
Parameter Set: Default
Set-HcsPassword -Password <SecureString> -User <HcsUser> {SSAdmin | SnapshotManager} [-Force] [ <CommonParameters>]
Detailed Description
The Set-HcsPassword cmdlet sets the password for a specified user account.
The password must meet the following requirements for password complexity:
-- SSAdmin. Minimum of eight characters and maximum of 15 characters. Use this type of account to access Windows PowerShell Interface for StorSimple.
-- SnapShotManager. Minimum of 14 characters and maximum of 15 characters. Use this type of account to access for StorSimple SnapShot Manager.
Passwords must contain characters from at least three of the following classes:
-- English upper case letters: A, B, C, ...Z
-- English lower case letters: a, b, c, ...z
-- Westernized Arabic numerals: 0, 1, 2, ...9
-- Non-alphanumeric special characters, such as ?, !, %, $, #
Parameters
-Force
Forces the command to run without asking for user confirmation.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Password<SecureString>
Specifies a password. Specify a secure string for this parameter. To obtain a secure string, use the ConvertTo-SecureString cmdlet. For more information, type Get-Help ConvertTo-SecureString
. The cmdlet sets the password that you specify.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-User<HcsUser>
Specifies the user name for which to change the password.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- This cmdlet does not generate any output.
Examples
Example 1: Set a password for a user
This command sets the password that StorSimple SnapShot Manager uses to connect to the device.
PS C:\> Set-HcsPassword -User ApplicationHost