View a markdown version of this page

使用适用于 PowerShell V4 的工具的 IAM 示例 - Amazon Tools for PowerShell （版本 4）
操作
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon Tools for PowerShell V4 的支持已到期。

我们建议您迁移到 Amazon Tools for PowerShell V5 。有关如何迁移的更多详细信息和信息，请参阅我们的终止支持公告。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用适用于 PowerShell V4 的工具的 IAM 示例

以下代码示例向您展示了如何使用带有 IAM 的 Amazon Tools for PowerShell V4 来执行操作和实现常见场景。

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示了如何使用 Add-IAMClientIDToOpenIDConnectProvider。

适用于 PowerShell V4 的工具

示例 1：此命令将客户端 ID（或受众）my-application-ID 添加到名为 server.example.com 的现有 OIDC 提供者。

Add-IAMClientIDToOpenIDConnectProvider -ClientID "my-application-ID" -OpenIDConnectProviderARN "arn:aws:iam::123456789012:oidc-provider/server.example.com"

以下代码示例演示了如何使用 Add-IAMRoleTag。

适用于 PowerShell V4 的工具

示例 1：此示例在身份管理服务中为角色添加标签

Add-IAMRoleTag -RoleName AdminRoleacess -Tag @{ Key = 'abac'; Value = 'testing'}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) TagRole中的。

以下代码示例演示了如何使用 Add-IAMRoleToInstanceProfile。

适用于 PowerShell V4 的工具

示例 1：此命令将名为 S3Access 的角色添加到名为 webserver 的现有实例配置文件中。要创建实例配置文件，请使用 New-IAMInstanceProfile 命令。使用此命令创建实例配置文件并将其与角色关联后，您可以将其附加到 EC2 实例。为此，请使用带有 InstanceProfile_Arn 或 InstanceProfile-Name 参数的 New-EC2Instance cmdlet 来启动新实例。

Add-IAMRoleToInstanceProfile -RoleName "S3Access" -InstanceProfileName "webserver"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) AddRoleToInstanceProfile中的。

以下代码示例演示了如何使用 Add-IAMUserTag。

适用于 PowerShell V4 的工具

示例 1：此示例在身份管理服务中为用户添加标签

Add-IAMUserTag -UserName joe -Tag @{ Key = 'abac'; Value = 'testing'}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) TagUser中的。

以下代码示例演示了如何使用 Add-IAMUserToGroup。

适用于 PowerShell V4 的工具

示例 1：此命令将名为 Bob 的用户添加到名为 Admins 的组中。

Add-IAMUserToGroup -UserName "Bob" -GroupName "Admins"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) AddUserToGroup中的。

以下代码示例演示了如何使用 Disable-IAMMFADevice。

适用于 PowerShell V4 的工具

示例 1：此命令禁用与具有序列号 123456789012 的用户 Bob 关联的硬件 MFA 设备。

Disable-IAMMFADevice -UserName "Bob" -SerialNumber "123456789012"

示例 2：此命令禁用与具有 ARN arn:aws:iam::210987654321:mfa/David 的用户 David 关联的虚拟 MFA 设备。请注意，虚拟 MFA 设备不会从账户中删除。虚拟设备仍然存在并出现在 Get-IAMVirtualMFADevice 命令的输出中。您必须先使用 Remove-IAMVirtualMFADevice 命令删除旧的虚拟 MFA 设备，然后才能为同一用户创建新的虚拟 MFA 设备。

Disable-IAMMFADevice -UserName "David" -SerialNumber "arn:aws:iam::210987654321:mfa/David"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeactivateMfaDevice中的。

以下代码示例演示了如何使用 Edit-IAMPassword。

适用于 PowerShell V4 的工具

示例 1：此命令更改运行该命令的用户的密码。此命令只能由 IAM 用户调用。如果您在使用 Amazon 账户（根）凭据登录时调用此命令，则该命令将返回错误。InvalidUserType

Edit-IAMPassword -OldPassword "MyOldP@ssw0rd" -NewPassword "MyNewP@ssw0rd"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ChangePassword中的。

以下代码示例演示了如何使用 Enable-IAMMFADevice。

适用于 PowerShell V4 的工具

示例 1：此命令启用序列号为 987654321098 的硬件 MFA 设备，并将该设备与用户 Bob 关联。它包含设备中按顺序排列的前两个代码。

Enable-IAMMFADevice -UserName "Bob" -SerialNumber "987654321098" -AuthenticationCode1 "12345678" -AuthenticationCode2 "87654321"

示例 2：此示例创建并启用虚拟 MFA 设备。第一条命令创建虚拟设备并在变量 $MFADevice 中返回设备的对象表示形式。您可以使用 .Base32StringSeed 或 QRCodePng 属性来配置用户的软件应用程序。最后一条命令将该设备分配给用户 David，通过其序列号识别设备。该命令还 Amazon 通过按顺序包含虚拟 MFA 设备中的前两个代码来与设备同步。

$MFADevice = New-IAMVirtualMFADevice -VirtualMFADeviceName "MyMFADevice"
# see example for New-IAMVirtualMFADevice to see how to configure the software program with PNG or base32 seed code
Enable-IAMMFADevice -UserName "David" -SerialNumber -SerialNumber $MFADevice.SerialNumber -AuthenticationCode1 "24681357" -AuthenticationCode2 "13572468"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) EnableMfaDevice中的。

以下代码示例演示了如何使用 Get-IAMAccessKey。

适用于 PowerShell V4 的工具

示例 1：此命令列出名为 Bob 的 IAM 用户的访问密钥。请注意，您无法列出 IAM 用户的秘密访问密钥。如果秘密访问密钥丢失，则必须使用 New-IAMAccessKey cmdlet 创建新的访问密钥。

Get-IAMAccessKey -UserName "Bob"

输出：

AccessKeyId                CreateDate                   Status              UserName
-----------                ----------                   ------              --------
AKIAIOSFODNN7EXAMPLE       12/3/2014 10:53:41 AM        Active              Bob
AKIAI44QH8DHBEXAMPLE       6/6/2013 8:42:26 PM          Inactive            Bob

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListAccessKeys中的。

以下代码示例演示了如何使用 Get-IAMAccessKeyLastUsed。

适用于 PowerShell V4 的工具

示例 1：返回所提供访问密钥的拥有用户名和上次使用信息。

Get-IAMAccessKeyLastUsed -AccessKeyId ABCDEXAMPLE

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetAccessKeyLastUsed中的。

以下代码示例演示了如何使用 Get-IAMAccountAlias。

适用于 PowerShell V4 的工具

示例 1：此命令返回 Amazon Web Services 账户的账户别名。

Get-IAMAccountAlias

输出：

ExampleCo

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListAccountAliases中的。

以下代码示例演示了如何使用 Get-IAMAccountAuthorizationDetail。

适用于 PowerShell V4 的工具

示例 1：此示例获取有关 Amazon 账户中身份的授权详细信息，并显示返回对象的元素列表，包括用户、群组和角色。例如，UserDetailList 属性显示有关用户的详细信息。RoleDetailList 和 GroupDetailList 属性中也提供类似的信息。

$Details=Get-IAMAccountAuthorizationDetail
$Details

输出：

GroupDetailList : {Administrators, Developers, Testers, Backup}
IsTruncated     : False
Marker          : 
RoleDetailList  : {TestRole1, AdminRole, TesterRole, clirole...}
UserDetailList  : {Administrator, Bob, BackupToS3, }
$Details.UserDetailList

输出：

Arn            : arn:aws:iam::123456789012:user/Administrator
CreateDate     : 10/16/2014 9:03:09 AM
GroupList      : {Administrators}
Path           : /
UserId         : AIDACKCEVSQ6CEXAMPLE1
UserName       : Administrator
UserPolicyList : {}

Arn            : arn:aws:iam::123456789012:user/Bob
CreateDate     : 4/6/2015 12:54:42 PM
GroupList      : {Developers}
Path           : /
UserId         : AIDACKCEVSQ6CEXAMPLE2
UserName       : bab
UserPolicyList : {}

Arn            : arn:aws:iam::123456789012:user/BackupToS3
CreateDate     : 1/27/2015 10:15:08 AM
GroupList      : {Backup}
Path           : /
UserId         : AIDACKCEVSQ6CEXAMPLE3
UserName       : BackupToS3
UserPolicyList : {BackupServicePermissionsToS3Buckets}

以下代码示例演示了如何使用 Get-IAMAccountPasswordPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例返回有关当前账户密码策略的详细信息。如果没有为账户定义密码策略，则命令将返回 NoSuchEntity 错误。

Get-IAMAccountPasswordPolicy

输出：

AllowUsersToChangePassword : True
ExpirePasswords            : True
HardExpiry                 : False
MaxPasswordAge             : 90
MinimumPasswordLength      : 8
PasswordReusePrevention    : 20
RequireLowercaseCharacters : True
RequireNumbers             : True
RequireSymbols             : False
RequireUppercaseCharacters : True

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetAccountPasswordPolicy中的。

以下代码示例演示了如何使用 Get-IAMAccountSummary。

适用于 PowerShell V4 的工具

示例 1：此示例将返回有关 Amazon Web Services 账户中当前 IAM 实体使用情况和当前 IAM 实体配额的信息。

Get-IAMAccountSummary

输出：


Key                                        Value
Users                                      7
GroupPolicySizeQuota                       5120
PolicyVersionsInUseQuota                   10000
ServerCertificatesQuota                    20
AccountSigningCertificatesPresent          0
AccountAccessKeysPresent                   0
Groups                                     3
UsersQuota                                 5000
RolePolicySizeQuota                        10240
UserPolicySizeQuota                        2048
GroupsPerUserQuota                         10
AssumeRolePolicySizeQuota                  2048
AttachedPoliciesPerGroupQuota              2
Roles                                      9
VersionsPerPolicyQuota                     5
GroupsQuota                                100
PolicySizeQuota                            5120
Policies                                   5
RolesQuota                                 250
ServerCertificates                         0
AttachedPoliciesPerRoleQuota               2
MFADevicesInUse                            2
PoliciesQuota                              1000
AccountMFAEnabled                          1
Providers                                  2
InstanceProfilesQuota                      100
MFADevices                                 4
AccessKeysPerUserQuota                     2
AttachedPoliciesPerUserQuota               2
SigningCertificatesPerUserQuota            2
PolicyVersionsInUse                        4
InstanceProfiles                           1
...

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetAccountSummary中的。

以下代码示例演示了如何使用 Get-IAMAttachedGroupPolicyList。

适用于 PowerShell V4 的工具

示例 1：此命令返回挂载到 Amazon 账户中名为 IAM 组的托管策略Admins的名称和 ARNs 托管策略。要查看组中嵌入的内联策略列表，请使用 Get-IAMGroupPolicyList 命令。

Get-IAMAttachedGroupPolicyList -GroupName "Admins"

输出：

PolicyArn                                                 PolicyName
---------                                                 ----------
arn:aws:iam::aws:policy/SecurityAudit                     SecurityAudit
arn:aws:iam::aws:policy/AdministratorAccess               AdministratorAccess

