如何使用PowerShell脚本检查指定AWS配置文件是否登录成功

首先明确：单独执行Set-AWSCredentials -ProfileName myProfileName无法直接判断凭证是否有效。该命令仅会将本地配置文件中存储的对应凭证加载到当前PowerShell会话，不会主动向AWS服务端发起校验请求——哪怕配置文件名不存在、凭证已过期、密钥填写错误，执行这行命令时也不会直接抛出错误。

要验证指定profile的登录状态是否有效，需要在加载凭证后，调用AWS STS服务的Get-STSCallerIdentity接口做校验：这个接口是AWS提供的轻量身份校验接口，不需要任何额外业务权限，只要凭证合法就能正常返回当前身份信息，凭证无效时会直接抛出异常，配合try/catch捕获就能实现分支判断。

代码示例 #

# 加载指定配置文件的凭证
Set-AWSCredentials -ProfileName myProfileName

try {
    # 发起身份校验请求，-ErrorAction Stop 确保接口报错会被catch捕获
    $currentCaller = Get-STSCallerIdentity -ErrorAction Stop
    # 以下为登录成功后执行的逻辑
    Write-Host "凭证校验通过，当前身份ARN: $($currentCaller.Arn)"
    
    # 在此处放置需要登录成功才执行的业务代码
    # ...
}
catch {
    # 校验失败时的逻辑，直接跳过成功分支即可
    Write-Host "配置文件登录校验失败，跳过对应业务逻辑，错误信息: $_"
}

注意事项 #

• 不要使用查询S3桶、EC2实例列表这类带业务权限要求的接口做校验：如果凭证本身有效但没有对应业务的访问权限，会被误判为登录失败。Get-STSCallerIdentity是所有合法AWS凭证默认有权限调用的接口，不存在这个问题。
• 调用Get-STSCallerIdentity时可以加上-Region参数指定你后续业务使用的AWS区域，不影响校验结果。
• 如果本地没有安装AWS PowerShell模块，需要先执行Install-Module -Name AWSPowerShell（适用于Windows PowerShell）或者Install-Module -Name AWSPowerShell.NetCore（适用于跨平台PowerShell）安装对应模块才能使用相关命令。

内容的提问来源于stack exchange，提问作者Murendeni Mukwevho