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
Account switch key, for use when you have access to multiple accounts and need to specify which one to use. Run Get-AccountSwitchKey
to list the account switch keys available to you.
Type String
Parameter Sets (All)
Aliases None
RequiredFalse
Position3
Default value None
Accept pipeline inputFalse
Accept wildcard charactersFalse
-Body
Request body, either as a PSCustomObject
or string. This parameter supports pipelining.
Type Object
Parameter Sets (All)
Aliases None
RequiredTrue
Position0
Default value None
Accept pipeline input True (ByValue)
Accept wildcard charactersFalse
-EdgeRCFile
EdgeRC file to authenticate your command. Defaults to ~/.edgerc
.
Type String
Parameter Sets (All)
Aliases None
RequiredFalse
Position1
Default value None
Accept pipeline inputFalse
Accept wildcard charactersFalse
-Section
EdgeRC section to retrieve authentication credentials from. Defaults to default
.
Type String
Parameter Sets (All)
Aliases None
RequiredFalse
Position2
Default value None
Accept pipeline inputFalse
Accept wildcard charactersFalse
-SendEmail
Sends a one-time password to the new user.
Type SwitchParameter
Parameter Sets (All)
Aliases None
RequiredFalse
Position Named
Default valueFalse
Accept pipeline inputFalse
Accept wildcard charactersFalse
CommonParameters
This cmdlet supports the common parameters: -Debug
, -ErrorAction
, -ErrorVariable
, -InformationAction
, -InformationVariable
, -OutVariable
, -OutBuffer
, -PipelineVariable
, -Verbose
, -WarningAction
, and -WarningVariable
. For more information, see about_CommonParameters.
Inputs
System.Object
Outputs
System.Object
Related links
Updated 5 months ago