以下代码示例演示了如何使用 Get-IAMAttachedRolePolicyList。

适用于 PowerShell V4 的工具

示例 1：此命令返回挂载到 Amazon 账户中名为 IAM 角色的托管策略SecurityAuditRole的名称和 ARNs 托管策略。要查看嵌入在角色中的内联策略的列表，请使用 Get-IAMRolePolicyList 命令。

Get-IAMAttachedRolePolicyList -RoleName "SecurityAuditRole"

输出：

PolicyArn                                                 PolicyName
---------                                                 ----------
arn:aws:iam::aws:policy/SecurityAudit                     SecurityAudit

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListAttachedRolePolicies中的。

以下代码示例演示了如何使用 Get-IAMAttachedUserPolicyList。

适用于 PowerShell V4 的工具

示例 1：此命令返回 Amazon 账户Bob中名为 IAM 用户的名称和 ARNs 托管策略。要查看嵌入在 IAM 用户中的内联策略的列表，请使用 Get-IAMUserPolicyList 命令。

Get-IAMAttachedUserPolicyList -UserName "Bob"

输出：

PolicyArn                                                 PolicyName
---------                                                 ----------
arn:aws:iam::aws:policy/TesterPolicy                      TesterPolicy

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListAttachedUserPolicies中的。

以下代码示例演示了如何使用 Get-IAMContextKeysForCustomPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例获取所提供策略 json 中存在的所有上下文键。为提供多个策略，您可以用逗号分隔值列表提供。

$policy1 = '{"Version":"2012-10-17","Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2015-08-16T12:00:00Z"}}}}'
$policy2 = '{"Version":"2012-10-17","Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/"}}'
Get-IAMContextKeysForCustomPolicy -PolicyInputList $policy1,$policy2

以下代码示例演示了如何使用 Get-IAMContextKeysForPrincipalPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例获取所提供的策略 json 中和附加到 IAM 实体（用户/角色等）的策略中存在的所有上下文键。For-PolicyInputList 您可以将多个值列表作为逗号分隔的值提供。

$policy1 = '{"Version":"2012-10-17","Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/","Condition":{"DateGreaterThan":{"aws:CurrentTime":"2015-08-16T12:00:00Z"}}}}'
$policy2 = '{"Version":"2012-10-17","Statement":{"Effect":"Allow","Action":"dynamodb:*","Resource":"arn:aws:dynamodb:us-west-2:123456789012:table/"}}'
Get-IAMContextKeysForPrincipalPolicy -PolicyInputList $policy1,$policy2 -PolicySourceArn arn:aws:iam::852640994763:user/TestUser

以下代码示例演示了如何使用 Get-IAMCredentialReport。

适用于 PowerShell V4 的工具

示例 1：此示例打开返回的报告，并将其作为文本行数组输出到管道。第一行是标题，含有用逗号分隔的列名。接下来的每一行都是一个用户的详细信息行，其中每个字段用逗号分隔。必须先使用 Request-IAMCredentialReport cmdlet 生成报告，然后才能查看报告。要将报告作为单个字符串检索，请使用 -Raw 而不是 -AsTextArray。-AsTextArray 开关也接受别名 -SplitLines。有关输出中列的完整列表，请参阅服务 API 参考。请注意，如果不使用 -AsTextArray 或 -SplitLines，则必须使用 .NET StreamReader 类从 .Content 属性中提取文本。

Request-IAMCredentialReport

输出：

Description                                                         State
-----------                                                         -----
No report exists. Starting a new report generation task             STARTED
Get-IAMCredentialReport -AsTextArray

输出：

      user,arn,user_creation_time,password_enabled,password_last_used,password_last_changed,password_next_rotation,mfa_active,access_key_1_active,access_key_1_last_rotated,access_key_2_active,access_key_2_last_rotated,cert_1_active,cert_1_last_rotated,cert_2_active,cert_2_last_rotated root_account,arn:aws:iam::123456789012:root,2014-10-15T16:31:25+00:00,not_supported,2015-04-20T17:41:10+00:00,not_supported,not_supported,true,false,N/A,false,N/A,false,N/A,false,N/A
Administrator,arn:aws:iam::123456789012:user/Administrator,2014-10-16T16:03:09+00:00,true,2015-04-20T15:18:32+00:00,2014-10-16T16:06:00+00:00,N/A,false,true,2014-12-03T18:53:41+00:00,true,2015-03-25T20:38:14+00:00,false,N/A,false,N/A
Bill,arn:aws:iam::123456789012:user/Bill,2015-04-15T18:27:44+00:00,false,N/A,N/A,N/A,false,false,N/A,false,N/A,false,2015-04-20T20:00:12+00:00,false,N/A

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetCredentialReport中的。

以下代码示例演示了如何使用 Get-IAMEntitiesForPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例返回附加了策略 arn:aws:iam::123456789012:policy/TestPolicy 的 IAM 组、角色和用户的列表。

Get-IAMEntitiesForPolicy -PolicyArn "arn:aws:iam::123456789012:policy/TestPolicy"

输出：

IsTruncated  : False
Marker       : 
PolicyGroups : {}
PolicyRoles  : {testRole}
PolicyUsers  : {Bob, Theresa}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListEntitiesForPolicy中的。

以下代码示例演示了如何使用 Get-IAMGroup。

适用于 PowerShell V4 的工具

示例 1：此示例返回有关 IAM 组 Testers 的详细信息，包括属于该组的所有 IAM 用户的集合。

$results = Get-IAMGroup -GroupName "Testers"
$results

输出：

Group                                     IsTruncated           Marker                Users
-----                                     -----------           ------                -----
Amazon.IdentityManagement.Model.Group     False                                       {Theresa, David}
$results.Group

输出：

Arn        : arn:aws:iam::123456789012:group/Testers
CreateDate : 12/10/2014 3:39:11 PM
GroupId    : 3RHNZZGQJ7QHMAEXAMPLE1
GroupName  : Testers
Path       : /
$results.Users

输出：

Arn              : arn:aws:iam::123456789012:user/Theresa
CreateDate       : 12/10/2014 3:39:27 PM
PasswordLastUsed : 1/1/0001 12:00:00 AM
Path             : /
UserId           : 4OSVDDJJTF4XEEXAMPLE2
UserName         : Theresa

Arn              : arn:aws:iam::123456789012:user/David
CreateDate       : 12/10/2014 3:39:27 PM
PasswordLastUsed : 3/19/2015 8:44:04 AM
Path             : /
UserId           : Y4FKWQCXTA52QEXAMPLE3
UserName         : David

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetGroup中的。

以下代码示例演示了如何使用 Get-IAMGroupForUser。

适用于 PowerShell V4 的工具

示例 1：此示例返回 IAM 用户 David 所属的 IAM 组列表。

Get-IAMGroupForUser -UserName David

输出：

Arn        : arn:aws:iam::123456789012:group/Administrators
CreateDate : 10/20/2014 10:06:24 AM
GroupId    : 6WCH4TRY3KIHIEXAMPLE1
GroupName  : Administrators
Path       : /
      
Arn        : arn:aws:iam::123456789012:group/Testers
CreateDate : 12/10/2014 3:39:11 PM
GroupId    : RHNZZGQJ7QHMAEXAMPLE2
GroupName  : Testers
Path       : /
      
Arn        : arn:aws:iam::123456789012:group/Developers
CreateDate : 12/10/2014 3:38:55 PM
GroupId    : ZU2EOWMK6WBZOEXAMPLE3
GroupName  : Developers
Path       : /

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListGroupsForUser中的。

以下代码示例演示了如何使用 Get-IAMGroupList。

适用于 PowerShell V4 的工具

示例 1：此示例返回当前中定义的所有 IAM 组的集合 Amazon Web Services 账户。

Get-IAMGroupList

输出：

Arn        : arn:aws:iam::123456789012:group/Administrators
CreateDate : 10/20/2014 10:06:24 AM
GroupId    : 6WCH4TRY3KIHIEXAMPLE1
GroupName  : Administrators
Path       : /

Arn        : arn:aws:iam::123456789012:group/Developers
CreateDate : 12/10/2014 3:38:55 PM
GroupId    : ZU2EOWMK6WBZOEXAMPLE2
GroupName  : Developers
Path       : /

Arn        : arn:aws:iam::123456789012:group/Testers
CreateDate : 12/10/2014 3:39:11 PM
GroupId    : RHNZZGQJ7QHMAEXAMPLE3
GroupName  : Testers
Path       : /

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListGroups中的。

以下代码示例演示了如何使用 Get-IAMGroupPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例返回有关组 Testers 的名为 PowerUserAccess-Testers 的嵌入式内联策略的详细信息。PolicyDocument 属性采用 URL 编码。在本例中，使用 UrlDecode .NET 方法对其进行解码。

$results = Get-IAMGroupPolicy -GroupName Testers -PolicyName PowerUserAccess-Testers
$results

输出：

GroupName     PolicyDocument                                              PolicyName
---------     --------------                                              ----------
Testers       %7B%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%0A%20... PowerUserAccess-Testers

[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
[System.Web.HttpUtility]::UrlDecode($results.PolicyDocument)
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeInstances"
      ],
      "Resource": [
        "arn:aws:ec2:us-east-1:555555555555:instance/i-b188560f"
      ]
    }
  ]
}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetGroupPolicy中的。

以下代码示例演示了如何使用 Get-IAMGroupPolicyList。

适用于 PowerShell V4 的工具

示例 1：返回嵌入组 Testers 中的内联策略的列表。要获取附加到该组的托管策略，请使用命令 Get-IAMAttachedGroupPolicyList。

Get-IAMGroupPolicyList -GroupName Testers

输出：

Deny-Assume-S3-Role-In-Production
PowerUserAccess-Testers

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListGroupPolicies中的。

以下代码示例演示了如何使用 Get-IAMInstanceProfile。

适用于 PowerShell V4 的工具

示例 1：此示例返回当前 Amazon 账户中定义ec2instancerole的名为的实例配置文件的详细信息。

Get-IAMInstanceProfile -InstanceProfileName ec2instancerole

输出：

Arn                 : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate          : 2/17/2015 2:49:04 PM
InstanceProfileId   : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path                : /
Roles               : {ec2instancerole}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetInstanceProfile中的。

以下代码示例演示了如何使用 Get-IAMInstanceProfileForRole。

适用于 PowerShell V4 的工具

示例 1：此示例返回与角色 ec2instancerole 关联的实例配置文件的详细信息。

Get-IAMInstanceProfileForRole -RoleName ec2instancerole

输出：

      Arn                 : arn:aws:iam::123456789012:instance-profile/ec2instancerole
      CreateDate          : 2/17/2015 2:49:04 PM
      InstanceProfileId   : HH36PTZQJUR32EXAMPLE1
      InstanceProfileName : ec2instancerole
      Path                : /
      Roles               : {ec2instancerole}

以下代码示例演示了如何使用 Get-IAMInstanceProfileList。

适用于 PowerShell V4 的工具

