AWS Identity and Access Management
CLI Reference (API Version 2010-05-08)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

iam-virtualmfadevicecreate

Description

Generates seed information and a serial number in the form of an Amazon Resource Name (ARN) for a user's virtual MFA. For more information about virtual MFA devices, go to Using a Virtual MFA Device in Using AWS Identity and Access Management. For more information about ARNs, Identifiers for IAM Entities in Using AWS Identity and Access Management.

Syntax

iam-virtualmfadevicecreate -b BOOTSTRAPMETHOD -o OUTPUTFILE -p PATH -s VIRTUALMFANAME

Options

Name Description Required

-b BOOTSTRAPMETHOD

Method to use to seed the virtual MFA.

Type: String

Valid Values: QRCodePNG | Base32String

Default: None

Yes

-o OUTPUTFILE

The output path and file name. If you do not specify a value for -o, then the output will be to the command line if Base32String, and to a Java window image if QRCodePNG.

Type: String

Default: None

No

-p PATH

The path for the virtual MFA. If this value is not specified, it defaults to /. For more information about paths, go to Identifiers for IAM Entities in Using AWS Identity and Access Management.

Type: String

Default: None

No

-s VIRTUALMFANAME

The name for the virtual MFA.

Type: String

Default: None

Yes

Output

The output lists the serial number in the form of an ARN for the virtual MFA device.

Example

The following example creates a virtual MFA device with the name yourMFAname and using the QR code bootstrap method to seed the device. The QR code graphic file will be output to the file name and path C:\company\mfa\yourMFAname.png. For information about QR codes and seeding the virtual MFA device, go to Using a Virtual MFA Device in Using AWS Identity and Access Management.

PROMPT> iam-virtualmfadevicecreate -b QRCodePNG -s yourMFAname -o C:\company\mfa\yourMFAname.png