User password

Set-IAMUserPassword

Synopsis

Rotate your password.

Syntax

Set-IAMUserPassword -UIIdentityID <String> -NewPassword <SecureString> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]
Set-IAMUserPassword -CurrentPassword <SecureString> -NewPassword <SecureString> [-EdgeRCFile <String>] [-Section <String>] [-AccountSwitchKey <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Sets the password for your own user or another. When resetting your own password, you need to provide the current password. The -CurrentPassword and -NewPassword parameters accept only a secure string.

Parameters

‑AccountSwitchKey

An account credential key that lets you move between accounts when using an API client enabled for multiple accounts. To find account switch keys, use Get-AccountSwitchKey.

‑CurrentPassword
Conditionally required

An existing password as a SecureString.

‑EdgeRCFile

Your EdgeGrid resource file to authenticate your command. Defaults to ~/.edgerc.

‑NewPassword
Required

A new password as a SecureString.

‑Section

The section name in your EdgeGrid resource file to retrieve authentication credentials from. Defaults to default.

‑UIIdentityID
Conditionally required

A given user's ID. To get this value, run Get-IAMUser.

Related Links