示例 1：此示例返回当前中定义的实例配置文件的集合 Amazon Web Services 账户。

Get-IAMInstanceProfileList

输出：

Arn                 : arn:aws:iam::123456789012:instance-profile/ec2instancerole
CreateDate          : 2/17/2015 2:49:04 PM
InstanceProfileId   : HH36PTZQJUR32EXAMPLE1
InstanceProfileName : ec2instancerole
Path                : /
Roles               : {ec2instancerole}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListInstanceProfiles中的。

以下代码示例演示了如何使用 Get-IAMLoginProfile。

适用于 PowerShell V4 的工具

示例 1：此示例返回密码创建日期，以及 IAM 用户 David 是否需要重置密码。

Get-IAMLoginProfile -UserName David

输出：

CreateDate                   PasswordResetRequired                 UserName
----------                   ---------------------                 --------
12/10/2014 3:39:44 PM        False                                 David

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetLoginProfile中的。

以下代码示例演示了如何使用 Get-IAMMFADevice。

适用于 PowerShell V4 的工具

示例 1：此示例返回有关分配给 IAM 用户 David 的 MFA 设备的详细信息。在此示例中，您可以看出它是虚拟设备，因为 SerialNumber 是 ARN，而不是物理设备的实际序列号。

Get-IAMMFADevice -UserName David

输出：

EnableDate                  SerialNumber                           UserName
----------                  ------------                           --------
4/8/2015 9:41:10 AM         arn:aws:iam::123456789012:mfa/David    David

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListMfaDevices中的。

以下代码示例演示了如何使用 Get-IAMOpenIDConnectProvider。

适用于 PowerShell V4 的工具

示例 1：此示例返回有关 ARN 为 arn:aws:iam::123456789012:oidc-provider/accounts.google.com 的 OpenID Connect 提供者的详细信息。该ClientIDList属性是一个集合，其中包含为此提供者 IDs 定义的所有客户端。

Get-IAMOpenIDConnectProvider -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/oidc.example.com

输出：

ClientIDList         CreateDate                ThumbprintList                               Url
------------         ----------                --------------                               ---
{MyOIDCApp}          2/3/2015 3:00:30 PM       {12345abcdefghijk67890lmnopqrst98765uvwxy}   oidc.example.com

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetOpenIdConnectProvider中的。

以下代码示例演示了如何使用 Get-IAMOpenIDConnectProviderList。

适用于 PowerShell V4 的工具

示例 1：此示例返回当前 Amazon Web Services 账户账户中定义的所有 OpenID Connect 提供者的 ARN 列表。

Get-IAMOpenIDConnectProviderList

输出：

Arn
---
arn:aws:iam::123456789012:oidc-provider/server.example.com
arn:aws:iam::123456789012:oidc-provider/another.provider.com

以下代码示例演示了如何使用 Get-IAMPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例将返回 ARN 为 arn:aws:iam::123456789012:policy/MySamplePolicy 的托管策略的详细信息。

Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy

输出：

Arn              : arn:aws:iam::aws:policy/MySamplePolicy
AttachmentCount  : 0
CreateDate       : 2/6/2015 10:40:08 AM
DefaultVersionId : v1
Description      : 
IsAttachable     : True
Path             : /
PolicyId         : Z27SI6FQMGNQ2EXAMPLE1
PolicyName       : MySamplePolicy
UpdateDate       : 2/6/2015 10:40:08 AM

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetPolicy中的。

以下代码示例演示了如何使用 Get-IAMPolicyList。

适用于 PowerShell V4 的工具

示例 1：此示例返回当前 Amazon 账户中可用的前三个托管策略的集合。由于-scope未指定，因此它默认为all并包括 Amazon 托管策略和客户托管策略。

Get-IAMPolicyList -MaxItem 3

输出：

Arn              : arn:aws:iam::aws:policy/AWSDirectConnectReadOnlyAccess
AttachmentCount  : 0
CreateDate       : 2/6/2015 10:40:08 AM
DefaultVersionId : v1
Description      : 
IsAttachable     : True
Path             : /
PolicyId         : Z27SI6FQMGNQ2EXAMPLE1
PolicyName       : AWSDirectConnectReadOnlyAccess
UpdateDate       : 2/6/2015 10:40:08 AM
      
Arn              : arn:aws:iam::aws:policy/AmazonGlacierReadOnlyAccess
AttachmentCount  : 0
CreateDate       : 2/6/2015 10:40:27 AM
DefaultVersionId : v1
Description      : 
IsAttachable     : True
Path             : /
PolicyId         : NJKMU274MET4EEXAMPLE2
PolicyName       : AmazonGlacierReadOnlyAccess
UpdateDate       : 2/6/2015 10:40:27 AM
      
Arn              : arn:aws:iam::aws:policy/AWSMarketplaceFullAccess
AttachmentCount  : 0
CreateDate       : 2/11/2015 9:21:45 AM
DefaultVersionId : v1
Description      : 
IsAttachable     : True
Path             : /
PolicyId         : 5ULJSO2FYVPYGEXAMPLE3
PolicyName       : AWSMarketplaceFullAccess
UpdateDate       : 2/11/2015 9:21:45 AM

示例 2：此示例返回当前 Amazon 账户中可用的前两个客户托管保单的集合。其使用 -Scope local 将输出限制为仅限客户管理型策略。

Get-IAMPolicyList -Scope local -MaxItem 2

输出：

Arn              : arn:aws:iam::123456789012:policy/MyLocalPolicy
AttachmentCount  : 0
CreateDate       : 2/12/2015 9:39:09 AM
DefaultVersionId : v2
Description      : 
IsAttachable     : True
Path             : /
PolicyId         : SQVCBLC4VAOUCEXAMPLE4
PolicyName       : MyLocalPolicy
UpdateDate       : 2/12/2015 9:39:53 AM

Arn              : arn:aws:iam::123456789012:policy/policyforec2instancerole
AttachmentCount  : 1
CreateDate       : 2/17/2015 2:51:38 PM
DefaultVersionId : v11
Description      : 
IsAttachable     : True
Path             : /
PolicyId         : X5JPBLJH2Z2SOEXAMPLE5
PolicyName       : policyforec2instancerole
UpdateDate       : 2/18/2015 8:52:31 AM

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListPolicies中的。

以下代码示例演示了如何使用 Get-IAMPolicyVersion。

适用于 PowerShell V4 的工具

示例 1：此示例将返回 ARN 为 arn:aws:iam::123456789012:policy/MyManagedPolicy 的策略 v2 版本的策略文档。Document 属性中的策略文档采用 URL 编码，在本示例中使用 UrlDecode .NET 方法进行解码。

$results = Get-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyManagedPolicy -VersionId v2
$results

输出：

CreateDate             Document                                        IsDefaultVersion     VersionId
----------             --------                                        ----------------     ---------
2/12/2015 9:39:53 AM   %7B%0A%20%20%22Version%22%3A%20%222012-10...    True                 v2

[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
$policy = [System.Web.HttpUtility]::UrlDecode($results.Document)
$policy
{
  "Version":"2012-10-17",
  "Statement": 
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeInstances"
      ],
      "Resource": [
        "arn:aws:ec2:us-east-1:555555555555:instance/i-b188560f"
      ]
    }
}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetPolicyVersion中的。

以下代码示例演示了如何使用 Get-IAMPolicyVersionList。

适用于 PowerShell V4 的工具

示例 1：此示例返回 ARN 为 arn:aws:iam::123456789012:policy/MyManagedPolicy 的策略的可用版本列表。要获取特定版本的策略文档，请使用 Get-IAMPolicyVersion 命令并指定所需版本的 VersionId。

Get-IAMPolicyVersionList -PolicyArn arn:aws:iam::123456789012:policy/MyManagedPolicy

输出：

CreateDate                   Document                 IsDefaultVersion                  VersionId
----------                   --------                 ----------------                  ---------
2/12/2015 9:39:53 AM                                  True                              v2
2/12/2015 9:39:09 AM                                  False                             v1

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListPolicyVersions中的。

以下代码示例演示了如何使用 Get-IAMRole。

适用于 PowerShell V4 的工具

示例 1：此示例返回 lamda_exec_role 的详细信息。其包括指定谁可以担任此角色的信任策略文档。策略文档采用 URL 编码，可使用 .NET UrlDecode 方法进行解码。在此示例中，原始策略在上传到策略之前已删除所有空格。要查看确定承担该角色的人员可以执行哪些操作的权限策略文档，对内联策略使用 Get-IAMRolePolicy，对附加的托管策略使用 Get-IAMPolicyVersion。

$results = Get-IamRole -RoleName lambda_exec_role
$results | Format-List

输出：

Arn                      : arn:aws:iam::123456789012:role/lambda_exec_role
AssumeRolePolicyDocument : %7B%22Version%22%3A%222012-10-17%22%2C%22Statement%22%3A%5B%7B%22Sid%22
                           %3A%22%22%2C%22Effect%22%3A%22Allow%22%2C%22Principal%22%3A%7B%22Service
                           %22%3A%22lambda.amazonaws.com%22%7D%2C%22Action%22%3A%22sts%3AAssumeRole
                           %22%7D%5D%7D
CreateDate               : 4/2/2015 9:16:11 AM
Path                     : /
RoleId                   : 2YBIKAIBHNKB4EXAMPLE1
RoleName                 : lambda_exec_role
$policy = [System.Web.HttpUtility]::UrlDecode($results.AssumeRolePolicyDocument)
$policy

输出：

{"Version":"2012-10-17","Statement":[{"Sid":"","Effect":"Allow","Principal":{"Service":"lambda.amazonaws.com"},"Action":"sts:AssumeRole"}]}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetRole中的。

以下代码示例演示了如何使用 Get-IAMRoleList。

适用于 PowerShell V4 的工具

示例 1：此示例检索 Amazon Web Services 账户中的所有 IAM 角色列表。

Get-IAMRoleList

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListRoles中的。

以下代码示例演示了如何使用 Get-IAMRolePolicy。

适用于 PowerShell V4 的工具

示例 1：此示例返回嵌入在 IAM 角色 lamda_exec_role 中的名为 oneClick_lambda_exec_role_policy 的策略的权限策略文档。生成的策略文档采用 URL 编码。在本例中，使用 UrlDecode .NET 方法对其进行解码。

$results = Get-IAMRolePolicy -RoleName lambda_exec_role -PolicyName oneClick_lambda_exec_role_policy
$results

输出：

PolicyDocument                                            PolicyName                           UserName
--------------                                            ----------                           --------
%7B%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%...    oneClick_lambda_exec_role_policy     lambda_exec_role
[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
[System.Web.HttpUtility]::UrlDecode($results.PolicyDocument)

输出：

{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:*"
      ],
      "Resource": "arn:aws:logs:us-east-1:555555555555:log-group:/aws/lambda/aws-example-function:*"
    },
    {
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject"
      ],
      "Resource": [
        "arn:aws:s3:::amzn-s3-demo-bucket/*"
      ]
    }
  ]
}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetRolePolicy中的。

以下代码示例演示了如何使用 Get-IAMRolePolicyList。

