User

New-IAMUser

Synopsis

Create a user.

Syntax

New-IAMUser [-Body] <Object> [-SendEmail] [[-EdgeRCFile] <String>] [[-Section] <String>] [[-AccountSwitchKey] <String>] [-ProgressAction <ActionPreference>] [<CommonParameters>]

Description

Creates a user or clones an existing user's role assignments. Optionally, you can send a randomly generated one-time use password to the new user with the SendEmail switch parameter.

If you send an email with the password directly to the user, the response for this operation doesn't include that password. If you don't send this email, the password is included in the response.

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.

‑Body
Required

A request body, either as a PSCustomObject or a string. This parameter supports pipelining.

‑EdgeRCFile

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

‑Section

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

‑SendEmail

Sends a one-time password to the new user.

Related Links