Appendix 1: Cmdlets in the AWS adapter

IT Asset Management (Cloud)

The connection from IT Asset Management to the AWS EC2 service relies on the AWS Tools for Windows PowerShell (as described in Prerequisites and Setting Up). Within that toolset, the AWS adapter uses the following PowerShell cmdlets:

Note:

* Can only be used with the Direct adapter type

** Can only be used with the AWS Config adapter type

*** Can be used with both the Direct and AWS Config adapter type

  • Get-AWSRegion*** — To identify the available AWS geographic regions where your instances may be running
  • Get-CFGConfigurationAggregatorList** — Returns the details of one or more configuration aggregators
  • Get-EC2Instance* — To return the list of the instances (virtual machines) you own, and then collect summary inventory details on each one
  • Get-EC2Host* — To identify any dedicated hosts you have available in each region
  • Get-EC2ReservedInstance* — To return inventory details on any instance/capacity you have reserved in an Availability Zone
  • Get-IAMAccountAlias* — To return the list of the account alias associated with the Amazon Web Services account
  • Get-IAMAttachedGroupPolicyList* — To return the list of all managed policies that are attached to the specified IAM group
  • Get-IAMAttachedRolePolicyList* — To return the list of all managed policies that are attached to the specified IAM role
  • Get-IAMAttachedUserPolicyList* — To return the list of all managed policies that are attached to the specified IAM user
  • Get-IAMGroupForUser* — To return the list of the IAM groups that the specified IAM user belongs to
  • Get-IAMPolicy* — To retrieve information about the specified managed policy, including the policy's default version and the total number of IAM users, groups, and roles to which the policy is attached
  • Get-IAMPolicyVersion* — To retrieve information about the specified version of the specified managed policy, including the policy document
  • Get-IAMRole* — To retrieve information about the specified role and the role's trust policy that grants permission to assume the role
  • Get-IAMUser* — Used as a test for connection success
  • Get-ORGAccountList** — Lists all the accounts in the organization
  • Get-RDSDBInstance* — To returns information about provisioned RDS instances
  • Get-STSCallerIdentity*** — To return details about the IAM user or role whose credentials are used to call the operation
  • Select-CFGAggregateResourceConfig** — Accepts a structured query language (SQL) SELECT command and an aggregator to query configuration state of Amazon Web Services resources across multiple accounts and regions, performs the corresponding search, and returns resource configurations matching the properties.
  • Set-DefaultAWSRegion*** — To set a default AWS region system name
  • Set-AWSProxy*** — To specify the proxy setting for the following interactions through other cmdlets
  • Use-STSRole* — To return a set of temporary security credentials that you can use to access AWS resources that you might not normally have access to

IT Asset Management (Cloud)

Current