适用于 PowerShell V4 的工具

示例 1：此示例返回 IAM 角色 lamda_exec_role 中嵌入的内联策略名称列表。要查看内联策略的详细信息，请使用 Get-IAMRolePolicy 命令。

Get-IAMRolePolicyList -RoleName lambda_exec_role

输出：

oneClick_lambda_exec_role_policy

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListRolePolicies中的。

以下代码示例演示了如何使用 Get-IAMRoleTagList。

适用于 PowerShell V4 的工具

示例 1：此示例获取与角色关联的标签。

Get-IAMRoleTagList -RoleName MyRoleName

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListRoleTags中的。

以下代码示例演示了如何使用 Get-IAMSAMLProvider。

适用于 PowerShell V4 的工具

示例 1：此示例检索有关 ARN 为 arn:aws:iam::123456789012:saml-provider/SAMLADFS 的 SAML 2.0 提供者的详细信息。响应包括您从身份提供商那里获得的用于创建 Amazon SAML 提供商实体的元数据文档以及创建日期和到期日期。

Get-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFS

输出：

CreateDate                 SAMLMetadataDocument                                          ValidUntil
----------                 --------------------                                          ----------
12/23/2014 12:16:55 PM    <EntityDescriptor ID="_12345678-1234-5678-9012-example1...    12/23/2114 12:16:54 PM

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetSamlProvider中的。

以下代码示例演示了如何使用 Get-IAMSAMLProviderList。

适用于 PowerShell V4 的工具

示例 1：此示例将检索在当前 Amazon Web Services 账户中创建的 SAML 2.0 提供者列表。其返回每个 SAML 提供者的 ARN、创建日期和到期日期。

Get-IAMSAMLProviderList

输出：

Arn                                                 CreateDate                      ValidUntil
---                                                 ----------                      ----------
arn:aws:iam::123456789012:saml-provider/SAMLADFS    12/23/2014 12:16:55 PM          12/23/2114 12:16:54 PM

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考文档 (V 4) SAMLProviders 中的列表。

以下代码示例演示了如何使用 Get-IAMServerCertificate。

适用于 PowerShell V4 的工具

示例 1：此示例检索有关名为 MyServerCertificate 的服务器证书的详细信息。您可以在 CertificateBody 和 ServerCertificateMetadata 属性中找到证书详细信息。

$result = Get-IAMServerCertificate -ServerCertificateName MyServerCertificate
$result | format-list

输出：

CertificateBody           : -----BEGIN CERTIFICATE-----
                            MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
                            VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
                            b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
                            BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN
                            MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
                            VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
                            b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
                            YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
                            21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
                            rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
                            Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
                            nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
                            FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
                            NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
                            -----END CERTIFICATE-----
CertificateChain          : 
ServerCertificateMetadata : Amazon.IdentityManagement.Model.ServerCertificateMetadata
$result.ServerCertificateMetadata

输出：

Arn                   : arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyServerCertificate
Expiration            : 1/14/2018 9:52:36 AM
Path                  : /Org1/Org2/
ServerCertificateId   : ASCAJIFEXAMPLE17HQZYW
ServerCertificateName : MyServerCertificate
UploadDate            : 4/21/2015 11:14:16 AM

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetServerCertificate中的。

以下代码示例演示了如何使用 Get-IAMServerCertificateList。

适用于 PowerShell V4 的工具

示例 1：此示例检索已上传到当前 Amazon Web Services 账户的服务器证书列表。

Get-IAMServerCertificateList

输出：

Arn                   : arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyServerCertificate
Expiration            : 1/14/2018 9:52:36 AM
Path                  : /Org1/Org2/
ServerCertificateId   : ASCAJIFEXAMPLE17HQZYW
ServerCertificateName : MyServerCertificate
UploadDate            : 4/21/2015 11:14:16 AM

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListServerCertificates中的。

以下代码示例演示了如何使用 Get-IAMServiceLastAccessedDetail。

适用于 PowerShell V4 的工具

示例 1：此示例提供了请求调用中关联的 IAM 实体（用户、组、角色或策略）上次访问的服务的详细信息。

Request-IAMServiceLastAccessedDetail -Arn arn:aws:iam::123456789012:user/TestUser

输出：

f0b7a819-eab0-929b-dc26-ca598911cb9f
Get-IAMServiceLastAccessedDetail -JobId f0b7a819-eab0-929b-dc26-ca598911cb9f

以下代码示例演示了如何使用 Get-IAMServiceLastAccessedDetailWithEntity。

适用于 PowerShell V4 的工具

示例 1：此示例提供了相应的 IAM 实体上次访问请求中服务的时间戳。

$results = Get-IAMServiceLastAccessedDetailWithEntity -JobId f0b7a819-eab0-929b-dc26-ca598911cb9f -ServiceNamespace ec2
$results

输出：

EntityDetailsList : {Amazon.IdentityManagement.Model.EntityDetails}
Error             : 
IsTruncated       : False
JobCompletionDate : 12/29/19 11:19:31 AM
JobCreationDate   : 12/29/19 11:19:31 AM
JobStatus         : COMPLETED
Marker            : 
$results.EntityDetailsList

输出：

EntityInfo                                 LastAuthenticated
----------                                 -----------------
Amazon.IdentityManagement.Model.EntityInfo 11/16/19 3:47:00 PM
$results.EntityInfo

输出：

Arn  : arn:aws:iam::123456789012:user/TestUser
Id   : AIDA4NBK5CXF5TZHU1234
Name : TestUser
Path : /
Type : USER

以下代码示例演示了如何使用 Get-IAMSigningCertificate。

适用于 PowerShell V4 的工具

示例 1：此示例检索与名为 Bob 的用户关联的签名证书的相关详细信息。

Get-IAMSigningCertificate -UserName Bob

输出：

CertificateBody : -----BEGIN CERTIFICATE-----
                  MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
                  VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
                  b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
                  BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN
                  MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
                  VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
                  b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
                  YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
                  21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
                  rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
                  Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
                  nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
                  FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
                  NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
                  -----END CERTIFICATE-----
CertificateId   : Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU
Status          : Active
UploadDate      : 4/20/2015 1:26:01 PM
UserName        : Bob

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListSigningCertificates中的。

以下代码示例演示了如何使用 Get-IAMUser。

适用于 PowerShell V4 的工具

示例 1：此示例检索名为 David 的用户的详细信息。

Get-IAMUser -UserName David

输出：

Arn              : arn:aws:iam::123456789012:user/David
CreateDate       : 12/10/2014 3:39:27 PM
PasswordLastUsed : 3/19/2015 8:44:04 AM
Path             : /
UserId           : Y4FKWQCXTA52QEXAMPLE1
UserName         : David

示例 2：此示例检索有关当前登录的 IAM 用户的详细信息。

Get-IAMUser

输出：

Arn              : arn:aws:iam::123456789012:user/Bob
CreateDate       : 10/16/2014 9:03:09 AM
PasswordLastUsed : 3/4/2015 12:12:33 PM
Path             : /
UserId           : 7K3GJEANSKZF2EXAMPLE2
UserName         : Bob

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetUser中的。

以下代码示例演示了如何使用 Get-IAMUserList。

适用于 PowerShell V4 的工具

示例 1：此示例检索当前 Amazon Web Services 账户用户集合。

Get-IAMUserList

输出：

      Arn              : arn:aws:iam::123456789012:user/Administrator
      CreateDate       : 10/16/2014 9:03:09 AM
      PasswordLastUsed : 3/4/2015 12:12:33 PM
      Path             : /
      UserId           : 7K3GJEANSKZF2EXAMPLE1
      UserName         : Administrator
      
      Arn              : arn:aws:iam::123456789012:user/Bob
      CreateDate       : 4/6/2015 12:54:42 PM
      PasswordLastUsed : 1/1/0001 12:00:00 AM
      Path             : /
      UserId           : L3EWNONDOM3YUEXAMPLE2
      UserName         : bab
      
      Arn              : arn:aws:iam::123456789012:user/David
      CreateDate       : 12/10/2014 3:39:27 PM
      PasswordLastUsed : 3/19/2015 8:44:04 AM
      Path             : /
      UserId           : Y4FKWQCXTA52QEXAMPLE3
      UserName         : David

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListUsers中的。

以下代码示例演示了如何使用 Get-IAMUserPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例检索嵌入在名为 David 的 IAM 用户中名为 Davids_IAM_Admin_Policy 的内联策略的详细信息。策略文档采用 URL 编码。

$results = Get-IAMUserPolicy -PolicyName Davids_IAM_Admin_Policy -UserName David
$results

输出：

PolicyDocument                                            PolicyName                    UserName
--------------                                            ----------                    --------
%7B%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%...    Davids_IAM_Admin_Policy       David

[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
[System.Web.HttpUtility]::UrlDecode($results.PolicyDocument)
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iam:GetUser",
        "iam:ListUsers"
      ],
      "Resource": [
        "arn:aws:iam::111122223333:user/*"
      ]
    }
  ]
}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetUserPolicy中的。

以下代码示例演示了如何使用 Get-IAMUserPolicyList。

适用于 PowerShell V4 的工具

示例 1：此示例检索嵌入在名为 David 的 IAM 用户中的内联策略名称列表。

Get-IAMUserPolicyList -UserName David

输出：

Davids_IAM_Admin_Policy

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListUserPolicies中的。

以下代码示例演示了如何使用 Get-IAMUserTagList。

适用于 PowerShell V4 的工具

示例 1：此示例获取与用户关联的标签。

Get-IAMUserTagList -UserName joe

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListUserTags中的。

以下代码示例演示了如何使用 Get-IAMVirtualMFADevice。

适用于 PowerShell V4 的工具

示例 1：此示例检索分配给账户中 Amazon 用户的虚拟 MFA 设备集合。每个设备的 User 属性都是一个对象，其中包含设备分配到的 IAM 用户的详细信息。

Get-IAMVirtualMFADevice -AssignmentStatus Assigned

输出：

Base32StringSeed : 
EnableDate       : 4/13/2015 12:03:42 PM
QRCodePNG        : 
SerialNumber     : arn:aws:iam::123456789012:mfa/David
User             : Amazon.IdentityManagement.Model.User

Base32StringSeed : 
EnableDate       : 4/13/2015 12:06:41 PM
QRCodePNG        : 
SerialNumber     : arn:aws:iam::123456789012:mfa/root-account-mfa-device
User             : Amazon.IdentityManagement.Model.User

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListVirtualMfaDevices中的。

以下代码示例演示了如何使用 New-IAMAccessKey。

适用于 PowerShell V4 的工具

示例 1：此示例创建新的访问密钥和秘密访问密钥对，并将其分配给用户 David。确保将 AccessKeyId 和 SecretAccessKey 值保存到文件中，因为这是您唯一可以获得 SecretAccessKey 的时间。您以后无法检索它。如果您丢失了秘密密钥，则必须创建一个新的访问密钥对。

New-IAMAccessKey -UserName David

输出：

AccessKeyId     : AKIAIOSFODNN7EXAMPLE
CreateDate      : 4/13/2015 1:00:42 PM
SecretAccessKey : wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Status          : Active
UserName        : David

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateAccessKey中的。

以下代码示例演示了如何使用 New-IAMAccountAlias。

适用于 PowerShell V4 的工具

示例 1：此示例将您 Amazon 账户的账户别名更改为mycompanyaws。用户登录页面的地址更改为 https://mycom panyaws.signin.aws.amazon.com/console。使用您的账户 ID 号而不是别名的原始 URL（https://<accountidnumber>.signin.aws.amazon.com/console）继续有效。但是，任何先前定义的基于别名的都将 URLs 停止工作。

New-IAMAccountAlias -AccountAlias mycompanyaws

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateAccountAlias中的。

以下代码示例演示了如何使用 New-IAMGroup。

适用于 PowerShell V4 的工具

示例 1：此示例创建了一个名为 Developers 的新 IAM 组。

New-IAMGroup -GroupName Developers

输出：

Arn        : arn:aws:iam::123456789012:group/Developers
CreateDate : 4/14/2015 11:21:31 AM
GroupId    : QNEJ5PM4NFSQCEXAMPLE1
GroupName  : Developers
Path       : /

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateGroup中的。

以下代码示例演示了如何使用 New-IAMInstanceProfile。

适用于 PowerShell V4 的工具

示例 1：此示例创建了一个名为 ProfileForDevEC2Instance 的新 IAM 实例配置文件。您必须单独运行 Add-IAMRoleToInstanceProfile 命令，以将实例配置文件与为该实例提供权限的现有 IAM 角色相关联。最后，在启动实例时将实例配置文件附加到该 EC2 实例。为此，请使用带有 InstanceProfile_Arn 或 InstanceProfile_Name 参数的 New-EC2Instance cmdlet。

New-IAMInstanceProfile -InstanceProfileName ProfileForDevEC2Instance

输出：

Arn                 : arn:aws:iam::123456789012:instance-profile/ProfileForDevEC2Instance
CreateDate          : 4/14/2015 11:31:39 AM
InstanceProfileId   : DYMFXL556EY46EXAMPLE1
InstanceProfileName : ProfileForDevEC2Instance
Path                : /
Roles               : {}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateInstanceProfile中的。

以下代码示例演示了如何使用 New-IAMLoginProfile。

适用于 PowerShell V4 的工具

示例 1：此示例为名为 Bob 的 IAM 用户创建一个（临时）密码，并设置在 Bob 下次登录时要求该用户更改密码的标志。

New-IAMLoginProfile -UserName Bob -Password P@ssw0rd -PasswordResetRequired $true

输出：

CreateDate                    PasswordResetRequired                UserName
----------                    ---------------------                --------
4/14/2015 12:26:30 PM         True                                 Bob

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateLoginProfile中的。

以下代码示例演示了如何使用 New-IAMOpenIDConnectProvider。

适用于 PowerShell V4 的工具

示例 1：此示例创建一个 IAM OIDC 提供者，该提供者与位于 URL https://example.oidcprovider.com 中的 OIDC 兼容提供者服务和客户端 ID my-testapp-1 关联。OIDC 提供者将提供指纹。要对指纹进行身份验证，请按照 http://docs.aws.amazon 上的步骤进行操作。 com/IAM/latest/UserGuide/identity-providers-oidc-obtain-thumbprint .html。

New-IAMOpenIDConnectProvider -Url https://example.oidcprovider.com -ClientIDList my-testapp-1 -ThumbprintList 990F419EXAMPLEECF12DDEDA5EXAMPLE52F20D9E

输出：

arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com

以下代码示例演示了如何使用 New-IAMPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例在当前 Amazon 账户中创建了一个名为的新 IAM 策略。MySamplePolicy该文件MySamplePolicy.json提供了策略内容。请注意，必须使用 -Raw 开关参数才能成功处理 JSON 策略文件。

New-IAMPolicy -PolicyName MySamplePolicy -PolicyDocument (Get-Content -Raw MySamplePolicy.json)

输出：

Arn              : arn:aws:iam::123456789012:policy/MySamplePolicy
AttachmentCount  : 0
CreateDate       : 4/14/2015 2:45:59 PM
DefaultVersionId : v1
Description      : 
IsAttachable     : True
Path             : /
PolicyId         : LD4KP6HVFE7WGEXAMPLE1
PolicyName       : MySamplePolicy
UpdateDate       : 4/14/2015 2:45:59 PM

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreatePolicy中的。

以下代码示例演示了如何使用 New-IAMPolicyVersion。

适用于 PowerShell V4 的工具

示例 1：此示例创建了一个新“v2”版本的 IAM 策略，其 ARN 为 arn:aws:iam::123456789012:policy/MyPolicy，并设为默认版本。NewPolicyVersion.json 文件提供了策略内容。请注意，必须使用 -Raw 开关参数才能成功处理 JSON 策略文件。

New-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyPolicy -PolicyDocument (Get-content -Raw NewPolicyVersion.json) -SetAsDefault $true

输出：

CreateDate                           Document                  IsDefaultVersion             VersionId
----------                           --------                  ----------------             ---------
4/15/2015 10:54:54 AM                                          True                         v2

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreatePolicyVersion中的。

以下代码示例演示了如何使用 New-IAMRole。

适用于 PowerShell V4 的工具

示例 1：此示例创建一个名为 MyNewRole 的新角色，并将文件 NewRoleTrustPolicy.json 中的策略附加到该角色。请注意，必须使用 -Raw 开关参数才能成功处理 JSON 策略文件。输出中显示的策略文档采用 URL 编码。在本例中，使用 UrlDecode .NET 方法对其进行解码。

$results = New-IAMRole -AssumeRolePolicyDocument (Get-Content -raw NewRoleTrustPolicy.json) -RoleName MyNewRole
$results

输出：

Arn                      : arn:aws:iam::123456789012:role/MyNewRole
AssumeRolePolicyDocument : %7B%0D%0A%20%20%22Version%22%3A%20%222012-10-17%22%2C%0D%0A%20%20%22Statement%22
                           %3A%20%5B%0D%0A%20%20%20%20%7B%0D%0A%20%20%20%20%20%20%22Sid%22%3A%20%22%22%2C
                           %0D%0A%20%20%20%20%20%20%22Effect%22%3A%20%22Allow%22%2C%0D%0A%20%20%20%20%20%20
                           %22Principal%22%3A%20%7B%0D%0A%20%20%20%20%20%20%20%20%22AWS%22%3A%20%22arn%3Aaws
                           %3Aiam%3A%3A123456789012%3ADavid%22%0D%0A%20%20%20%20%20%20%7D%2C%0D%0A%20%20%20
                           %20%20%20%22Action%22%3A%20%22sts%3AAssumeRole%22%0D%0A%20%20%20%20%7D%0D%0A%20
                           %20%5D%0D%0A%7D
CreateDate               : 4/15/2015 11:04:23 AM
Path                     : /
RoleId                   : V5PAJI2KPN4EAEXAMPLE1
RoleName                 : MyNewRole

[System.Reflection.Assembly]::LoadWithPartialName("System.Web.HttpUtility")
[System.Web.HttpUtility]::UrlDecode($results.AssumeRolePolicyDocument)
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::123456789012:David"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateRole中的。

以下代码示例演示了如何使用 New-IAMSAMLProvider。

适用于 PowerShell V4 的工具

示例 1：此示例在 IAM 中创建了一个新 SAML 提供者实体。其命名为 MySAMLProvider，通过文件 SAMLMetaData.xml 中的 SAML 元数据文档描述，该文件从 SAML 服务提供者网站单独下载。

New-IAMSAMLProvider -Name MySAMLProvider -SAMLMetadataDocument (Get-Content -Raw SAMLMetaData.xml)

输出：

arn:aws:iam::123456789012:saml-provider/MySAMLProvider

  • 有关 API 的详细信息，请参阅SAMLProvider在 Amazon Tools for PowerShell Cmdlet 参考中创建 (V4)。

以下代码示例演示了如何使用 New-IAMServiceLinkedRole。

适用于 PowerShell V4 的工具

示例 1：此示例为自动扩缩服务创建 servicelinked 角色。

New-IAMServiceLinkedRole -AWSServiceName autoscaling.amazonaws.com -CustomSuffix RoleNameEndsWithThis -Description "My service-linked role to support autoscaling"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateServiceLinkedRole中的。

以下代码示例演示了如何使用 New-IAMUser。

适用于 PowerShell V4 的工具

示例 1：此示例创建一个名为 Bob 的 IAM 用户。如果 Bob 需要登录 Amazon 控制台，则必须单独运行命令New-IAMLoginProfile来创建带有密码的登录配置文件。如果 Bob 需要运行 Amazon PowerShell 或跨平台 CLI 命令或 Amazon 进行 API 调用，则必须单独运行该New-IAMAccessKey命令来创建访问密钥。

New-IAMUser -UserName Bob

输出：

Arn              : arn:aws:iam::123456789012:user/Bob
CreateDate       : 4/22/2015 12:02:11 PM
PasswordLastUsed : 1/1/0001 12:00:00 AM
Path             : /
UserId           : AIDAJWGEFDMEMEXAMPLE1
UserName         : Bob

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateUser中的。

以下代码示例演示了如何使用 New-IAMVirtualMFADevice。

适用于 PowerShell V4 的工具

示例 1：此示例创建一个新的虚拟 MFA 设备。第 2 行和第 3 行提取虚拟 MFA 软件程序创建账户所需的 Base32StringSeed 值（作为二维码的替代方案）。使用该值配置程序后，从程序中获取两个连续的身份验证码。最后，使用最后一条命令将虚拟 MFA 设备关联到 IAM 用户 Bob，并将账户与两个身份验证码同步。

$Device = New-IAMVirtualMFADevice -VirtualMFADeviceName BobsMFADevice
$SR = New-Object System.IO.StreamReader($Device.Base32StringSeed)
$base32stringseed = $SR.ReadToEnd()
$base32stringseed   
CZWZMCQNW4DEXAMPLE3VOUGXJFZYSUW7EXAMPLECR4NJFD65GX2SLUDW2EXAMPLE

输出：

-- Pause here to enter base-32 string seed code into virtual MFA program to register account. --

Enable-IAMMFADevice -SerialNumber $Device.SerialNumber -UserName Bob -AuthenticationCode1 123456 -AuthenticationCode2 789012

示例 2：此示例创建一个新虚拟 MFA 设备。第 2 行和第 3 行提取 QRCodePNG 值并将其写入文件。虚拟的 MFA 软件程序可以扫描此图像以创建账户（作为手动输入 Base32 StringSeed 值的替代方法）。在虚拟 MFA 程序中创建账户后，获取两个连续的身份验证码，然后在最后一条命令中输入验证码，将虚拟 MFA 设备关联到 IAM 用户 Bob 并同步账户。

$Device = New-IAMVirtualMFADevice -VirtualMFADeviceName BobsMFADevice
$BR = New-Object System.IO.BinaryReader($Device.QRCodePNG)
$BR.ReadBytes($BR.BaseStream.Length) | Set-Content -Encoding Byte -Path QRCode.png

输出：

 -- Pause here to scan PNG with virtual MFA program to register account. -- 

Enable-IAMMFADevice -SerialNumber $Device.SerialNumber -UserName Bob -AuthenticationCode1 123456 -AuthenticationCode2 789012

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) CreateVirtualMfaDevice中的。

以下代码示例演示了如何使用 Publish-IAMServerCertificate。

适用于 PowerShell V4 的工具

示例 1：此示例将新服务器证书上传到 IAM 账户。包含证书正文、私有密钥和（可选）证书链的文件必须均采用 PEM 编码。请注意，参数需要文件的实际内容，而不是文件名。必须使用 -Raw 开关参数才能成功处理文件内容。

Publish-IAMServerCertificate -ServerCertificateName MyTestCert -CertificateBody (Get-Content -Raw server.crt) -PrivateKey (Get-Content -Raw server.key)

输出：

Arn                   : arn:aws:iam::123456789012:server-certificate/MyTestCert
Expiration            : 1/14/2018 9:52:36 AM
Path                  : /
ServerCertificateId   : ASCAJIEXAMPLE7J7HQZYW
ServerCertificateName : MyTestCert
UploadDate            : 4/21/2015 11:14:16 AM

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UploadServerCertificate中的。

以下代码示例演示了如何使用 Publish-IAMSigningCertificate。

适用于 PowerShell V4 的工具

示例 1：此示例上传新的 X.509 签名证书并将其与名为 Bob 的 IAM 用户关联。包含证书正文的文件采用 PEM 编码。CertificateBody 参数需要证书文件的实际内容而不是文件名。必须使用 -Raw 开关参数才能成功处理该文件。

Publish-IAMSigningCertificate -UserName Bob -CertificateBody (Get-Content -Raw SampleSigningCert.pem)

输出：

CertificateBody : -----BEGIN CERTIFICATE-----
                  MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
                  VVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
                  b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
                  BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhcNMTEwNDI1MjA0NTIxWhcN
                  MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
                  VQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
                  b2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
                  YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
                  21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
                  rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY6786m86gpE
                  Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
                  nUhVVxYUntneD9+h8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
                  FFBjvSfpJIlJ00zbhNYS5f6GuoEDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
                  NYiytVbZPQUQ5Yaxu2jXnimvw3rrszlaEXAMPLE=
                  -----END CERTIFICATE-----
CertificateId   : Y3EK7RMEXAMPLESV33FCEXAMPLEHMJLU
Status          : Active
UploadDate      : 4/20/2015 1:26:01 PM
UserName        : Bob

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UploadSigningCertificate中的。

以下代码示例演示了如何使用 Register-IAMGroupPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例将名为 TesterPolicy 的客户管理型策略附加到 IAM 组 Testers。该组中的用户会立即受到该策略默认版本中所定义权限的影响。

Register-IAMGroupPolicy -GroupName Testers -PolicyArn arn:aws:iam::123456789012:policy/TesterPolicy

示例 2：此示例将名为的 Amazon 托管策略附加AdministratorAccess到 IAM 组Admins。该组中的用户会立即受到该策略最新版本中所定义权限的影响。

Register-IAMGroupPolicy -GroupName Admins -PolicyArn arn:aws:iam::aws:policy/AdministratorAccess

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) AttachGroupPolicy中的。

以下代码示例演示了如何使用 Register-IAMRolePolicy。

适用于 PowerShell V4 的工具

示例 1：此示例将名为的 Amazon 托管策略附加SecurityAudit到 IAM 角色CoSecurityAuditors。担任该角色的用户会立即受到该策略最新版本中所定义权限的影响。

Register-IAMRolePolicy -RoleName CoSecurityAuditors -PolicyArn arn:aws:iam::aws:policy/SecurityAudit

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) AttachRolePolicy中的。

以下代码示例演示了如何使用 Register-IAMUserPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例将名为的 Amazon 托管策略附加AmazonCognitoPowerUser到 IAM 用户Bob。用户会立即受到该策略最新版本中所定义权限的影响。

Register-IAMUserPolicy -UserName Bob -PolicyArn arn:aws:iam::aws:policy/AmazonCognitoPowerUser

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) AttachUserPolicy中的。

以下代码示例演示了如何使用 Remove-IAMAccessKey。

适用于 PowerShell V4 的工具

示例 1：此示例AKIAIOSFODNN7EXAMPLE从名为的用户删除带有密钥 ID 的 Amazon 访问密钥对Bob。

Remove-IAMAccessKey -AccessKeyId AKIAIOSFODNN7EXAMPLE -UserName Bob -Force

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteAccessKey中的。

以下代码示例演示了如何使用 Remove-IAMAccountAlias。

适用于 PowerShell V4 的工具

示例 1：此示例从您的账户中删除了账户别名 Amazon Web Services 账户。别名为 https://mycom panyaws.signin.aws.amazon.com/console 的用户登录页面不再起作用。相反，你必须使用带有 Amazon Web Services 账户 身份证号的原始 URL，网址为 https: //.signin.aws.amazon.com/console。 <accountidnumber>

Remove-IAMAccountAlias -AccountAlias mycompanyaws

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteAccountAlias中的。

以下代码示例演示了如何使用 Remove-IAMAccountPasswordPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例删除了的密码策略 Amazon Web Services 账户 并将所有值重置为其原始默认值。如果当前不存在密码策略，则会显示以下错误消息：找 PasswordPolicy 不到带有名称的账户策略。

Remove-IAMAccountPasswordPolicy

以下代码示例演示了如何使用 Remove-IAMClientIDFromOpenIDConnectProvider。

适用于 PowerShell V4 的工具

示例 1：此示例将客户端 ID My-TestApp-3 从与 ARN 为 IAM OIDC 提供商 IDs 关联的客户列表中删除。arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com

Remove-IAMClientIDFromOpenIDConnectProvider -ClientID My-TestApp-3 -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com

以下代码示例演示了如何使用 Remove-IAMGroup。

适用于 PowerShell V4 的工具

示例 1：此示例删除名为 MyTestGroup 的 IAM 组。第一条命令删除作为该组成员的所有 IAM 用户，第二条命令删除该 IAM 组。这两条命令都可以在没有任何确认提示的情况下生效。

(Get-IAMGroup -GroupName MyTestGroup).Users | Remove-IAMUserFromGroup -GroupName MyTestGroup -Force
Remove-IAMGroup -GroupName MyTestGroup -Force

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteGroup中的。

以下代码示例演示了如何使用 Remove-IAMGroupPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例从 IAM 组 Testers 中删除名为 TesterPolicy 的内联策略。该组中的用户会立即失去该策略中定义的权限。

Remove-IAMGroupPolicy -GroupName Testers -PolicyName TestPolicy

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteGroupPolicy中的。

以下代码示例演示了如何使用 Remove-IAMInstanceProfile。

适用于 PowerShell V4 的工具

示例 1：此示例删除名为的 EC2 实例配置文件MyAppInstanceProfile。第一条命令从实例配置文件中分离所有角色，然后第二条命令删除实例配置文件。

(Get-IAMInstanceProfile -InstanceProfileName MyAppInstanceProfile).Roles | Remove-IAMRoleFromInstanceProfile -InstanceProfileName MyAppInstanceProfile
Remove-IAMInstanceProfile -InstanceProfileName MyAppInstanceProfile

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteInstanceProfile中的。

以下代码示例演示了如何使用 Remove-IAMLoginProfile。

适用于 PowerShell V4 的工具

示例 1：此示例删除名为 Bob 的 IAM 用户的登录配置文件。这会阻止用户登录控制台。 Amazon 它不会阻止用户使用可能仍附加到用户账户的 Amazon 访问密钥运行任何 Amazon CLI PowerShell、或 API 调用。

Remove-IAMLoginProfile -UserName Bob

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteLoginProfile中的。

以下代码示例演示了如何使用 Remove-IAMOpenIDConnectProvider。

适用于 PowerShell V4 的工具

示例 1：此示例删除了连接到提供者 example.oidcprovider.com 的 IAM OIDC 提供者。确保更新或删除角色信任策略 Principal 元素中引用此提供者的所有角色。

Remove-IAMOpenIDConnectProvider -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com

以下代码示例演示了如何使用 Remove-IAMPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例删除了 ARN 为 arn:aws:iam::123456789012:policy/MySamplePolicy 的策略。必须先通过运行 Remove-IAMPolicyVersion 删除默认版本除外的所有版本，然后才能删除该策略。您还必须将该策略与所有 IAM 用户、组或角色分离。

Remove-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy

示例 2：此示例通过先删除所有非默认策略版本，将其与所有附加的 IAM 实体分离，最后删除策略本身来删除策略。第一行检索策略对象。第二行检索集合中未标记为默认的所有策略版本，然后删除集合中的每个策略。第三行检索该策略附加到的所有 IAM 用户、组和角色。第四行到第六行将该策略与每个附加的实体分离。最后一行使用此命令删除托管策略，以及剩余的默认版本。该示例在需要抑制确认提示的所有行中都包含 -Force 开关参数。

$pol = Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy
Get-IAMPolicyVersions -PolicyArn $pol.Arn | where {-not $_.IsDefaultVersion} | Remove-IAMPolicyVersion -PolicyArn $pol.Arn -force
$attached = Get-IAMEntitiesForPolicy -PolicyArn $pol.Arn
$attached.PolicyGroups | Unregister-IAMGroupPolicy -PolicyArn $pol.arn
$attached.PolicyRoles | Unregister-IAMRolePolicy -PolicyArn $pol.arn
$attached.PolicyUsers | Unregister-IAMUserPolicy -PolicyArn $pol.arn
Remove-IAMPolicy $pol.Arn -Force

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeletePolicy中的。

以下代码示例演示了如何使用 Remove-IAMPolicyVersion。

适用于 PowerShell V4 的工具

示例 1：此示例从 ARN 为 arn:aws:iam::123456789012:policy/MySamplePolicy 的策略中删除标识为 v2 的版本。

Remove-IAMPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy -VersionID v2

示例 2：此示例通过先删除所有非默认策略版本，然后删除策略本身来删除策略。第一行检索策略对象。第二行检索集合中未标记为默认的所有策略版本，然后使用此命令删除集合中的每个策略。最后一行删除策略本身，以及剩余的默认版本。请注意，要成功删除托管策略，还必须使用 Unregister-IAMUserPolicy、Unregister-IAMGroupPolicy 和 Unregister-IAMRolePolicy 命令将该策略与所有用户、组或角色分离。请参阅 Remove-IAMPolicy cmdlet 的示例。

$pol = Get-IAMPolicy -PolicyArn arn:aws:iam::123456789012:policy/MySamplePolicy
Get-IAMPolicyVersions -PolicyArn $pol.Arn | where {-not $_.IsDefaultVersion} | Remove-IAMPolicyVersion -PolicyArn $pol.Arn -force
Remove-IAMPolicy -PolicyArn $pol.Arn -force

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeletePolicyVersion中的。

以下代码示例演示了如何使用 Remove-IAMRole。

适用于 PowerShell V4 的工具

示例 1：此示例从当前 IAM 账户中删除名为 MyNewRole 的角色。必须先使用 Unregister-IAMRolePolicy 命令分离所有托管策略，然后才能删除该角色。内联策略将与角色一起删除。

Remove-IAMRole -RoleName MyNewRole

示例 2：此示例将所有托管策略与名为 MyNewRole 的角色分离，然后删除该角色。第一行检索作为集合附加到该角色的所有托管策略，然后将集合中的每个策略与该角色分离。第二行删除该角色本身。内联策略将与角色一起删除。

Get-IAMAttachedRolePolicyList -RoleName MyNewRole | Unregister-IAMRolePolicy -RoleName MyNewRole
Remove-IAMRole -RoleName MyNewRole

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteRole中的。

以下代码示例演示了如何使用 Remove-IAMRoleFromInstanceProfile。

适用于 PowerShell V4 的工具

示例 1：此示例MyNewRole从名为的 EC2 实例配置文件中删除名为的角色MyNewRole。在 IAM 控制台中创建的实例配置文件始终与角色同名，如本示例所示。如果您在 API 或 CLI 中创建实例配置文件，则其可以有不同的名称。

Remove-IAMRoleFromInstanceProfile -InstanceProfileName MyNewRole -RoleName MyNewRole -Force

以下代码示例演示了如何使用 Remove-IAMRolePermissionsBoundary。

适用于 PowerShell V4 的工具

示例 1：此示例展示了如何删除附加到 IAM 角色的权限边界。

Remove-IAMRolePermissionsBoundary -RoleName MyRoleName

以下代码示例演示了如何使用 Remove-IAMRolePolicy。

适用于 PowerShell V4 的工具

示例 1：此示例删除了 IAM 角色 S3BackupRole 中嵌入的内联策略 S3AccessPolicy。

Remove-IAMRolePolicy -PolicyName S3AccessPolicy -RoleName S3BackupRole

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteRolePolicy中的。

以下代码示例演示了如何使用 Remove-IAMRoleTag。

适用于 PowerShell V4 的工具

示例 1：此示例从名为 “MyRoleName” 的角色中删除标签，标签键为 “abac”。要删除多个标签，请提供以逗号分隔的标签键列表。

Remove-IAMRoleTag -RoleName MyRoleName -TagKey "abac","xyzw"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UntagRole中的。

以下代码示例演示了如何使用 Remove-IAMSAMLProvider。

适用于 PowerShell V4 的工具

示例 1：此示例删除了 ARN 为 arn:aws:iam::123456789012:saml-provider/SAMLADFSProvider 的 IAM SAML 2.0 提供者。

Remove-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFSProvider

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考文档 (V 4) SAMLProvider 中的删除。

以下代码示例演示了如何使用 Remove-IAMServerCertificate。

适用于 PowerShell V4 的工具

示例 1：此示例删除名为 MyServerCert 的服务器证书。

Remove-IAMServerCertificate -ServerCertificateName MyServerCert

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteServerCertificate中的。

以下代码示例演示了如何使用 Remove-IAMServiceLinkedRole。

适用于 PowerShell V4 的工具

示例 1：此示例删除服务关联角色。请注意，如果服务仍在使用此角色，则此命令将导致失败。

Remove-IAMServiceLinkedRole -RoleName AWSServiceRoleForAutoScaling_RoleNameEndsWithThis

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteServiceLinkedRole中的。

以下代码示例演示了如何使用 Remove-IAMSigningCertificate。

适用于 PowerShell V4 的工具

示例 1：此示例从名为 Bob 的 IAM 用户删除 ID 为 Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU 的签名证书。

Remove-IAMSigningCertificate -UserName Bob -CertificateId Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteSigningCertificate中的。

以下代码示例演示了如何使用 Remove-IAMUser。

适用于 PowerShell V4 的工具

示例 1：此示例删除名为 Bob 的 IAM 用户。

Remove-IAMUser -UserName Bob

示例 2：此示例删除名为 Theresa 的 IAM 用户，以及必须先删除的所有元素。

$name = "Theresa"

# find any groups and remove user from them
$groups = Get-IAMGroupForUser -UserName $name
foreach ($group in $groups) { Remove-IAMUserFromGroup -GroupName $group.GroupName -UserName $name -Force }

# find any inline policies and delete them
$inlinepols = Get-IAMUserPolicies -UserName $name
foreach ($pol in $inlinepols) { Remove-IAMUserPolicy -PolicyName $pol -UserName $name -Force}

# find any managed polices and detach them
$managedpols = Get-IAMAttachedUserPolicies -UserName $name
foreach ($pol in $managedpols) { Unregister-IAMUserPolicy -PolicyArn $pol.PolicyArn -UserName $name }

# find any signing certificates and delete them
$certs = Get-IAMSigningCertificate -UserName $name
foreach ($cert in $certs) { Remove-IAMSigningCertificate -CertificateId $cert.CertificateId -UserName $name -Force }

# find any access keys and delete them
$keys = Get-IAMAccessKey -UserName $name
foreach ($key in $keys) { Remove-IAMAccessKey -AccessKeyId $key.AccessKeyId -UserName $name -Force }

# delete the user's login profile, if one exists - note: need to use try/catch to suppress not found error
try { $prof = Get-IAMLoginProfile -UserName $name -ea 0 } catch { out-null }
if ($prof) { Remove-IAMLoginProfile -UserName $name -Force }

# find any MFA device, detach it, and if virtual, delete it.
$mfa = Get-IAMMFADevice -UserName $name
if ($mfa) { 
    Disable-IAMMFADevice -SerialNumber $mfa.SerialNumber -UserName $name 
    if ($mfa.SerialNumber -like "arn:*") { Remove-IAMVirtualMFADevice -SerialNumber $mfa.SerialNumber }
}

# finally, remove the user
Remove-IAMUser -UserName $name -Force

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteUser中的。

以下代码示例演示了如何使用 Remove-IAMUserFromGroup。

适用于 PowerShell V4 的工具

示例 1：此示例从组 Testers 中删除 IAM 用户 Bob。

Remove-IAMUserFromGroup -GroupName Testers -UserName Bob

示例 2：此示例查找 IAM 用户 Theresa 所属的所有组，然后从这些组中删除 Theresa。

$groups = Get-IAMGroupForUser -UserName Theresa 
foreach ($group in $groups) { Remove-IAMUserFromGroup -GroupName $group.GroupName -UserName Theresa -Force }

示例 3：此示例显示了从 Testers 组中删除 IAM 用户 Bob 的另一种方法。

Get-IAMGroupForUser -UserName Bob | Remove-IAMUserFromGroup -UserName Bob -GroupName Testers -Force

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) RemoveUserFromGroup中的。

以下代码示例演示了如何使用 Remove-IAMUserPermissionsBoundary。

适用于 PowerShell V4 的工具

示例 1：此示例展示了如何删除附加到 IAM 用户的权限边界。

Remove-IAMUserPermissionsBoundary -UserName joe

以下代码示例演示了如何使用 Remove-IAMUserPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例删除嵌入在名为 Bob 的 IAM 用户中的名为 AccessToEC2Policy 的内联策略。

Remove-IAMUserPolicy -PolicyName AccessToEC2Policy -UserName Bob

示例 2：此示例查找嵌入在名为 Theresa 的 IAM 用户中的所有内联策略，然后将其删除。

$inlinepols = Get-IAMUserPolicies -UserName Theresa
foreach ($pol in $inlinepols) { Remove-IAMUserPolicy -PolicyName $pol -UserName Theresa -Force}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteUserPolicy中的。

以下代码示例演示了如何使用 Remove-IAMUserTag。

适用于 PowerShell V4 的工具

示例 1：此示例从名为“joe”的用户中删除标签键为“abac”和“xyzw”的标签。要删除多个标签，请提供以逗号分隔的标签键列表。

Remove-IAMUserTag -UserName joe -TagKey "abac","xyzw"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UntagUser中的。

以下代码示例演示了如何使用 Remove-IAMVirtualMFADevice。

适用于 PowerShell V4 的工具

示例 1：此示例删除 ARN 为 arn:aws:iam::123456789012:mfa/bob 的 IAM 虚拟 MFA 设备。

Remove-IAMVirtualMFADevice -SerialNumber arn:aws:iam::123456789012:mfa/bob

示例 2：此示例检查是否为 IAM 用户 Theresa 分配了 MFA 设备。如果找到设备，则会为 IAM 用户禁用该设备。如果设备是虚拟的，则会同时删除该设备。

$mfa = Get-IAMMFADevice -UserName Theresa
if ($mfa) { 
    Disable-IAMMFADevice -SerialNumber $mfa.SerialNumber -UserName $name 
    if ($mfa.SerialNumber -like "arn:*") { Remove-IAMVirtualMFADevice -SerialNumber $mfa.SerialNumber }
}

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteVirtualMfaDevice中的。

以下代码示例演示了如何使用 Request-IAMCredentialReport。

适用于 PowerShell V4 的工具

示例 1：此示例请求生成一份新报告，报告可每四小时生成一次。如果上次报告仍然是最新的，则“状态”字段显示为 COMPLETE。使用 Get-IAMCredentialReport 查看已完成的报告。

Request-IAMCredentialReport

输出：

Description                                                    State
-----------                                                    -----
No report exists. Starting a new report generation task        STARTED

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GenerateCredentialReport中的。

以下代码示例演示了如何使用 Request-IAMServiceLastAccessedDetail。

适用于 PowerShell V4 的工具

示例 1：此示例等同于 API 的 cmdlet。 GenerateServiceLastAccessedDetails 这提供了一个任务 ID，可以在 Get-IAMServiceLastAccessedDetail 和 Get-中使用 IAMService LastAccessedDetailWithEntity

Request-IAMServiceLastAccessedDetail -Arn arn:aws:iam::123456789012:user/TestUser

以下代码示例演示了如何使用 Set-IAMDefaultPolicyVersion。

适用于 PowerShell V4 的工具

示例 1：此示例将 ARN 为 arn:aws:iam::123456789012:policy/MyPolicy 的策略的 v2 版本设置为默认活动版本。

Set-IAMDefaultPolicyVersion -PolicyArn arn:aws:iam::123456789012:policy/MyPolicy -VersionId v2

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) SetDefaultPolicyVersion中的。

以下代码示例演示了如何使用 Set-IAMRolePermissionsBoundary。

适用于 PowerShell V4 的工具

示例 1：此示例展示如何设置 IAM 角色的权限边界。您可以将 Amazon 托管策略或自定义策略设置为权限边界。

Set-IAMRolePermissionsBoundary -RoleName MyRoleName -PermissionsBoundary arn:aws:iam::123456789012:policy/intern-boundary

以下代码示例演示了如何使用 Set-IAMUserPermissionsBoundary。

适用于 PowerShell V4 的工具

示例 1：此示例展示如何设置用户的权限边界。您可以将 Amazon 托管策略或自定义策略设置为权限边界。

Set-IAMUserPermissionsBoundary -UserName joe -PermissionsBoundary arn:aws:iam::123456789012:policy/intern-boundary

以下代码示例演示了如何使用 Sync-IAMMFADevice。

适用于 PowerShell V4 的工具

示例 1：此示例将与 IAM 用户 Bob 关联且 ARN 为 arn:aws:iam::123456789012:mfa/bob 的 MFA 设备与提供这两个身份验证码的身份验证器程序同步。

Sync-IAMMFADevice -SerialNumber arn:aws:iam::123456789012:mfa/theresa -AuthenticationCode1 123456 -AuthenticationCode2 987654 -UserName Bob

示例 2：此示例将与 IAM 用户 Theresa 关联的 IAM MFA 设备与具有序列号 ABCD12345678 并提供两个身份验证码的物理设备同步。

Sync-IAMMFADevice -SerialNumber ABCD12345678 -AuthenticationCode1 123456 -AuthenticationCode2 987654 -UserName Theresa

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ResyncMfaDevice中的。

以下代码示例演示了如何使用 Unregister-IAMGroupPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例将 ARN 为 arn:aws:iam::123456789012:policy/TesterAccessPolicy 的托管组策略与名为 Testers 的组分离。

Unregister-IAMGroupPolicy -GroupName Testers -PolicyArn arn:aws:iam::123456789012:policy/TesterAccessPolicy

示例 2：此示例查找附加到名为 Testers 的组的所有托管策略，并将其与该组分离。

Get-IAMAttachedGroupPolicies -GroupName Testers | Unregister-IAMGroupPolicy -Groupname Testers

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DetachGroupPolicy中的。

以下代码示例演示了如何使用 Unregister-IAMRolePolicy。

适用于 PowerShell V4 的工具

示例 1：此示例将 ARN 为 arn:aws:iam::123456789012:policy/FederatedTesterAccessPolicy 的托管组策略与名为 FedTesterRole 的角色分离。

Unregister-IAMRolePolicy -RoleName FedTesterRole -PolicyArn arn:aws:iam::123456789012:policy/FederatedTesterAccessPolicy

示例 2：此示例查找附加到名为 FedTesterRole 的角色的所有托管策略，并将其与该角色分离。

Get-IAMAttachedRolePolicyList -RoleName FedTesterRole | Unregister-IAMRolePolicy -Rolename FedTesterRole

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DetachRolePolicy中的。

以下代码示例演示了如何使用 Unregister-IAMUserPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例将 ARN 为 arn:aws:iam::123456789012:policy/TesterPolicy 的托管策略与名为 Bob 的 IAM 用户分离。

Unregister-IAMUserPolicy -UserName Bob -PolicyArn arn:aws:iam::123456789012:policy/TesterPolicy

示例 2：此示例查找附加到名为 Theresa 的 IAM 用户的所有托管策略，并将这些策略与该用户分离。

Get-IAMAttachedUserPolicyList -UserName Theresa | Unregister-IAMUserPolicy -Username Theresa

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DetachUserPolicy中的。

以下代码示例演示了如何使用 Update-IAMAccessKey。

适用于 PowerShell V4 的工具

示例 1：此示例将名为 Bob 的 IAM 用户的访问密钥 AKIAIOSFODNN7EXAMPLE 状态更改为 Inactive。

Update-IAMAccessKey -UserName Bob -AccessKeyId AKIAIOSFODNN7EXAMPLE -Status Inactive

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateAccessKey中的。

以下代码示例演示了如何使用 Update-IAMAccountPasswordPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例使用指定设置更新账户的密码策略。请注意，命令中未包含的任何参数都不会保持不变。相反，这些参数将重置为默认值。

Update-IAMAccountPasswordPolicy -AllowUsersToChangePasswords $true -HardExpiry $false -MaxPasswordAge 90 -MinimumPasswordLength 8 -PasswordReusePrevention 20 -RequireLowercaseCharacters $true -RequireNumbers $true -RequireSymbols $true -RequireUppercaseCharacters $true

以下代码示例演示了如何使用 Update-IAMAssumeRolePolicy。

适用于 PowerShell V4 的工具

示例 1：此示例使用新的信任策略更新名为 ClientRole 的 IAM 角色，其内容来自文件 ClientRolePolicy.json。请注意，必须使用 -Raw 开关参数才能成功处理 JSON 文件的内容。

Update-IAMAssumeRolePolicy -RoleName ClientRole -PolicyDocument (Get-Content -raw ClientRolePolicy.json)

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateAssumeRolePolicy中的。

以下代码示例演示了如何使用 Update-IAMGroup。

适用于 PowerShell V4 的工具

示例 1：此示例将 IAM 组 Testers 重命名为 AppTesters。

Update-IAMGroup -GroupName Testers -NewGroupName AppTesters

示例 2：此示例将 IAM 组 AppTesters 的路径更改为 /Org1/Org2/。这会将该组的 ARN 更改为 arn:aws:iam::123456789012:group/Org1/Org2/AppTesters。

Update-IAMGroup -GroupName AppTesters -NewPath /Org1/Org2/

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateGroup中的。

以下代码示例演示了如何使用 Update-IAMLoginProfile。

适用于 PowerShell V4 的工具

示例 1：此示例为 IAM 用户 Bob 设置了一个新的临时密码，并要求该用户在下次登录时更改密码。

Update-IAMLoginProfile -UserName Bob -Password "P@ssw0rd1234" -PasswordResetRequired $true

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateLoginProfile中的。

以下代码示例演示了如何使用 Update-IAMOpenIDConnectProviderThumbprint。

适用于 PowerShell V4 的工具

示例 1：此示例更新了其 ARN 为 arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com 的 OIDC 提供者的证书指纹列表以使用新指纹。当与提供者关联的证书发生变化时，OIDC 提供者将共享新值。

Update-IAMOpenIDConnectProviderThumbprint -OpenIDConnectProviderArn arn:aws:iam::123456789012:oidc-provider/example.oidcprovider.com -ThumbprintList 7359755EXAMPLEabc3060bce3EXAMPLEec4542a3

以下代码示例演示了如何使用 Update-IAMRole。

适用于 PowerShell V4 的工具

示例 1：此示例更新了角色描述和可以请求的角色会话的最长会话持续时间值（以秒为单位）。

Update-IAMRole -RoleName MyRoleName -Description "My testing role" -MaxSessionDuration 43200

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateRole中的。

以下代码示例演示了如何使用 Update-IAMRoleDescription。

适用于 PowerShell V4 的工具

示例 1：此示例更新了您账户中 IAM 角色的描述。

Update-IAMRoleDescription -RoleName MyRoleName -Description "My testing role"

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateRoleDescription中的。

以下代码示例演示了如何使用 Update-IAMSAMLProvider。

适用于 PowerShell V4 的工具

示例 1 ：此示例使用文件 SAMLMetaData.xml 中的新 SAML 元数据文档更新 ARN 为 arn:aws:iam::123456789012:saml-provider/SAMLADFS 的 IAM 中的 SAML 提供者。请注意，必须使用 -Raw 开关参数才能成功处理 JSON 文件的内容。

Update-IAMSAMLProvider -SAMLProviderArn arn:aws:iam::123456789012:saml-provider/SAMLADFS -SAMLMetadataDocument (Get-Content -Raw SAMLMetaData.xml)

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateSamlProvider中的。

以下代码示例演示了如何使用 Update-IAMServerCertificate。

适用于 PowerShell V4 的工具

示例 1：此示例将名为 MyServerCertificate 的证书重命名为 MyRenamedServerCertificate。

Update-IAMServerCertificate -ServerCertificateName MyServerCertificate -NewServerCertificateName MyRenamedServerCertificate

示例 2：此示例将名为 MyServerCertificate 的证书移动到路径 /Org1/Org2/。这会将该资源的 ARN 更改为 arn:aws:iam::123456789012:server-certificate/Org1/Org2/MyServerCertificate。

Update-IAMServerCertificate -ServerCertificateName MyServerCertificate -NewPath /Org1/Org2/

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateServerCertificate中的。

以下代码示例演示了如何使用 Update-IAMSigningCertificate。

适用于 PowerShell V4 的工具

示例 1：此示例更新了与名为 Bob 且其证书 ID 为 Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU 的 IAM 用户关联的证书，以将其标记为非活动状态。

Update-IAMSigningCertificate -CertificateId Y3EK7RMEXAMPLESV33FCREXAMPLEMJLU -UserName Bob -Status Inactive

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateSigningCertificate中的。

以下代码示例演示了如何使用 Update-IAMUser。

适用于 PowerShell V4 的工具

示例 1：此示例将 IAM 用户 Bob 重命名为 Robert。

Update-IAMUser -UserName Bob -NewUserName Robert

示例 2：此示例将 IAM 用户 Bob 的路径更改为 /Org1/Org2/，这实际上将用户的 ARN 更改为 arn:aws:iam::123456789012:user/Org1/Org2/bob。

Update-IAMUser -UserName Bob -NewPath /Org1/Org2/

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) UpdateUser中的。

以下代码示例演示了如何使用 Write-IAMGroupPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例创建一个名为 AppTesterPolicy 的内联策略并将其嵌入到 IAM 组 AppTesters 中。如果已经存在同名的内联策略，则该策略将被覆盖。JSON 策略内容来自文件 apptesterpolicy.json。请注意，必须使用 -Raw 参数才能成功处理 JSON 文件的内容。

Write-IAMGroupPolicy -GroupName AppTesters -PolicyName AppTesterPolicy -PolicyDocument (Get-Content -Raw apptesterpolicy.json)

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) PutGroupPolicy中的。

以下代码示例演示了如何使用 Write-IAMRolePolicy。

适用于 PowerShell V4 的工具

示例 1：此示例创建一个名为 FedTesterRolePolicy 的内联策略并将其嵌入到 IAM 角色 FedTesterRole 中。如果已经存在同名的内联策略，则该策略将被覆盖。JSON 策略内容来自文件 FedTesterPolicy.json。请注意，必须使用 -Raw 参数才能成功处理 JSON 文件的内容。

Write-IAMRolePolicy -RoleName FedTesterRole -PolicyName FedTesterRolePolicy -PolicyDocument (Get-Content -Raw FedTesterPolicy.json)

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) PutRolePolicy中的。

以下代码示例演示了如何使用 Write-IAMUserPolicy。

适用于 PowerShell V4 的工具

示例 1：此示例创建一个名为 EC2AccessPolicy 的内联策略并将其嵌入到 IAM 用户 Bob 中。如果已经存在同名的内联策略，则该策略将被覆盖。JSON 策略内容来自文件 EC2AccessPolicy.json。请注意，必须使用 -Raw 参数才能成功处理 JSON 文件的内容。

Write-IAMUserPolicy -UserName Bob -PolicyName EC2AccessPolicy -PolicyDocument (Get-Content -Raw EC2AccessPolicy.json)

  • 有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) PutUserPolicy中的。