AWS Tools for PowerShell - ユーザーガイド...AWS Tools for PowerShell ユーザーガイド...

AWS Tools for PowerShellユーザーガイド

AWS Tools for PowerShell: ユーザーガイドCopyright © 2020 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

AWS Tools for PowerShell ユーザーガイド

Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's,in any manner that is likely to cause confusion among customers, or in any manner that disparages or discreditsAmazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may notbe affiliated with, connected to, or sponsored by Amazon.


Table of ContentsAWS Tools for PowerShell とは何ですか? .............................................................................................. 1

AWS.Tools ................................................................................................................................ 1AWSPowerShell.NetCore ............................................................................................................. 2AWSPowerShell ......................................................................................................................... 2このガイドの使い方 .................................................................................................................... 3

インストール ..................................................................................................................................... 4前提条件 .................................................................................................................................... 4Windows でのインストール .......................................................................................................... 5

前提条件 ............................................................................................................................ 6AWS.Tools のインストール .................................................................................................. 6AWSPowerShell.NetCore のインストール .............................................................................. 8AWSPowerShell のインストール ........................................................................................... 9スクリプト実行の有効化 ...................................................................................................... 9バージョニング ................................................................................................................. 10AWS Tools for PowerShell の更新 ....................................................................................... 12

Linux または MacOS でのインストール ....................................................................................... 13セットアップの概要 .......................................................................................................... 13前提条件 ............................................................................................................................ 6AWS.Tools のインストール ................................................................................................ 14AWSPowerShell.NetCore のインストール ............................................................................. 16スクリプトの実行 ............................................................................................................... 9PowerShell コンソールの設定 ............................................................................................. 17PowerShell セッションの初期化 .......................................................................................... 17バージョニング ................................................................................................................. 10Linux または macOS での AWS Tools for PowerShell の更新 .................................................. 19関連情報 .......................................................................................................................... 20

AWS Tools for PowerShell バージョン 3.3 からバージョン 4 への移行 .............................................. 20完全にモジュール化された新しい AWS.Tools バージョン ....................................................... 20新しい Get-AWSService コマンドレット ............................................................................ 20コマンドレットから返されるオブジェクトを制御するための新しい -Select パラメータ ............ 21より一貫した方法による出力内の項目数の制限 ...................................................................... 22ストリームパラメータの使用の容易化 .................................................................................. 22プロパティ名によるパイプの拡張 ........................................................................................ 23一般的な静的パラメータ .................................................................................................... 23AWS.Tools による必須パラメータの宣言と適用 ..................................................................... 23すべてのパラメータが NULL を使用可能 .............................................................................. 24以前の非推奨機能の削除 .................................................................................................... 24

AWS アカウントとアクセスキー ................................................................................................. 24アクセスキー ID とシークレットアクセスキーを取得するには ................................................. 24

開始方法 .......................................................................................................................................... 26AWS 認証情報 .......................................................................................................................... 26

認証情報ストアの場所 ....................................................................................................... 26プロファイルの管理 .......................................................................................................... 27認証情報の指定 ................................................................................................................. 28認証情報の検索順序 .......................................................................................................... 30AWS Tools for PowerShell Core での認証情報の処理 ............................................................. 31

認証情報の共有 ......................................................................................................................... 32AWS Tools for PowerShell での IAM ロールの使用 ................................................................ 32認証情報プロファイルタイプの使用 ..................................................................................... 33ProfilesLocation 共通パラメータ .................................................................................. 34認証情報プロファイルの表示 .............................................................................................. 34認証情報プロファイルの削除 .............................................................................................. 35重要な注意点 .................................................................................................................... 35

AWS リージョン ....................................................................................................................... 35

iii


カスタムエンドポイントまたは非標準エンドポイントの指定 ................................................... 36コマンドレットの検出とエイリアス ............................................................................................. 37

コマンドレットの検出 ....................................................................................................... 37コマンドレットの名前付けとエイリアス ............................................................................... 41

パイプライン処理と $AWSHistory ............................................................................................... 43$AWSHistory .................................................................................................................... 44

フェデレーティッド ID の設定 .................................................................................................... 47前提条件 .......................................................................................................................... 47ID フェデレーティッドユーザーが AWS のサービス API にフェデレーティッドアクセスするしくみ ................................................................................................................................ 47AWS Tools for PowerShell での SAML サポートのしくみ ....................................................... 48PowerShell SAML 設定コマンドレットを使用する方法 ........................................................... 49その他の参考資料 .............................................................................................................. 53

AWS Tools for Windows PowerShell の使用 ......................................................................................... 54PowerShell ファイルの連結エンコード ......................................................................................... 54PowerShell ツールに対して返されるオブジェクト ......................................................................... 55Amazon EC2 ............................................................................................................................ 55Amazon S3 .............................................................................................................................. 55AWS Identity and Access Management ........................................................................................ 55AWS Lambda と AWS Lambda Tools for PowerShell .................................................................... 56Amazon SNS と Amazon SQS ................................................................................................... 56CloudWatch ............................................................................................................................ 56以下の資料も参照してください。 ................................................................................................ 56Amazon S3 および Tools for Windows PowerShell ........................................................................ 56

以下の資料も参照してください。 ........................................................................................ 56Amazon S3 バケットの作成、そのリージョンの確認、および必要に応じたバケットの削除 .......... 57Amazon S3 バケットをウェブサイトとして設定し、ログを有効にする ..................................... 58オブジェクトの Amazon S3 バケットへのアップロード .......................................................... 58Amazon S3 オブジェクトとバケットの削除 .......................................................................... 60インラインテキストコンテンツの Amazon S3 へのアップロード .............................................. 61

IAM および Tools for Windows PowerShell ................................................................................... 61新しい IAM ユーザーとグループの作成 ................................................................................ 61IAM ユーザーへの IAM ポリシーの設定 ................................................................................ 62IAM ユーザーの初期パスワードの設定 .................................................................................. 63

Amazon EC2 および Tools for Windows PowerShell ...................................................................... 64キーペアの作成 ................................................................................................................. 64セキュリティグループの作成 .............................................................................................. 66AMI の検索 ...................................................................................................................... 69インスタンスを起動する .................................................................................................... 71

AWS Lambda および AWS Tools for PowerShell ........................................................................... 74前提条件 ............................................................................................................................ 6AWSLambdaPSCore モジュールのインストール ................................................................... 75以下の資料も参照してください。 ........................................................................................ 56

Amazon SQS、Amazon SNS、および Tools for Windows PowerShell ............................................... 75Amazon SQS キューの作成およびキュー ARN の取得 ............................................................ 75Amazon SNS トピックの作成 ............................................................................................. 76SNS トピックへのアクセス許可の付与 ................................................................................. 76キューの SNS トピックへのサブスクライブを行います。 ....................................................... 76アクセス許可の付与 .......................................................................................................... 77結果の確認 ....................................................................................................................... 77

AWS Tools for Windows PowerShell からの CloudWatch ................................................................ 78カスタムメトリクスの CloudWatch ダッシュボードへの発行 ................................................... 78以下の資料も参照してください。 ........................................................................................ 56

セキュリティ .................................................................................................................................... 79データ保護 ............................................................................................................................... 79

データの暗号化 ................................................................................................................. 80Identity and Access Management ................................................................................................ 80

iv


コンプライアンス検証 ............................................................................................................... 81ドキュメント履歴 ............................................................................................................................ 82

v

AWS Tools for PowerShell ユーザーガイドAWS.Tools

AWS Tools for PowerShell とは何ですか?

AWS Tools for PowerShell は、AWS SDK for .NET から公開されている機能に基づいて構築されたPowerShell モジュールのセットです。AWS Tools for PowerShell を使用することにより、PowerShell コマンドラインから AWS リソースに対する操作をスクリプト処理できます。

コマンドレットは、さまざまな AWS サービス HTTP クエリ API を使用して実装されている場合でも、パラメータを指定して結果を処理するための慣用的な PowerShell エクスペリエンスを提供します。たとえば、AWS Tools for PowerShell のコマンドレットは、PowerShell パイプライン処理 — をサポートしています。つまり、コマンドレットで PowerShell オブジェクトの双方向のパイプ処理を行うことができます。

AWS Tools for PowerShell は、AWS Identity and Access Management (IAM) インフラストラクチャのサポートなど、認証情報を処理するための柔軟なオプションを備えています。これらのツールは、IAM ユーザーの認証情報、一時的なセキュリティトークン、IAM ロールとともに使用できます。

AWS Tools for PowerShell は、SDK でサポートされているのと同じサービスおよび AWS リージョンのセットをサポートしています。AWS Tools for PowerShell は、Windows、Linux、macOS オペレーティングシステムを実行するコンピュータにインストールできます。

Note

AWS Tools for PowerShell バージョン 4 は最新のメジャーリリースで、AWS Tools forPowerShell バージョン 3.3 への下位互換性のあるアップデートです。既存のコマンドレットの動作を維持しながら、大幅な機能強化を追加します。新しいバージョンにアップグレードした後も、既存のスクリプトは引き続き動作しますが、アップグレードする前に十分にテストすることをお勧めします。バージョン 4 での変更点の詳細については、「AWS Tools for PowerShell バージョン 3.3 からバージョン 4 への移行 (p. 20)」を参照してください。

AWS Tools for PowerShell は、次の 3 つの異なるパッケージとして利用できます。

• AWS.Tools (p. 1)• AWSPowerShell.NetCore (p. 2)• AWSPowerShell (p. 2)

AWS.Tools - AWS Tools for PowerShell のモジュール化バージョン

このバージョンの AWS Tools for PowerShell は、実稼働環境で PowerShell を実行しているすべてのコンピュータに推奨されるバージョンです。モジュール化されているため、使用するサービスのモジュールのみをダウンロードしてロードする必要があります。これにより、ダウンロード時間とメモリ使用量が削減され、最初に Import-Module を手動で呼び出すことで AWS.Tools コマンドレットの自動インポートが可能になります。

これは AWS Tools for PowerShell の最新バージョンであり、Windows、Linux、macOS など、サポートされているすべてのオペレーティングシステムで実行できます。このパッケージは、1 つのインストールモジュールとして AWS.Tools.Installer、1 つの共通モジュールとして AWS.Tools.Common、および

1

https://www.powershellgallery.com/packages/AWS.Tools.Common

https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWS.Tools.zip

AWS Tools for PowerShell ユーザーガイドAWSPowerShell.NetCore

AWS のサービス別に 1 つのモジュール (AWS.Tools.EC2、AWS.Tools.IAM、AWS.Tools.S3 など) を提供します。

AWS.Tools.Installer モジュールに含まれているコマンドレットでは、AWS のサービス別のモジュールをインストール、更新、および削除できます。このモジュールのコマンドレットを利用することで、使用するモジュールをサポートするために必要なすべての依存モジュールが自動的に取得されます。

AWS.Tools.Common モジュールには、サービス固有ではない設定および認証のコマンドレットが用意されています。コマンドを実行するだけで AWS サービスのコマンドレットを使用できます。PowerShellは、AWS.Tools.Common モジュールおよび実行するコマンドレットの AWS サービスのモジュールを自動的にインポートします。このモジュールは、AWS.Tools.Installer モジュールを使用してサービスモジュールをインストールすると、自動的にインストールされます。

このバージョンの AWS Tools for PowerShell は、以下を実行しているコンピュータにインストールできます。

• Windows、Linux、macOS 上でインストールできる PowerShell Core コア 6.0 以降のバージョン。• .NET フレームワーク 4.7.2 以降を搭載した Windows 上の Windows PowerShell 5.1 以降。

このガイドでは、このバージョンのみを指定する必要がある場合は、モジュール名 AWS.Tools で参照します。

AWSPowerShell.NetCore - AWS Tools forPowerShell の単一モジュール版

このバージョンは、すべての AWS サービスのサポートを含む単一の大きなモジュールで構成されています。このモジュールを使用する前に、手動でインポートする必要があります。

このバージョンの AWS Tools for PowerShell は、以下を実行しているコンピュータにインストールできます。

• Windows、Linux、macOS 上でインストールできる PowerShell Core コア 6.0 以降のバージョン。• .NET フレームワーク 4.7.2 以降を搭載した Windows では、Windows PowerShell 3.0 以降。

このガイドでは、このバージョンのみを指定する必要がある場合は、モジュール名AWSPowerShell.NetCore で参照します。

AWSPowerShell - Windows PowerShell の単一モジュールバージョン

このバージョンの AWS ツールは、Windows PowerShell バージョン 2.0～5.1 を実行している Windows コンピュータのみと互換性があり、インストール可能です。PowerShell Core 6.0 以降や、その他のオペレーティングシステム (Linux または macOS) との互換性はありません。このバージョンは、すべての AWSサービスのサポートを含む単一の大きなモジュールで構成されています。

2

https://www.powershellgallery.com/packages/AWSPowerShell.NetCore/

https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWSPowerShell.NetCore.zip

https://www.powershellgallery.com/packages/AWSPowerShell/

https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWSPowerShell.zip

AWS Tools for PowerShell ユーザーガイドこのガイドの使い方

このガイドでは、このバージョンのみを指定する必要がある場合は、モジュール名 AWSPowerShell で参照します。

このガイドの使い方このガイドは、大きく次のセクションに分かれています。

AWS Tools for PowerShell のインストール (p. 4)

このセクションでは、AWS Tools for PowerShell のインストール方法について説明します。アカウントをお持ちでない場合の AWS のサインアップ方法、およびコマンドレットの実行に使用できる IAMユーザーを作成する方法について説明します。

AWS Tools for Windows PowerShell の使用開始 (p. 26)

このセクションでは、認証情報および AWS リージョンの指定、特定のサービス向けのコマンドレットの検索、コマンドレットのエイリアスの使用など、AWS Tools for PowerShell を使用した基本事項について説明します。

AWS Tools for Windows PowerShell の使用 (p. 54)

このセクションでは、AWS Tools for PowerShell を使用して最も一般的な AWS タスクを実行する方法について説明します。

3

AWS Tools for PowerShell ユーザーガイド前提条件

AWS Tools for PowerShell のインストール

AWS Tools for PowerShell コマンドレットを正しくインストールして使用するには、以下のトピックの手順を参照してください。

トピック• AWS Tools for PowerShell のセットアップの前提条件 (p. 4)• Windows に AWS Tools for PowerShell をインストールする (p. 5)• Linux または MacOS での AWS Tools for PowerShell のインストール (p. 13)• AWS Tools for PowerShell バージョン 3.3 からバージョン 4 への移行 (p. 20)• AWS アカウントとアクセスキー (p. 24)

AWS Tools for PowerShell のセットアップの前提条件

AWS Tools for PowerShell を使用するには、まず次の手順を完了する必要があります。

1.AWS アカウントにサインアップします。

AWS アカウントをお持ちでない場合は、以下のトピックで登録方法の詳細をご覧ください。

https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/2.IAM ユーザーの作成

アカウントにサインアップしたら、AWS Identity and Access Management (IAM) サービスでユーザーを作成する必要があります。各ユーザーには、独自の認証情報およびアクセス許可があります。認証情報は、要求を行うユーザーを認証するために使用されます。アクセス許可によって、そのユーザーに許可される AWS リソースと操作が決まります。

ユーザーの作成は、このトピックの範囲外です。しかし、AWS を初めて使用する場合は、以下を読むことをお勧めします。• ユーザー認証情報とそれらを管理するためのベストプラクティスについては、アマゾンウェブサー

ビス全般のリファレンスの「AWS セキュリティの認証情報」を参照してください。• AWS Tools for PowerShell コマンドの実行に使用できる「管理者」権限を持つユーザを作成するス

テップごとの手順については、IAM ユーザーガイドの「最初の IAM 管理者のユーザーおよびグループの作成」を参照してください。

3.IAM ユーザーのアクセスキーを作成します。

AWS Tools for PowerShell には、各コマンドレットが適切なセキュリティ認証情報を使用して送信される必要があります。これを行うには、通常、AWS Tools for PowerShell コマンドレットを使用する必要があるユーザーごとにアクセスキーを作成する必要があります。アクセスキーは、アクセス

4

https://aws.amazon.com/premiumsupport/knowledge-center/create-and-activate-aws-account/

https://docs.aws.amazon.com/general/latest/gr/aws-security-credentials.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html

AWS Tools for PowerShell ユーザーガイドWindows でのインストール

キー ID とシークレットアクセスキーで構成されます。これらは、AWS サービスに対して行うプログラムによる要求に署名 (認証目的で暗号化) するために使用されます。アクセスキーを持っていない場合は、https://console.aws.amazon.com/iam/ の IAM コンソールを使用して作成できます。「AWSセキュリティの認証情報」で説明されているように、AWS ルートアカウントのアクセスキーではなく、IAM ユーザーのアクセスキーを使用することをお勧めします。IAM を使用すると、AWS アカウント内の AWS サービスやリソースへのアクセスを安全に制御できます。

他の AWS 操作と同様に、アクセスキーを作成するには、関連する IAM アクションを実行する権限が必要です。詳細については、IAM ユーザーガイドの「IAM ID を管理するためのアクセス許可」を参照してください。

AWS コンソールで最初のユーザーのアクセスキーを作成したら、そのユーザーとそのアクセスキーを使用して AWS Tools for PowerShell コマンドレットを実行し、他のユーザーのアクセスキーを作成できます。次の例は、New-IAMAccessKey コマンドレットを使用して、IAM ユーザーのアクセスキーとシークレットキーを作成する方法を示しています。

PS > New-IAMAccessKey -UserName alice

AccessKeyId : AKIAIOSFODNN7EXAMPLECreateDate : 9/4/19 12:46:18 PMSecretAccessKey : wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEYStatus : ActiveUserName : alice

これらの認証情報を安全な場所に保存します。後で AWS Tools for PowerShell 認証情報ファイルを設定するために必要です。詳細については、「AWS 認証情報の使用 (p. 26)」を参照してください。

Important

シークレットアクセスキー (パスワードと同等) を確認できるのは、アクセスキーを作成するときのみです。後で取得することはできません。シークレットキーを紛失した場合は、アクセスキーとシークレットキーのペアを削除して再作成する必要があります。

IAM ユーザーが一度に持つことができるアクセスキーは 2 つのみです。3 つ目のセットを作成しようとすると、New-IAMAccessKey コマンドレットはエラーを返します。もう1 つ作成するには、既存の 2 つのうちの 1 つを削除する必要があります。

IAM ユーザーの認証情報のセットを削除するには、Remove-IAMAccessKey コマンドレットを使用します。UserName および AccessKeyId の両方を指定する必要があります。

PS > Remove-IAMAccessKey -UserName alice -AccessKeyId -AccessKeyId AKIAIOSFODNN7EXAMPLE

ConfirmAre you sure you want to perform this action?Performing the operation "Remove-IAMAccessKey (DeleteAccessKey)" on target "AKIAIOSFODNN7EXAMPLE".[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"): yPS >

Windows に AWS Tools for PowerShell をインストールする

Windows ベースのコンピュータでは、AWS Tools for PowerShell パッケージオプションのいずれかを実行できます。

5

https://console.aws.amazon.com/iam/



https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_delegate-permissions.html

AWS Tools for PowerShell ユーザーガイド前提条件

• AWS.Tools (p. 6) - モジュール化されたバージョンの AWS Tools for PowerShell。AWS の各サービスが、個別の小さなモジュールと、共通のサポートモジュール AWS.Tools.Common およびAWS.Tools.Installer によってサポートされます。

• AWSPowerShell.NetCore (p. 8) - AWS Tools for PowerShell の単一の大型モジュールのバージョン。AWS のすべてのサービスが、この大きな単独モジュールでサポートされます。

• AWSPowerShell (p. 9) - Windows 固有の大きな単独モジュールのレガシーバージョンの AWS Toolsfor PowerShell。AWS のすべてのサービスが、この大きな単独モジュールでサポートされます。

選択するパッケージは、実行している Windows のリリースとエディションによって異なります。Note

Tools for Windows PowerShell (AWSPowerShell モジュール) は、Windows ベースのすべてのAmazon マシンイメージ (AMI) にデフォルトでインストールされています。

AWS Tools for PowerShell のセットアップには、このトピックで詳しく説明する次の大まかなタスクが含まれます。

1. 環境に適した AWS Tools for PowerShell パッケージオプションをインストールします。2. Get-ExecutionPolicy コマンドレットを実行して、スクリプトの実行が有効になっていることを確

認します。3. PowerShell セッションに AWS Tools for PowerShell モジュールをインポートします。

前提条件AWS Tools for PowerShell のセットアップの前提条件 (p. 4) に記載されている要件を満たしていることを確認します。

新しいバージョンの PowerShell (PowerShell Core を含む) は、Microsoft のウェブサイトの「PowerShellのさまざまなバージョンのインストール」からダウンロードできます。

Windows に AWS.Tools をインストールするモジュール化されたバージョンの AWS Tools for PowerShell は、Windows PowerShell 5.1 またはPowerShell Core 6.0 以降を搭載する Windows が実行されているコンピュータにインストールできます。PowerShell Core をインストールする方法については、Microsoft のウェブサイトへの「PowerShell のさまざまなバージョンのインストール」を参照してください。

次の 3 つの方法のいずれかで AWS.Tools をインストールできます。

• AWS.Tools モジュール内のコマンドレットを使用する。この AWS.Tools.Installer モジュールは、他の AWS.Tools モジュールのインストールと更新を簡素化します。AWS.Tools.Installer では、PowerShellGet の更新済みバージョンを必要とし、これを自動的にダウンロードしてインストールします。AWS.Tools.Installer モジュールは自動的にモジュールのバージョンを同期させます。1つのモジュールの新しいバージョンをインストールまたは更新すると、AWS.Tools.Installer 内のコマンドレットによって、他のすべての AWS.Tools モジュールが同じバージョンに自動的に更新されます。

• AWS.Tools.zip からモジュールをダウンロードし、モジュールフォルダの 1 つにそのモジュールを展開する。$Env:PSModulePath 変数の値を出力することで、モジュールフォルダを検出できます。

• 次の手順で説明するように、Install-Module コマンドレットを使用して PowerShell ギャラリーから各サービスモジュールをインストールする。

Install-Module コマンドレットを使用して Windows に AWS.Tools をインストールするには

1. PowerShell セッションを起動します。

6

https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell





AWS Tools for PowerShell ユーザーガイドAWS.Tools のインストール

Note

PowerShell は、実際のタスクで必要とされる場合を除き、昇格されたアクセス許可を持つ管理者として実行しないことをお勧めします。これは、潜在的なセキュリティリスクを避けるためであり、最小限の特権の原則にも反します。

2. モジュール化された AWS.Tools パッケージをインストールするには、次のコマンドを実行します。

PS > Install-Module -Name AWS.Tools.Installer

Untrusted repositoryYou are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from 'PSGallery'?[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): y

リポジトリについて「信頼されていない」という通知を受けた場合は、これをインストールするかどうかを確認するメッセージが表示されます。PowerShell がモジュールをインストールできるようにするには、y を入力します。プロンプトを回避し、リポジトリを信頼せずにモジュールをインストールするには、-Force パラメータを指定してコマンドを実行します。

PS > Install-Module -Name AWS.Tools.Installer -Force

3. Install-AWSToolsModule コマンドレットを利用することで、使用する AWS のサービスごとのモジュールをインストールできるようになりました。たとえば、次のコマンドは IAM モジュールをインストールします。このコマンドは、指定したモジュールの動作に必要な依存モジュールもインストールします。たとえば、最初の AWS.Tools サービスモジュールをインストールすると、AWS.Tools.Common もインストールされます。これは、すべての AWS サービスモジュールに必要な共有モジュールです。また、古いバージョンのモジュールを削除し、他のモジュールを同じ新しいバージョンに更新します。

PS > Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUp Confirm Are you sure you want to perform this action? Performing the operation "Install-AWSToolsModule" on target "AWS Tools version 4.0.0.0". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):

Installing module AWS.Tools.Common version 4.0.0.0 Installing module AWS.Tools.EC2 version 4.0.0.0 Installing module AWS.Tools.Glacier version 4.0.0.0 Installing module AWS.Tools.S3 version 4.0.0.0

Uninstalling AWS.Tools version 3.3.618.0 Uninstalling module AWS.Tools.Glacier Uninstalling module AWS.Tools.S3 Uninstalling module AWS.Tools.SimpleNotificationService Uninstalling module AWS.Tools.SQS Uninstalling module AWS.Tools.Common

Note

Install-AWSToolsModule コマンドレットは、すべての要求されたモジュールをPSGallery という名前の PSRepository (https://www.powershellgallery.com/) からダウンロードし、これを信頼できるソースと見なします。この PSRepository の詳細を参照するには、Get-PSRepository -Name PSGallery コマンドを使用します。

7

https://www.powershellgallery.com/

AWS Tools for PowerShell ユーザーガイドAWSPowerShell.NetCore のインストール

デフォルトでは、このコマンドはモジュールを $home\Documents\PowerShell\Modules フォルダにインストールします。コンピュータのすべてのユーザー用に AWS Tools for PowerShell をインストールするには、管理者として起動した PowerShell セッションで次のコマンドを実行する必要があります。これにより、すべてのユーザーがアクセスできる $env:ProgramFiles\PowerShell\Modules フォルダにモジュールがインストールされます。

PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers

Windows に AWSPowerShell.NetCore をインストールするAWSPowerShell.NetCore は、PowerShell バージョン 3～5.1 または PowerShell Core 6.0 以降を搭載するWindows が実行されているコンピュータにインストールできます。PowerShell Core をインストールする方法については、Microsoft の PowerShell ウェブサイトの「PowerShell のさまざまなバージョンのインストール」を参照してください。

次の 2 つの方法のいずれかで AWSPowerShell.NetCore をインストールできます。

• AWSPowerShell.NetCore.zip からモジュールをダウンロードし、モジュールディレクトリの 1 つにそのモジュールを展開する。$Env:PSModulePath 変数の値を出力することで、モジュールディレクトリを検出できます。

• 次の手順で説明するように、Install-Module コマンドレットを使用して PowerShell ギャラリーからインストールします。

Install-Module コマンドレットを使用して PowerShell ギャラリーから AWSPowerShell.NetCore をインストールするには

PowerShell ギャラリーから AWSPowerShell.NetCore をインストールするには、コンピュータでPowerShell 5.0 以降が実行されているか、PowerShellGet が PowerShell 3 以降で実行されている必要があります。次のコマンドを実行します。

PS > Install-Module -name AWSPowerShell.NetCore

管理者として PowerShell を実行している場合、先述のコマンドはコンピュータ上のすべてのユーザーに対してAWS Tools for PowerShell をインストールします。管理者権限のない標準ユーザーとして PowerShellを実行している場合、同じコマンドは現在のユーザーのみに AWS Tools for PowerShell をインストールします。

現在のユーザーが管理者権限を持っている場合に、そのユーザーに対してのみインストールするには、次のように -Scope CurrentUser パラメータセットを使用してコマンドを実行します。

PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser

通常、PowerShell 3.0 以降のリリースでは、初めてモジュールでコマンドレットを実行したときにモジュールが PowerShell セッションにロードされますが、AWSPowerShell.NetCore モジュールは大きすぎるため、この機能をサポートしていません。代わりに、次のコマンドを実行して、AWSPowerShell.NetCore Core モジュールを PowerShell セッションに明示的にロードする必要があります。

PS > Import-Module AWSPowerShell.NetCore

8




https://www.powershellgallery.com/packages/PowerShellGet

AWS Tools for PowerShell ユーザーガイドAWSPowerShell のインストール

AWSPowerShell.NetCore モジュールを PowerShell セッションに自動的にロードするには、そのコマンドを PowerShell プロファイルに追加します。PowerShell プロファイルの編集の詳細については、MicrosoftPowerShell ドキュメントの「About Profiles」を参照してください。

Windows PowerShell に AWSPowerShell をインストールするAWS Tools for Windows PowerShell は、次の 3 つの方法のいずれかでインストールできます。

• AWSPowerShell.zip からモジュールをダウンロードし、モジュールディレクトリの 1 つにそのモジュールを展開します。$Env:PSModulePath 変数の値を出力することで、モジュールディレクトリを検出できます。

• Tools for Windows PowerShell インストーラを実行する。AWSPowerShell をインストールする方法は非推奨になりました。代わりに Install-Module を使用することをお勧めします。

• 次の手順で説明するように、Install-Module コマンドレットを使用して PowerShell ギャラリーからインストールする。

Install-Module コマンドレットを使用して PowerShell ギャラリーから AWSPowerShell をインストールするには

PowerShell 5.0 以降を実行している場合、または PowerShellGet を PowerShell 3 以降にインストールしている場合は、PowerShell ギャラリーから AWSPowerShell をインストールできます。次のコマンドを実行して、Microsoft の PowerShell ギャラリーから AWSPowerShell をインストールおよび更新できます。

PS > Install-Module -Name AWSPowerShell

AWSPowerShell モジュールを PowerShell セッションに自動的にロードするには、前の import-moduleコマンドレットを PowerShell プロファイルに追加します。PowerShell プロファイルの編集の詳細については、PowerShell ドキュメントの「About Profiles」を参照してください。

Note

すべての Windows ベースの Amazon マシンイメージ (AMI) には、Tools for Windows PowerShellがデフォルトでインストールされています。

スクリプト実行の有効化AWS Tools for PowerShell モジュールをロードするには、PowerShell スクリプトの実行を有効にする必要があります。スクリプトの実行を有効にするには、Set-ExecutionPolicy のポリシーを設定するために RemoteSigned コマンドレットを実行します。詳細については、Microsoft Technet ウェブサイトの「About Execution Policies」を参照してください。

Note

この必要条件は、Windows を実行しているコンピュータのみに適用されます。ExecutionPolicy セキュリティ制限は、他のオペレーティングシステムには存在しません。

スクリプト実行を有効化するには

1. 実行ポリシーを設定するには管理者権限が必要です。管理者権限を持つユーザーとしてログインしていない場合は、管理者として PowerShell セッションを開きます。[スタート] ボタンをクリックし、[すべてのプログラム] を選択します。[アクセサリ] を選択し、[Windows PowerShell] を選択します。[Windows PowerShell] を右クリックして、コンテキストメニューから [管理者として実行] を選択します。

9

https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles

https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWSPowerShell.zip

https://sdk-for-net.amazonwebservices.com/latest/AWSToolsAndSDKForNet.msi

https://www.powershellgallery.com/packages/PowerShellGet

https://www.powershellgallery.com/packages/AWSPowerShell

https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-6

https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies

AWS Tools for PowerShell ユーザーガイドバージョニング

2. コマンドプロンプトで次のコマンドを入力します。

PS > Set-ExecutionPolicy RemoteSigned

Note

64 ビットシステムでは、32 ビットバージョンの PowerShell である Windows PowerShell (x86)でもこれを行う必要があります。

実行ポリシーが正しく設定されていない場合、プロファイルなどのスクリプトを実行しようとすると、次のエラーが表示されます。

File C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 cannot be loaded because the execution of scripts is disabled on this system. Please see "get-help about_signing" for more details.At line:1 char:2+ . <<<< 'C:\Users\username\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1' + CategoryInfo : NotSpecified: (:) [], PSSecurityException + FullyQualifiedErrorId : RuntimeException

Tools for Windows PowerShell インストーラは、AWSPowerShell モジュールが格納されているディレクトリの場所が含まれるように、PSModulePath を自動的に更新します。

PSModulePath には AWS モジュールのディレクトリの場所が含まれているため、Get-Module -ListAvailable コマンドレットによりモジュールが表示されます。

PS > Get-Module -ListAvailable

ModuleType Name ExportedCommands---------- ---- ----------------Manifest AppLocker {}Manifest BitsTransfer {}Manifest PSDiagnostics {}Manifest TroubleshootingPack {}Manifest AWSPowerShell {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...

バージョニング新しい AWS サービスと機能をサポートするために、AWS は AWS Tools for PowerShell の新しいバージョンを定期的にリリースします。インストール済みのツールのバージョンを確認するには、Get-AWSPowerShellVersion コマンドレットを実行します。

PS > Get-AWSPowerShellVersion

AWS Tools for PowerShellVersion 4.0.123.0Copyright 2012-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.

Amazon Web Services SDK for .NETCore Runtime Version 3.3.103.22Copyright 2009-2015 Amazon.com, Inc. or its affiliates. All Rights Reserved.

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/master/CHANGELOG.md

This software includes third party software subject to the following copyrights:- Logging from log4net, Apache License

10

http://msdn.microsoft.com/en-us/library/windows/desktop/dd878326.aspx

https://docs.aws.amazon.com/powershell/latest/reference/items/Get-AWSPowerShellVersion.html



[http://logging.apache.org/log4net/license.html]

また、Get-AWSPowerShellVersion コマンドに -ListServiceVersionInfo パラメータを追加して、現在のツールのバージョンでサポートされる AWS サービスを一覧表示することもできます。モジュール化AWS.Tools.* オプションを使用すると、現在インポートしているモジュールのみが表示されます。

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo

AWS Tools for Windows PowerShellVersion 3.3.96.0Copyright 2012-2017 Amazon.com, Inc. or its affiliates. All Rights Reserved.


Release notes: https://aws.amazon.com/releasenotes/PowerShell

This software includes third party software subject to the following copyrights:- Logging from log4net, Apache License[http://logging.apache.org/log4net/license.html]

Service Noun Prefix Version------- ----------- -------AWS AppStream APS 2016-12-01AWS Batch BAT 2016-08-10AWS Budgets BGT 2016-10-20AWS Certificate Manager ACM 2015-12-08AWS Cloud Directory CDIR 2016-05-10AWS Cloud HSM HSM 2014-05-30AWS CloudFormation CFN 2010-05-15AWS CloudTrail CT 2013-11-01AWS CodeBuild CB 2016-10-06AWS CodeCommit CC 2015-04-13AWS CodeDeploy CD 2014-10-06AWS CodePipeline CP 2015-07-09AWS CodeStar CST 2017-04-19AWS Config CFG 2014-11-12AWS Cost and Usage Report CUR 2017-01-06AWS Data Pipeline DP 2012-10-29AWS Database Migration Service DMS 2016-01-01AWS Device Farm DF 2015-06-23AWS Direct Connect DC 2012-10-25AWS Directory Service DS 2015-04-16AWS Elastic Beanstalk EB 2010-12-01

...

実行中の PowerShell のバージョンを確認するには、「$PSVersionTable」と入力して、$PSVersionTable 自動変数の内容を表示します。

PS > $PSVersionTable

Name Value---- -----PSVersion 6.2.2PSEdition CoreGitCommitId 6.2.2OS Darwin 18.7.0 Darwin Kernel Version 18.7.0: Tue Aug 20 16:57:14 PDT 2019; root:xnu-4903.271.2~2/RELEASE_X86_64Platform UnixPSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}

11


https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6

AWS Tools for PowerShell ユーザーガイドAWS Tools for PowerShell の更新

PSRemotingProtocolVersion 2.3SerializationVersion 1.1.0.1WSManStackVersion 3.0

Windows での AWS Tools for PowerShell の更新AWS Tools for PowerShell の更新バージョンがリリースされると同時に、ローカルで実行しているバージョンを定期的に更新する必要があります。

モジュール化された AWS.Tools の更新AWS.Tools モジュールを最新バージョンにアップグレードするには、次のコマンドを実行します。

PS > Update-AWSToolsModule -CleanUp

このコマンドは、現在インストールされているすべての AWS.Tools モジュールを更新し、正常に更新されると、他のインストール済みバージョンを削除します。

Note

Update-AWSToolsModule コマンドレットは、すべてのモジュールを PSGallery という名前の PSRepository (https://www.powershellgallery.com/) からダウンロードし、これを信頼できるソースと見なします。この PSRepository の詳細を参照するには、Get-PSRepository -Name PSGallery コマンドを使用します。

Tools for PowerShell Core の更新Get-AWSPowerShellVersion コマンドレットを実行して、実行中のバージョンを確認し、これをPowerShell Gallery ウェブサイトにある Tools for Windows PowerShell のバージョンと比較します。2～3週間ごとにチェックすることをお勧めします。新しいコマンドおよび AWS サービスのサポートは、そのサポートのあるバージョンに更新した後にのみ利用できます。

新しいリリースの AWSPowerShell.NetCore をインストールする前に、既存のモジュールをアンインストールしてください。既存のパッケージをアンインストールする前に、開いているすべての PowerShellセッションを閉じます。次のコマンドを実行して、パッケージをアンインストールします。

PS > Uninstall-Module -Name AWSPowerShell.NetCore -AllVersions

パッケージがアンインストールされたら、次のコマンドを実行して、更新されたモジュールをインストールします。

PS > Install-Module -Name AWSPowerShell.NetCore

インストール後、コマンド Import-Module AWSPowerShell.NetCore を実行して、更新されたコマンドレットを PowerShell セッションにロードします。

Tools for Windows PowerShell の更新Get-AWSPowerShellVersion コマンドレットを実行して、実行中のバージョンを確認し、これをPowerShell Gallery ウェブサイトにある Tools for Windows PowerShell のバージョンと比較します。2～3週間ごとにチェックすることをお勧めします。新しいコマンドおよび AWS サービスのサポートは、そのサポートのあるバージョンに更新した後にのみ利用できます。

• Install-Module コマンドレットを使用してインストールした場合は、次のコマンドを実行します。

PS > Uninstall-Module -Name AWSPowerShell -AllVersions

12




AWS Tools for PowerShell ユーザーガイドLinux または MacOS でのインストール

PS > Install-Module -Name AWSPowerShell

• .msi パッケージインストーラを使用してインストールした場合 :1. AWS Tools for Windows PowerShell から最新バージョンの MSI パッケージをダウンロードしま

す。MSI ファイル名に含まれるパッケージのバージョン番号と、Get-AWSPowerShellVersion コマンドレットの実行時に取得したバージョン番号を比較します。

2. ダウンロードバージョンがインストールしたバージョンよりも高い場合は、すべての Tools forWindows PowerShell コンソールを閉じます。

3. ダウンロードした MSI パッケージを実行して、新しいバージョンの Tools for Windows PowerShellをインストールします。

インストール後、Import-Module AWSPowerShell を実行して、更新されたコマンドレットをPowerShell セッションにロードします。または、[スタート] メニューからカスタム AWS Tools forPowerShell コンソールを実行します。

Linux または MacOS での AWS Tools forPowerShell のインストール

このトピックでは、AWS Tools for PowerShell を Linux または macOS にインストールする手順について説明します。

セットアップの概要Linux または macOS コンピュータに AWS Tools for PowerShell をインストールする場合は、次の 2 つのパッケージオプションから選択できます。

• AWS.Tools (p. 14) – モジュール化されたバージョンの AWS Tools for PowerShell。AWS の各サービスが、個別の小さなモジュールと、共通のサポートモジュール AWS.Tools.Common によってサポートされます。

• AWSPowerShell.NetCore (p. 16) – 大きな単独モジュールバージョンの AWS Tools forPowerShell。AWS のすべてのサービスが、この大きな単独モジュールでサポートされます。

Linux または macOS を実行しているコンピュータでこれらのいずれかをセットアップする方法は、このトピックの後半で詳しく説明します。

1. サポートされているシステムに PowerShell Core 6.0 以降をインストールします。2. Microsoft PowerShell Core のインストール後、システムシェルで pwsh を実行して PowerShell を起動

します。3. AWS.Tools または AWSPowerShell.NetCore をインストールします。4. 適切な Import-Module コマンドレットを実行して、モジュールを PowerShell セッションにインポー

トします。5. Initialize-AWSDefaultConfiguration コマンドレットを実行して AWS 認証情報を指定します。

前提条件AWS Tools for PowerShell のセットアップの前提条件 (p. 4) に記載されている要件を満たしていることを確認します。

AWS Tools for PowerShell Core を実行するには、コンピュータで PowerShell Core 6.0 以降が実行されている必要があります。

13

https://aws.amazon.com/powershell/

https://docs.aws.amazon.com/powershell/latest/reference/items/Initialize-AWSDefaultConfiguration.html


• サポートされている Linux バージョンの一覧と、Linux ベースのコンピュータに PowerShell Core 6.0以降をインストールする方法については、マイクロソフトのウェブサイトで「Linux に PowerShellCore をインストールする」を参照してください。一部の Linux ベースのオペレーティングシステム(Arch、Kali、Raspbian など) は、公式にはサポートされていませんが、さまざまなレベルのコミュニティサポートがあります。

• サポートされている macOS バージョンのリストと macOS 10.12 以降に PowerShell Core 6.0 をインストールする方法については、マイクロソフトのウェブサイトの「macOS への PowerShell Core のインストール」を参照してください。

Linux または MacOS への AWS.Tools のインストールモジュール化されたバージョンの AWS Tools for PowerShell は、PowerShell Core 6.0 以降を実行しているコンピュータにインストールできます。PowerShell Core をインストールする方法については、Microsoft の PowerShell ウェブサイトの「PowerShell のさまざまなバージョンのインストール」を参照してください。

次の 3 つの方法のいずれかで AWS.Tools をインストールできます。

• AWS.Tools.Installer モジュール内のコマンドレットを使用する。AWS.Tools.Installerモジュールは、他の AWS.Tools モジュールのインストールと更新を簡素化します。AWS.Tools.Installer は更新バージョンの PowerShellGet を必要とし、これを自動的にダウンロードしてインストールします。また、AWS.Tools.Installer モジュールは自動的にモジュールのバージョンを同期させます。1 つのモジュールの新しいバージョンをインストールまたは更新すると、AWS.Tools.Installer 内のコマンドレットによって、他のすべての AWS.Tools モジュールが同じバージョンに自動的に更新されます。

• AWS.Tools.zip からモジュールをダウンロードし、モジュールディレクトリの 1 つにそのモジュールを展開します。$Env:PSModulePath 変数の値を出力することで、モジュールディレクトリを検出できます。

• 次の手順で説明するように、Install-Module コマンドレットを使用して PowerShell ギャラリーから各サービスモジュールをインストールする。

Install-Module コマンドレットを使用して Linux または macOS に AWS.Tools をインストールするには

1. 次のコマンドを実行して、PowerShell コアセッションを開始します。

$ pwsh

Note

PowerShell は、実際のタスクで必要とされる場合を除き、昇格されたアクセス許可を持つ管理者として実行しないことをお勧めします。これは、潜在的なセキュリティリスクを避けるためであり、最小限の特権の原則にも反します。

2. AWS.Tools.Installer モジュールを使用してモジュール化された AWS.Tools パッケージをインストールするには、次のコマンドを実行します。

PS > Install-Module -Name AWS.Tools.Installer

Untrusted repositoryYou are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from 'PSGallery'?

14

https://docs.microsoft.com/en-us/powershell/scripting/setup/installing-powershell-core-on-linux?view=powershell-6

https://docs.microsoft.com/en-us/powershell/scripting/setup/installing-powershell-core-on-linux?view=powershell-6

https://docs.microsoft.com/en-us/powershell/scripting/setup/installing-powershell-core-on-macos

https://docs.microsoft.com/en-us/powershell/scripting/setup/installing-powershell-core-on-macos




[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): y

リポジトリが「信頼されていない」という通知を受けた場合は、インストールするかどうかを尋ねられます。PowerShell がモジュールをインストールできるようにするには、y を入力します。プロンプトを回避し、リポジトリを信頼せずにモジュールをインストールするには、次のコマンドを実行します。

PS > Install-Module -Name AWS.Tools.Installer -Force

3. これで、使用するサービスごとにモジュールをインストールできます。たとえば、次のコマンドはIAM モジュールをインストールします。このコマンドは、指定したモジュールの動作に必要な依存モジュールもインストールします。たとえば、最初の AWS.Tools サービスモジュールをインストールすると、AWS.Tools.Common もインストールされます。これは、すべての AWS サービスモジュールに必要な共有モジュールです。また、古いバージョンのモジュールを削除し、他のモジュールを同じ新しいバージョンに更新します。

PS > Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUpConfirmAre you sure you want to perform this action? Performing the operation "Install-AWSToolsModule" on target "AWS Tools version 4.0.0.0". [Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):

Installing module AWS.Tools.Common version 4.0.0.0 Installing module AWS.Tools.EC2 version 4.0.0.0 Installing module AWS.Tools.Glacier version 4.0.0.0 Installing module AWS.Tools.S3 version 4.0.0.0

Uninstalling AWS.Tools version 3.3.618.0 Uninstalling module AWS.Tools.Glacier Uninstalling module AWS.Tools.S3 Uninstalling module AWS.Tools.SimpleNotificationService Uninstalling module AWS.Tools.SQS Uninstalling module AWS.Tools.Common

Note

Install-AWSToolsModule コマンドレットは、すべての要求されたモジュールをPSGallery という名前の PSRepository (https://www.powershellgallery.com/) からダウンロードし、このリポジトリを信頼できるソースと見なします。この PSRepository の詳細を参照するには、Get-PSRepository -Name PSGallery コマンドを使用します。

デフォルトでは、これにより、モジュールが $home\Documents\PowerShell\Modules フォルダにインストールされます。コンピュータのすべてのユーザー用に AWS.Tools モジュールをインストールするには、管理者として起動した PowerShell セッションで次のコマンドを実行する必要があります。これにより、すべてのユーザーがアクセスできる $env:ProgramFiles\PowerShell\Modules フォルダにモジュールがインストールされます。

PS > Install-AWSToolsModule -Name AWS.Tools.IdentityManagement -Scope AllUsers

15


AWS Tools for PowerShell ユーザーガイドAWSPowerShell.NetCore のインストール

Linux または MacOS での AWSPowerShell.NetCoreのインストールAWSPowerShell.NetCore の新しいリリースにアップグレードするには、Linux または macOS での AWS Tools for PowerShell の更新 (p. 19) の手順に従います。まず、以前のバージョンのAWSPowerShell.NetCore をアンインストールします。

次の 2 つの方法のいずれかで AWSPowerShell.NetCore をインストールできます。

• AWSPowerShell.NetCore.zip からモジュールをダウンロードし、モジュールディレクトリの 1 つにそのモジュールを展開する。$Env:PSModulePath 変数の値を出力することで、モジュールディレクトリを検出できます。

• 次の手順で説明するように、Install-Module コマンドレットを使用して PowerShell ギャラリーからインストールする。

Install-Module コマンドレットを使用して Linux または macOS に AWSPowerShell.NetCore をインストールするには

次のコマンドを実行して、PowerShell コアセッションを開始します。

$ pwsh

Note

PowerShell を実行するために昇格された管理者権限で sudo pwsh を使用して PowerShell を起動しないことをお勧めします。これは、潜在的なセキュリティリスクを避けるためであり、最小限の特権の原則にも反します。

PowerShell ギャラリーから AWSPowerShell.NetCore 単一モジュールパッケージをインストールするには、次のコマンドを実行します。


Untrusted repositoryYou are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure you want to install the modules from 'PSGallery'?[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "N"): y

リポジトリが「信頼されていない」という通知を受けた場合は、インストールするかどうかを尋ねられます。PowerShell がモジュールをインストールできるようにするには、y を入力します。リポジトリを信頼せずにプロンプトを回避するには、次のコマンドを実行します。

PS > Install-Module -Name AWSPowerShell.NetCore -Force

コンピュータのすべてのユーザーに対して AWS Tools for PowerShell をインストールする場合を除き、このコマンドをルートとして実行する必要はありません。これを行うには、sudo pwsh を使用して開始した PowerShell セッションで、次のコマンドを実行します。

PS > Install-Module -Scope AllUsers -Name AWSPowerShell.NetCore -Force

スクリプトの実行Set-ExecutionPolicy コマンドは、Windows 以外のシステムでは使用できません。Get-ExecutionPolicy は実行できます。これは、Windows 以外のシステムで実行されている PowerShell

16


AWS Tools for PowerShell ユーザーガイドPowerShell コンソールの設定

Core のデフォルトの実行ポリシー設定が Unrestricted であることを示します。詳細については、Microsoft Technet ウェブサイトの「About Execution Policies」を参照してください。

PSModulePath には AWS モジュールのディレクトリの場所が含まれているため、Get-Module -ListAvailable コマンドレットにより、インストール済みのモジュールが表示されます。

AWS.Tools


Directory: /Users/username/.local/share/powershell/Modules

ModuleType Version Name PSEdition ExportedCommands---------- ------- ---- --------- ----------------Binary 3.3.563.1 AWS.Tools.Common Desk {Clear-AWSHistory, Set-AWSHistoryConfiguration, Initialize-AWSDefaultConfiguration, Clear-AWSDefaultConfigurat…

AWSPowerShell.NetCore


Directory: /Users/username/.local/share/powershell/Modules

ModuleType Version Name ExportedCommands---------- ------- ---- ----------------Binary 3.3.563.1 AWSPowerShell.NetCore

AWS Tools for PowerShell Core を使用するための PowerShell コンソールの設定(AWSPowerShell.NetCore のみ)PowerShell Core は、通常、モジュールでコマンドレットを実行するたびにモジュールを自動的にロードします。しかし、これはサイズが大きいため AWSPowerShell.NetCore には機能しません。AWSPowerShell.NetCore コマンドレットの実行を開始するには、まず Import-ModuleAWSPowerShell.NetCore コマンドを実行する必要があります。これは、AWS.Tools モジュール内のコマンドレットには必要ありません。

PowerShell セッションの初期化AWS Tools for PowerShell のインストール後に Linux ベースまたは macOS ベースのシステムでPowerShell を起動する場合は、Initialize-AWSDefaultConfiguration を実行して、使用する AWS アクセスキーを指定する必要があります。Initialize-AWSDefaultConfiguration の詳細については、「AWS 認証情報の使用 (p. 26)」を参照してください。

Note

AWS Tools for PowerShell の以前 (3.3.96.0 より前) のリリースでは、このコマンドレットはInitialize-AWSDefaults という名前でした。

バージョニング新しい AWS サービスと機能をサポートするために、AWS は AWS Tools for PowerShell の新しいバージョンを定期的にリリースします。インストール済みの AWS Tools for PowerShell のバージョンを確認するには、Get-AWSPowerShellVersion コマンドレットを実行します。

17

https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-5.1




PS > Get-AWSPowerShellVersion





現行バージョンのツールでサポートされる AWS のサービスを一覧表示するには、-ListServiceVersionInfo パラメータを Get-AWSPowerShellVersion コマンドレットに追加します。

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo





Service Noun Prefix API Version------- ----------- -----------AWS Amplify AMP 2017-07-25AWS App Mesh AMSH 2019-01-25AWS AppStream APS 2016-12-01AWS AppSync ASYN 2017-07-25AWS Auto Scaling Plans ASP 2018-01-06AWS Batch BAT 2016-08-10AWS Budgets BGT 2016-10-20AWS Certificate Manager ACM 2015-12-08AWS Certificate Manager Private Certificate Authority PCA 2017-08-22AWS Cloud Directory CDIR 2017-01-11AWS Cloud HSM HSM 2014-05-30AWS Cloud HSM V2 HSM2 2017-04-28AWS Cloud9 C9 2017-09-23AWS CloudFormation CFN 2010-05-15AWS CloudTrail CT 2013-11-01AWS CodeBuild CB 2016-10-06AWS CodeCommit CC 2015-04-13

...

実行中の PowerShell のバージョンを確認するには、「$PSVersionTable」と入力して、$PSVersionTable 自動変数の内容を表示します。

PS > $PSVersionTable

18


https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6

AWS Tools for PowerShell ユーザーガイドLinux または macOS での AWS Tools for PowerShell の更新

Name Value---- -----PSVersion 6.2.2PSEdition CoreGitCommitId 6.2.2OS Darwin 18.7.0 Darwin Kernel Version 18.7.0: Tue Aug 20 16:57:14 PDT 2019; root:xnu-4903.271.2~2/RELEASE_X86_64Platform UnixPSCompatibleVersions {1.0, 2.0, 3.0, 4.0…}PSRemotingProtocolVersion 2.3SerializationVersion 1.1.0.1WSManStackVersion 3.0

Linux または macOS での AWS Tools for PowerShellの更新AWS Tools for PowerShell の更新されたバージョンがリリースされると、ローカルで実行しているバージョンを定期的に更新する必要があります。

モジュール化された AWS.Tools を更新します。*AWS.Tools モジュールを最新バージョンにアップグレードするには、次のコマンドを実行します。

PS > Update-AWSToolsModule -CleanUp

このコマンドは、現在インストールされているすべての AWS.Tools モジュールを更新し、正常に更新されたモジュールについては、以前のバージョンを削除します。

Note

Update-AWSToolsModule コマンドレットは、すべてのモジュールを PSGallery という名前の PSRepository (https://www.powershellgallery.com/) からダウンロードし、これを信頼できるソースと見なします。この PSRepository の詳細を参照するには、Get-PSRepository -Name PSGallery コマンドを使用します。

Tools for PowerShell Core の更新Get-AWSPowerShellVersion コマンドレットを実行して、実行中のバージョンを確認し、これをPowerShell Gallery ウェブサイトにある Tools for Windows PowerShell のバージョンと比較します。2～3週間ごとにチェックすることをお勧めします。新しいコマンドおよび AWS サービスのサポートは、そのサポートのあるバージョンに更新した後にのみ利用できます。

新しいリリースの AWSPowerShell.NetCore をインストールする前に、既存のモジュールをアンインストールしてください。既存のパッケージをアンインストールする前に、開いているすべての PowerShellセッションを閉じます。次のコマンドを実行して、パッケージをアンインストールします。

PS > Uninstall-Module -Name AWSPowerShell.NetCore -AllVersions

パッケージがアンインストールされたら、次のコマンドを実行して、更新されたモジュールをインストールします。


インストール後、コマンド Import-Module AWSPowerShell.NetCore を実行して、更新されたコマンドレットを PowerShell セッションにロードします。

19



AWS Tools for PowerShell ユーザーガイド関連情報

関連情報• AWS Tools for Windows PowerShell の開始方法 (p. 26)• AWS Tools for Windows PowerShell の使用 (p. 54)• AWS アカウントとアクセスキー (p. 24)

AWS Tools for PowerShell バージョン 3.3 からバージョン 4 への移行

AWS Tools for PowerShell バージョン 4 は、AWS Tools for PowerShell バージョン 3.3 への下位互換性のあるアップデートです。既存のコマンドレットの動作を維持しながら、大幅な機能強化を追加します。

既存のスクリプトは、新しいバージョンにアップグレードした後も引き続き動作しますが、本番環境をアップグレードする前に十分にテストすることをお勧めします。

このセクションでは、変更点を示し、これらがスクリプトに与える影響について説明します。

完全にモジュール化された新しい AWS.Tools バージョンAWSPowerShell パッケージと AWSPowerShell.NetCore パッケージは「モノリシック」でした。つまり、AWS のすべてのサービスが同一のモジュールでサポートされるため、モジュールサイズが非常に大きく、AWS の新しいサービスや機能が追加されるたびにさらに肥大化します。新しい AWS.Tools パッケージは複数の小さいモジュールに分割されているため、使用する AWS のサービスに必要なモジュールだけをダウンロードしてインストールできます。パッケージには、他のすべてのモジュールと共有される必須の AWS.Tools.Common モジュールと、必要に応じてモジュールのインストール、更新、および削除を簡素化するための AWS.Tools.Installer モジュールが含まれています。

これにより、最初に Import-module を呼び出すことなく、最初の呼び出しでコマンドレットを自動的にインポートできます。ただし、コマンドレットを呼び出す前に、関連付けられた .NET オブジェクトを操作するには、依然として Import-Module を呼び出し、関連する .NET タイプを PowerShell に知らせる必要があります。

たとえば、次のコマンドには Amazon.EC2.Model.Filter への参照があります。このタイプの参照は自動インポートをトリガーできないため、Import-Module を最初に呼び出さないと、コマンドは失敗します。

PS > $filter = [Amazon.EC2.Model.Filter]@{Name="vpc-id";Values="vpc-1234abcd"} InvalidOperation: Unable to find type [Amazon.EC2.Model.Filter].

PS > Import-Module AWS.Tools.EC2PS > $filter = [Amazon.EC2.Model.Filter]@{Name="vpc-id";Values="vpc-1234abcd"}PS > Get-EC2Instance -Filter $filter -Select Reservations.Instances.InstanceId i-0123456789abcdefg i-0123456789hijklmn

新しい Get-AWSService コマンドレットモジュールの AWS.Tools コレクションで AWS のサービス別のモジュールの名前を確認するには、Get-AWSService コマンドレットを使用します。

20

AWS Tools for PowerShell ユーザーガイドコマンドレットから返されるオブジェクトを制御するための新しい -Select パラメータ

PS > Get-AWSService Service : ACMPCA CmdletNounPrefix : PCA ModuleName : AWS.Tools.ACMPCA SDKAssemblyVersion : 3.3.101.56 ServiceName : AWS Certificate Manager Private Certificate Authority

Service : AlexaForBusiness CmdletNounPrefix : ALXB ModuleName : AWS.Tools.AlexaForBusiness SDKAssemblyVersion : 3.3.106.26 ServiceName : Alexa For Business ...

コマンドレットから返されるオブジェクトを制御するための新しい -Select パラメータバージョン 4 のほとんどのコマンドレットは、新しい -Select パラメータをサポートしています。各コマンドレットは、AWS SDK for .NET を使用してユーザーに代わって AWS のサービス API を呼び出します。次に、AWS Tools for PowerShell クライアントは、レスポンスを PowerShell スクリプトで使用可能なオブジェクトに変換し、他のコマンドにパイプします。最終的な PowerShell オブジェクトには、元のレスポンスのフィールドやプロパティが必要以上に多く含まれる場合があります。また、レスポンスのフィールドやプロパティをデフォルト数よりも多くオブジェクトに含めることもできます。-Select パラメータを使用すると、コマンドレットから返される .NET オブジェクトに含める内容を指定できます。

たとえば、Get-S3Object コマンドレットは、Amazon S3 SDK オペレーション ListObjects を呼び出します。このオペレーションは、ListObjectsResponse オブジェクトを返します。ただし、デフォルトでは、Get-S3Object コマンドレットは SDK レスポンスの S3Objects 要素のみを PowerShell ユーザーに返します。次の例では、そのオブジェクトは 2 つの要素を持つ配列です。

PS > Get-S3Object -BucketName mybucket

ETag : "01234567890123456789012345678901111"BucketName : mybucketKey : file1.txtLastModified : 9/30/2019 1:31:40 PMOwner : Amazon.S3.Model.OwnerSize : 568StorageClass : STANDARD

ETag : "01234567890123456789012345678902222"BucketName : mybucketKey : file2.txtLastModified : 7/15/2019 9:36:54 AMOwner : Amazon.S3.Model.OwnerSize : 392StorageClass : STANDARD

AWS Tools for PowerShell バージョン 4 では、SDK API コールから返された完全な .NET レスポンスオブジェクトを返すように -Select * を指定できます。

PS > Get-S3Object -BucketName mybucket -Select * IsTruncated : False NextMarker : S3Objects : {file1.txt, file2.txt} Name : mybucket Prefix : MaxKeys : 1000

21

https://docs.aws.amazon.com/powershell/latest/reference/items/Get-S3Object.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=S3/MS3ListObjectsListObjectsRequest.html

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=S3/MS3ListObjectsListObjectsRequest.h

AWS Tools for PowerShell ユーザーガイドより一貫した方法による出力内の項目数の制限

CommonPrefixes : {} Delimiter :

特定のネストされたプロパティへのパスを指定することもできます。次の例では、S3Objects 配列内の各要素の Key プロパティのみを返します。

PS > Get-S3Object -BucketName mybucket -Select S3Objects.Keyfile1.txtfile2.txt

状況によっては、コマンドレットパラメータを返すと便利です。そのためには、-Select^ParameterName を使用します。この機能は、-PassThru パラメータに代わるものです。このパラメータはまだ使用可能ですが、非推奨です。

PS > Get-S3Object -BucketName mybucket -Select S3Objects.Key |>> Write-S3ObjectTagSet -Select ^Key -BucketName mybucket -Tagging_TagSet @{ Key='key'; Value='value'} file1.txt file2.txt

各コマンドレットの参照トピックは、-Select パラメータをサポートしているかどうかを示します。

より一貫した方法による出力内の項目数の制限以前のバージョンの AWS Tools for PowerShell では、-MaxItems パラメータを使用して、最終出力で返すオブジェクトの最大数を指定しました。

この動作は AWS.Tools から削除されています。

この動作は AWSPowerShell.NetCore および AWSPowerShell で非推奨であり、今後のリリースでこれらのバージョンから削除されます。

基になるサービス API が MaxItems パラメータをサポートしている場合は、依然として使用可能であり、API が指定するとおりに機能します。ただし、コマンドレットの出力で返される項目の数を制限する追加動作はなくなりました。

最終出力で返される項目の数を制限するには、出力を Select-Items コマンドレットにパイプし、-First n パラメータを指定します。n は最終出力に含める項目の最大数です。

PS > Get-S3Object -BucketName mybucket -Select S3Objects.Key | select -first 1*file1.txt

AWS のすべてのサービスで -MaxItems のサポート方法が統一されていたわけではないため、これにより、不整合や予期しない結果が発生しなくなります。また、-MaxItems と新しい -Select (p. 21) パラメータと組み合わせて使用すると、混乱する結果が生じることがあります。

ストリームパラメータの使用の容易化Stream タイプまたは string タイプのパラメータが、string[]、FileInfo、byte[] の各値を受け入れるようになりました。

次のいずれかの例を使用できます。

PS > Invoke-LMFunction -FunctionName MyTestFunction -PayloadStream '{>> "some": "json"

22

https://docs.aws.amazon.com/powershell/latest/reference/

AWS Tools for PowerShell ユーザーガイドプロパティ名によるパイプの拡張

>> }'

PS > Invoke-LMFunction -FunctionName MyTestFunction -PayloadStream (ls .\some.json)

PS > Invoke-LMFunction -FunctionName MyTestFunction -PayloadStream @('{', '"some": "json"', '}')

AWS Tools for PowerShell は、UTF-8 エンコーディングを使用してすべての文字列を byte[] に変換します。

プロパティ名によるパイプの拡張ユーザーエクスペリエンスをより一貫させるために、任意のパラメータにプロパティ名を指定して、パイプライン入力を渡すことができるようになりました。

次の例では、ターゲットコマンドレットのパラメータ名と一致する名前を持つプロパティを持つカスタムオブジェクトを作成します。コマンドレットを実行すると、これらのプロパティが自動的にパラメータとして使用されます。

PS > [pscustomobject] @{ BucketName='myBucket'; Key='file1.txt'; PartNumber=1 } | Get-S3ObjectMetadata

Note

一部のプロパティは、以前のバージョンの AWS Tools for PowerShell でこれをサポートしていました。バージョン 4 では、これをすべてのパラメータで有効にすることで、より一貫させています。

一般的な静的パラメータバージョン 4.0 の AWS Tools for PowerShell で整合性を向上させるために、すべてのパラメータは静的になっています。

以前のバージョンの AWS Tools for PowerShell では、AccessKey、SecretKey、ProfileName、Region などの一般的なパラメータの一部は動的であり、その他すべてのパラメータは静的でした。この場合、PowerShell は動的パラメータの前に静的パラメータをバインドするため、問題が発生する可能性があります。たとえば、次のコマンドを実行したとします。

PS > Get-EC2Region -Region us-west-2

以前のバージョンの PowerShell では、値 us-west-2 が -Region 動的パラメータではなく -RegionName 静的パラメータにバインドされていました。これも、ユーザーの混乱につながる可能性があります。

AWS.Tools による必須パラメータの宣言と適用AWS.Tools.* モジュールは、必須のコマンドレットパラメータを宣言して適用するようになりました。AWS のサービスで API のパラメータが必須であると宣言されると、対応するコマンドレットパラメータを指定していない場合、PowerShell からパラメータを指定するよう求められます。これはAWS.Tools にのみ適用されます。下位互換性を確保するため、これは AWSPowerShell.NetCore やAWSPowerShell には適用されません。

23

https://docs.microsoft.com/dotnet/api/system.management.automation.idynamicparameters

AWS Tools for PowerShell ユーザーガイドすべてのパラメータが NULL を使用可能

すべてのパラメータが NULL を使用可能値タイプパラメータ (数値と日付) に $null に割り当てることができるようになりました。この変更は、既存のスクリプトには影響しません。これにより、必須パラメータを要求するプロンプトをバイパスできます。必須パラメータは、AWS.Tools でのみ要求されます。

バージョン 4 を使用して次の例を実行すると、各必須パラメータに「値」を指定するため、クライアント側の検証は効果的にバイパスされます。ただし、Amazon EC2 API サービスの呼び出しは失敗します。この AWS のサービスでは、当該情報がまだ必要とされるためです。

PS > Get-EC2InstanceAttribute -InstanceId $null -Attribute $nullWARNING: You are passing $null as a value for parameter Attribute which is marked as required.In case you believe this parameter was incorrectly marked as required, report this by opening an issue at https://github.com/aws/aws-tools-for-powershell/issues.WARNING: You are passing $null as a value for parameter InstanceId which is marked as required.In case you believe this parameter was incorrectly marked as required, report this by openingan issue at https://github.com/aws/aws-tools-for-powershell/issues.

Get-EC2InstanceAttribute : The request must contain the parameter instanceId

以前の非推奨機能の削除以下は、以前のリリースの AWS Tools for PowerShell で非推奨であった機能であり、バージョン 4 では削除されています。

• Stop-EC2Instance コマンドレットから -Terminate パラメータを削除しました。代わりにRemove-EC2Instance を使用します。

• Clear-AWSCredential コマンドレットから -ProfileName パラメータを削除しました。代わりにRemove-AWSCredentialProfile を使用します。

• Import-EC2Instance コマンドレットと Import-EC2Volume コマンドレットを削除しました。

AWS アカウントとアクセスキーAWS にアクセスするには、AWS アカウントにサインアップする必要があります。

アクセスキーは、アクセスキー ID とシークレットアクセスキーで構成され、プログラムによる AWS へのリクエストに署名するために使用されます。アクセスキーがない場合は、https://console.aws.amazon.com/iam/ コンソールで IAM を使用して作成することができます。AWS ルートアカウントのアクセスキーの代わりに、IAM のアクセスキーを使用することをお勧めします。IAM を使用すると、AWS アカウントによる AWS サービスとリソースへのアクセスを安全に制御できます。

Note

アクセスキーを作成するには、必要な IAM アクションを実行するためのアクセス許可が必要です。詳細については、IAM ユーザーガイドの「パスワードポリシーと認証情報を管理する IAMユーザーアクセス権限の付与」を参照してください。

アクセスキー ID とシークレットアクセスキーを取得するには1. IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。

24

https://github.com/aws/aws-tools-for-powershell/issues

https://github.com/aws/aws-tools-for-powershell/issues






AWS Tools for PowerShell ユーザーガイドアクセスキー ID とシークレットアクセスキーを取得するには

2. ナビゲーションメニューで [ユーザー] を選択します。3. IAM ユーザー名 (チェックボックスではありません) を選択します。4. [認証情報] タブを開き、次に [アクセスキーの作成] を選択します。5. 新しいアクセスキーを表示するには、[表示] を選択します。認証情報は次のようになります。

• アクセスキー ID: AKIAIOSFODNN7EXAMPLE• シークレットアクセスキー: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

6. キーペアをダウンロードするには、[.csv ファイルのダウンロード] を選択します。キーを含む .csv ファイルを安全な場所に保存します。

Important

• AWS アカウントを保護するためにキーは機密として扱い、メールでは決して送信しないでください。また、所属している組織外にこの情報を公開してはいけません。AWS またはAmazon.com を名乗る人物から問い合わせがあった場合でも、この情報は開示しないでください。Amazon のスタッフまたは関係者がこの情報を尋ねることは決してありません。

• シークレットアクセスキーは、最初にキーペアを作成するときにのみ取得できます。パスワードと同様に、後で取得することはできません。紛失した場合は、新しいキーペアを作成する必要があります。

関連トピック

• IAM とは (IAM ユーザーガイド)• AWS セキュリティ認証情報 (アマゾンウェブサービス全般のリファレンス)

25

https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction.html


AWS Tools for PowerShell ユーザーガイドAWS 認証情報

AWS Tools for Windows PowerShellの使用開始

このセクションでは、Tools for Windows PowerShell の基本的な使用方法について説明します。たとえば、AWS と連係動作する場合に Tools for Windows PowerShell が使用する認証情報と AWS リージョンを指定する方法などを説明します。また、このセクションでは AWS コマンドレットを検出する Get-Command などの標準の PowerShell コマンドレットを使用する方法についても説明します。

トピック• AWS 認証情報の使用 (p. 26)• AWS Tools for PowerShell での認証情報の共有 (p. 32)• AWS リージョンの指定 (p. 35)• コマンドレットの検出とエイリアス (p. 37)• パイプライン処理と $AWSHistory (p. 43)• AWS Tools for PowerShell を使用したフェデレーティッド ID の設定 (p. 47)

AWS 認証情報の使用各 AWS Tools for PowerShell コマンドには AWS 認証情報のセットが含まれている必要があり、これを使用して対応するウェブサービスリクエストが暗号で署名されます。コマンド個別、セッション個別、すべてのセッションに対して認証情報が指定できます。

ベストプラクティスとして、認証情報を公開しないように、コマンドにリテラル認証情報を配置しないでください。代わりに、使用する認証情報セットごとにプロファイルを作成し、このプロファイルを 2 つの認証情報ストアのどちらかに保存します。コマンドで正しいプロファイル名を指定すると、AWS Tools forPowerShell が関連付けられている認証情報を取得します。AWS 認証情報を安全に管理する方法の概要については、アマゾンウェブサービス全般のリファレンスの「AWS アクセスキーを管理するためのベストプラクティス」を参照してください。

Note

認証情報を取得し、AWS Tools for PowerShell を使用するには、AWS アカウントが必要です。アカウントにサインアップする方法については、「AWS アカウントとアクセスキー (p. 24)」を参照してください。

トピック• 認証情報ストアの場所 (p. 26)• プロファイルの管理 (p. 27)• 認証情報の指定 (p. 28)• 認証情報の検索順序 (p. 30)• AWS Tools for PowerShell Core での認証情報の処理 (p. 31)

認証情報ストアの場所AWS Tools for PowerShell では認証情報の保存場所として、2 つのストアのどちらかを使用できます。

• AWS SDK ストアは、認証情報を暗号化してユーザーのホームフォルダに保存します。Windows では、このストアは C:\Users\username\AppData\Local\AWSToolkit\RegisteredAccounts.jsonにあります。

26

https://docs.aws.amazon.com/general/latest/gr/aws-access-keys-best-practices.html


AWS Tools for PowerShell ユーザーガイドプロファイルの管理

AWS SDK for .NET および Toolkit for Visual Studio でも AWS SDK ストアを使用できます。• 共有認証情報ファイルもホームフォルダに配置されますが、認証情報はプレーンテキストとして保存さ

れます。

デフォルトでは次の場所に認証情報ファイルが保存されます。• Windows の場合: C:\Users\username\.aws\credentials• Mac/Linuxの場合: ~/.aws/credentials

AWS SDK と AWS Command Line Interface でも認証情報ファイルが使用できます。AWS ユーザーのコンテキスト外でスクリプトを実行している場合は、認証情報を含むファイルを必ず、すべてのユーザーアカウント (ローカルシステムおよびユーザー) からアクセスできる場所にコピーしてください。

プロファイルの管理プロファイルを使用すると、AWS Tools for PowerShell でさまざまな認証情報セットを参照できます。AWS Tools for PowerShell コマンドレットを使用して、AWS SDK ストア内のプロファイルを管理できます。AWS SDK ストアのプロファイルは、Toolkit for Visual Studio を使用して管理できます。または、AWS SDK for .NET を使用してプログラムで管理することもできます。認証情報ファイルのプロファイルを管理する方法については、「AWS アクセスキーを管理するためのベストプラクティス」を参照してください。

新しいプロファイルの追加AWS SDK ストアに新しいプロファイルを追加するには、コマンド Set-AWSCredential を実行します。アクセスキーとシークレットキーは、指定したプロファイル名の下のデフォルトの認証情報ファイルに保存されます。

PS > Set-AWSCredential ` -AccessKey AKIA0123456787EXAMPLE ` -SecretKey wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY ` -StoreAs MyNewProfile

• -AccessKey – アクセスキー ID。• -SecretKey – シークレットキー。• -StoreAs – プロファイル名。これは一意である必要があります。デフォルトのプロファイルを指定す

るには、名前 default を使用します。

プロファイルの更新AWS SDK ストアは手動で管理する必要があります。IAM コンソールなどで後でサービスの認証情報を変更する場合、ローカルに保存された認証情報を使用してコマンドを実行すると、次のエラーメッセージが表示されて失敗します。

The AWS Access Key Id you provided does not exist in our records.

プロファイルを更新するには、プロファイルに対して Set-AWSCredential コマンドを繰り返し使用して、新しいアクセスキーとシークレットキーをプロファイルに渡します。

プロファイルのリスト表示現在の名前のリストを確認するには、次のコマンドを使用します。この例では、Shirley という名前のユーザーは、共有認証情報ファイル (~/.aws/credentials) に保存されている 3 つのプロファイルにアクセスできます。

27

https://aws.amazon.com/sdk-for-net/

https://aws.amazon.com/visualstudio/

https://docs.aws.amazon.com/AWSToolkitVS/latest/UserGuide/tkv_setup.html



https://console.aws.amazon.com/iam/home

AWS Tools for PowerShell ユーザーガイド認証情報の指定

PS > Get-AWSCredential -ListProfileDetail

ProfileName StoreTypeName ProfileLocation----------- ------------- ---------------default SharedCredentialsFile /Users/shirley/.aws/credentialsproduction SharedCredentialsFile /Users/shirley/.aws/credentialstest SharedCredentialsFile /Users/shirley/.aws/credentials

プロファイルの削除不要になったプロファイルを削除するには、次のコマンドを使用します。

PS > Remove-AWSCredentialProfile -ProfileName an-old-profile-I-do-not-need

-ProfileName パラメータは、削除するプロファイルを指定します。

廃止されたコマンド Clear-AWSCredential は、下位互換性のために引き続き使用できますが、Remove-AWSCredentialProfile を使用することをお勧めします。

認証情報の指定認証情報を指定する方法は複数あります。推奨される方法は、リテラル認証情報をコマンドラインに組み込むのではなく、プロファイルを識別する方法です。AWS Tools for PowerShell は、「認証情報の検索順序 (p. 30)」で説明されている検索順序を使用してプロファイルを検索します。

Windows では、AWS SDK ストアに保存された AWS 認証情報は、ログインした Windows ユーザー ID で暗号化されます。別のアカウントを使用して復号化したり、最初に作成されたデバイスとは異なるデバイスで使用したりすることはできません。たとえば、スケジュールされたタスクを実行する場合など、別のユーザーの認証情報でタスクを実行するには、前のセクションで説明した方法により、そのユーザーとしてコンピュータにログオンする場合に使用する認証情報プロファイルをセットアップします。タスクを実行するユーザーとしてログインして認証情報のセットアップ手順を完了し、そのユーザーに適したプロファイルを作成します。その後、ログアウトし、独自の認証情報を使用して再度ログインし、スケジュールされたタスクを設定します。

Note

共通パラメータ -ProfileName を使用してプロファイルを指定します。このパラメータは、以前の AWS Tools for PowerShell リリースでの -StoredCredentials パラメータに相当します。下位互換性のために、-StoredCredentials も引き続きサポートされています。

デフォルトのプロファイル (推奨)認証情報は、default という名前のプロファイルに保存すると、ローカルコンピュータのすべての AWSSDK と管理ツールで自動的に検索できます。たとえば、ローカルコンピュータに default という名前のプロファイルがある場合、Initialize-AWSDefaultConfiguration コマンドレットまたは Set-AWSCredential コマンドレットを実行する必要はありません。ツールでは、そのプロファイルに保存されているアクセスとシークレットキーのデータが自動的に使用されます。デフォルトリージョン (Get-DefaultAWSRegion の結果) 以外の AWS リージョンを使用する場合は、Set-DefaultAWSRegion を実行してリージョンを指定できます。

プロファイルが default という名前でなくても、現在のセッションでデフォルトプロファイルとして使用したい場合は、Set-AWSCredential を実行してデフォルトプロファイルとして設定します。

Initialize-AWSDefaultConfiguration を実行すると、すべての PowerShell セッションのデフォルトプロファイルを指定できます。この場合、認証情報はカスタム名のプロファイルから読み込まれ、default プロファイルは指定したプロファイルで上書きされます。

28

https://docs.aws.amazon.com/powershell/latest/reference/items/Clear-AWSCredential.html

AWS Tools for PowerShell ユーザーガイド認証情報の指定

Initialize-AWSDefaultConfiguration は実行しないことをお勧めします。ただし、インスタンスプロファイルを使用して起動されていない Amazon EC2 インスタンスで PowerShell セッションを実行している場合と、認証情報プロファイルを手動で設定する場合は除きます。この場合、認証情報プロファイルに認証情報は含まれません。EC2 インスタンスで Initialize-AWSDefaultConfiguration を実行した結果生じる認証情報プロファイルは、認証情報を直接保存するのではなく、インスタンスメタデータ(自動的に更新される一時的な認証情報を提供する) を指します。ただし、インスタンスのリージョンは保存されます。Initialize-AWSDefaultConfiguration を実行する別のシナリオとして、インスタンスが実行されているリージョン以外のリージョンに対して呼び出しを実行する場合があります。そのコマンドを実行すると、インスタンスメタデータに保存されているリージョンは永続的に上書きされます。

PS > Initialize-AWSDefaultConfiguration -ProfileName MyProfileName -Region us-west-2

Note

デフォルトの認証情報は default プロファイル名の下の AWS SDK ストアに含まれています。このコマンドを使用すると、その名前の既存のプロファイルが上書きされます。

EC2 インスタンスの起動にインスタンスプロファイルを使用している場合、PowerShell は AWS認証情報とリージョン情報をインスタンスプロファイルから自動的に取得します。Initialize-AWSDefaultConfiguration を実行する必要はありません。EC2 インスタンスの起動にインスタンスプロファイルを使用している場合、Initialize-AWSDefaultConfiguration コマンドレットの実行は不要です。PowerShell がデフォルトで使用するのと同じインスタンスプロファイルが使用されます。

セッションのプロファイル特定セッションにデフォルトのプロファイルを指定するには、Set-AWSCredential を使用します。このプロファイルはセッション期間中、デフォルトのプロファイルを上書きします。現在の default プロファイルの代わりにカスタム名のプロファイルをセッションで使用する場合は、この方法をお勧めします。

PS > Set-AWSCredential -ProfileName MyProfileName

Note

1.1 より前の Tools for Windows PowerShell バージョンでは、Set-AWSCredential コマンドレットが正しく機能せず、「MyProfileName」で指定したプロファイルが上書きされていました。最新バージョンの Tools for Windows PowerShell を使用することをお勧めします。

コマンドのプロファイル個々のコマンドでは、-ProfileName パラメータを追加して、その 1 つのコマンドだけに適用されるプロファイルを指定できます。このプロファイルは、次の例に示すように、デフォルトプロファイルまたはセッションプロファイルを上書きします。

PS > Get-EC2Instance -ProfileName MyProfileName

Note

デフォルトまたはセッションのプロファイルを指定する場合には、-Region パラメータを追加してデフォルトまたはセッションのリージョンを上書きすることもできます。詳細については、「AWS リージョンの指定 (p. 35)」を参照してください。次の例では、デフォルトのプロファイルとリージョンを指定しています。

PS > Initialize-AWSDefaultConfiguration -ProfileName MyProfileName -Region us-west-2

29

AWS Tools for PowerShell ユーザーガイド認証情報の検索順序

デフォルトでは、AWS 共有認証情報ファイルはユーザーのホームフォルダ (Windows の場合は C:\Users\username\.aws、Linux の場合は ~/.aws) に配置されます。別の場所に認証情報ファイルを指定するには、-ProfileLocation パラメータを含んで、認証情報ファイルのパスを指定します。次の例では、特定のコマンドに対してデフォルト以外の認証情報ファイルを指定しています。

PS > Get-EC2Instance -ProfileName MyProfileName -ProfileLocation C:\aws_service_credentials\credentials

Note

AWS に通常サインインしていない時間帯に PowerShell スクリプトをスケジュールされたタスクとして実行している場合 (通常の作業時間以外で、スケジュールされたタスクとしてPowerShell スクリプトを実行している場合など) は、使用するプロファイルを指定するときに -ProfileLocation パラメータを追加し、その値として認証情報が保存されているファイルのパスを設定します。AWS Tools for PowerShell スクリプトが正しいアカウント認証情報を使用して確実に実行されるようにするには、AWS アカウントを使用しないコンテキストまたはプロセスでスクリプトを実行する場合に必ず -ProfileLocation パラメータを追加する必要があります。スクリプトがタスクを実行するために使用するローカルシステムまたは他のアカウントからアクセス可能な場所に、認証情報ファイルをコピーすることもできます。

認証情報の検索順序コマンドを実行すると、AWS Tools for PowerShell は、次の順序で認証情報を検索します。使用可能な認証情報が見つかると停止します。

1. コマンドラインにパラメータとして埋め込まれているリテラル認証情報。

コマンドラインにリテラル認証情報を入力するのではなく、プロファイルを使用することを強くお勧めします。

2. 指定されたプロファイル名またはプロファイルの場所。• プロファイル名のみを指定した場合、AWS SDK ストアにある指定のプロファイルが検索されます

が、そのようなプロファイルが存在しない場合は、デフォルトの場所にある AWS 共有認証情報ファイルの指定プロファイルが使用されます。

• プロファイルの場所のみを指定した場合、コマンドはその認証情報ファイルから default プロファイルを検索します。

• 名前と場所の両方を指定した場合、コマンドはその認証情報ファイルで指定したプロファイルを検索します。

指定されたプロファイルまたは場所が見つからない場合、このコマンドは例外をスローします。プロファイルとロケーションを両方とも指定しなかった場合のみ、以下の手順で検索が行われます。

3. -Credential パラメータで指定された認証情報。4. セッションプロファイル (存在する場合)。5. 次の順序で、デフォルトのプロファイルを使用します。

a. AWS SDK ストアの default プロファイル。b. AWS 共有認証情報ファイル内の default プロファイル。c. AWS SDK ストアの AWS PS Default プロファイル。

6. IAM ロールを使用するように設定された Amazon EC2 インスタンスでコマンドが実行されている場合、EC2 インスタンスの一時的な認証情報は、インスタンスプロファイルからアクセスされます。

Amazon EC2 インスタンスで IAM ロールを使用する方法については、「AWS SDK for .NET」を参照してください。

この検索により指定された認証情報が検索できなかった場合、このコマンドは例外をスローします。

30


AWS Tools for PowerShell ユーザーガイドAWS Tools for PowerShell Core での認証情報の処理

AWS Tools for PowerShell Core での認証情報の処理AWS Tools for PowerShell Core のコマンドレットは、AWS Tools for Windows PowerShell と同様に、実行時に AWS アクセスキーとシークレットキー、または認証情報プロファイルの名前を受け入れます。Windows で実行すると、どちらのモジュールも AWS SDK for .NET 認証情報ストアファイル (各ユーザーの AppData\Local\AWSToolkit\RegisteredAccounts.json ファイルに保存されています) にアクセスできます。

このファイルにはユーザーのキーが暗号化された形式で保存されていて、別のコンピュータで使用することはできません。これは、AWS Tools for PowerShell が認証情報プロファイルを検索する最初のファイルであり、AWS Tools for PowerShell が認証情報プロファイルを保存するファイルでもあります。AWSSDK for .NET 認証情報ストアファイルの詳細については、「AWS 認証情報の設定」を参照してください。Tools for Windows PowerShell モジュールでは、他のファイルまたは場所への認証情報の書き込みを現在サポートしていません。

どちらのモジュールも、他の AWS SDK および AWS CLI で使用される AWS 共有認証情報ファイルのプロファイルを読み取ることができます。Windows では、このファイルのデフォルトの場所は C:\Users\<userid>\.aws\credentials です。Windows 以外のプラットフォームでは、このファイルは ~/.aws/credentials に保存されています。-ProfileLocation パラメータを使用して、デフォルト以外のファイル名またはファイルの場所を指定することができます。

SDK 認証情報ストアには、Windows 暗号化 API を使用して暗号化された形式の認証情報が保持されています。これらの API は他のプラットフォームでは使用できないため、AWS Tools for PowerShell Core モジュールは、AWS 共有認証情報ファイルを排他的に使用して、共有認証情報ファイルへの新しい認証情報プロファイルの書き込みをサポートします。

以下のスクリプトの例は、Set-AWSCredential コマンドレットを使用して、[AWSPowerShell] または[AWSPowerShell.NetCore] モジュールのいずれかにより Windows で認証情報プロファイルを処理するためのオプションを示しています。

# Writes a new (or updates existing) profile with name "myProfileName"# in the encrypted SDK store file

Set-AWSCredential -AccessKey akey -SecretKey skey -StoreAs myProfileName

# Checks the encrypted SDK credential store for the profile and then# falls back to the shared credentials file in the default location

Set-AWSCredential -ProfileName myProfileName

# Bypasses the encrypted SDK credential store and attempts to load the# profile from the ini-format credentials file "mycredentials" in the# folder C:\MyCustomPath

Set-AWSCredential -ProfileName myProfileName -ProfileLocation C:\MyCustomPath\mycredentials

以下の例は、Linux または Mac OS オペレーティングシステムでの [AWSPowerShell.NetCore] モジュールの動作を示しています。

# Writes a new (or updates existing) profile with name "myProfileName"# in the default shared credentials file ~/.aws/credentials

Set-AWSCredential -AccessKey akey -SecretKey skey -StoreAs myProfileName

# Writes a new (or updates existing) profile with name "myProfileName"# into an ini-format credentials file "~/mycustompath/mycredentials"

Set-AWSCredential -AccessKey akey -SecretKey skey -StoreAs myProfileName -ProfileLocation ~/mycustompath/mycredentials

# Reads the default shared credential file looking for the profile "myProfileName"

31

https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-config-creds.html

AWS Tools for PowerShell ユーザーガイド認証情報の共有

Set-AWSCredential -ProfileName myProfileName

# Reads the specified credential file looking for the profile "myProfileName"

Set-AWSCredential -ProfileName myProfileName -ProfileLocation ~/mycustompath/mycredentials

AWS Tools for PowerShell での認証情報の共有Tools for Windows PowerShell は、AWS CLI および他の AWS SDK と同様に、AWS 共有認証情報ファイルの使用をサポートします。Tools for Windows PowerShell で、.NET 認証情報ファイルおよび AWS 共有認証情報ファイルに対して、basic、session、assume role 認証情報プロファイルの読み書きをサポートするようになりました。この機能は、新しい Amazon.Runtime.CredentialManagement 名前空間で有効になります。

新しいプロファイルタイプと AWS 共有認証情報ファイルへのアクセスは、認証情報に関連するコマンドレットに追加された各パラメータ、Initialize-AWSDefaultConfiguration、New-AWSCredential、Set-AWSCredential でサポートされます。サービスコマンドレットで共通パラメータ -ProfileName を追加すると、新しいプロファイルを参照できます。

AWS Tools for PowerShell での IAM ロールの使用AWS 共有認証情報ファイルを使用すると、追加の種類のアクセスが可能になります。たとえば、IAMユーザーの長期認証情報の代わりに IAM ロールを使用して AWS リソースにアクセスできます。これを行うには、ロールを継承するアクセス許可を持つ標準プロファイルが必要です。ロールを指定したプロファイルを使用するように AWS Tools for PowerShell に指示すると、AWS Tools for PowerShell はSourceProfile パラメータで識別されるプロファイルを検索します。これらの認証情報は、RoleArn パラメータで指定されたロールの一時的な認証情報を要求するために使用されます。ロールが第三者によって継承される場合は、オプションで、多要素認証 (MFA) デバイスまたは ExternalId コードの使用を要求できます。

パラメータ名説明

ExternalId ロールを引き受ける際に使用するユーザー定義の外部 ID (ロールで必要とされる場合)。これは通常、アカウントへのアクセス権を第三者に委任する場合にのみ必要です。第三者は、割り当てられたロールを継承するときに、パラメータとしてExternalId を含める必要があります。詳細については、IAM ユーザーガイドの「AWS リソースへのアクセス権を第三者に付与するときに外部 ID を使用する方法」を参照してください。

MfaSerial ロールを引き受ける際に使用する MFA シリアル番号 (ロールで必要とされる場合)。詳細については、IAM ユーザーガイドの「AWS での多要素認証(MFA) の使用」を参照してください。

RoleArn ロールの継承認証情報を引き受けるロールのARN。ロールの作成と使用の詳細については、IAM ユーザーガイドの「IAM ロール」を参照してください。

SourceProfile ロールの継承認証情報によって使用されるソースプロファイルの名前。このプロファイルで見つ

32


https://docs.aws.amazon.com/powershell/latest/reference/items/New-AWSCredential.html

https://docs.aws.amazon.com/powershell/latest/reference/items/Set-AWSCredential.html


https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html



https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_mfa.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html

AWS Tools for PowerShell ユーザーガイド認証情報プロファイルタイプの使用

パラメータ名説明かった認証情報は、RoleArn パラメータで指定されたロールを継承するために使用されます。

ロールを継承するためのプロファイルの設定次に、IAM ロールを直接継承することができるソースプロファイルを設定する方法の例を示します。

最初のコマンドは、ロールプロファイルが参照するソースプロファイルを作成します。2 番目のコマンドは、継承するロールプロファイルを作成します。3 番目のコマンドは、ロールプロファイルの認証情報を表示します。

PS > Set-AWSCredential -StoreAs my_source_profile -AccessKey access_key_id -SecretKey secret_keyPS > Set-AWSCredential -StoreAs my_role_profile -SourceProfile my_source_profile -RoleArn arn:aws:iam::123456789012:role/role-i-want-to-assumePS > Get-AWSCredential -ProfileName my_role_profile

SourceCredentials RoleArn RoleSessionName Options----------------- ------- --------------- -------Amazon.Runtime.BasicAWSCredentials arn:aws:iam::123456789012:role/role-i-want-to-assume aws-dotnet-sdk-session-636238288466144357 Amazon.Runtime.AssumeRoleAWSCredentialsOptions

このロールプロファイルを Tools for Windows PowerShell サービスコマンドレットで使用するには、ロールプロファイルを参照するコマンドに -ProfileName 共通パラメータを追加します。次の例では、前の例で定義されたロールプロファイルを使用して Get-S3Bucket コマンドレットにアクセスします。AWS Tools for PowerShell は my_source_profile で認証情報を検索し、それらの認証情報を使用してユーザーの代わりに AssumeRole を呼び出し、それらの一時的なロールの認証情報を使用して Get-S3Bucket を呼び出します。

PS > Get-S3Bucket -ProfileName my_role_profile

CreationDate BucketName------------ ----------2/27/2017 8:57:53 AM 4ba3578c-f88f-4d8b-b95f-92a8858dac58-bucket12/27/2017 10:44:37 AM 2091a504-66a9-4d69-8981-aaef812a02c3-bucket2

認証情報プロファイルタイプの使用認証情報プロファイルタイプを設定するには、プロファイルのタイプで必要とされる情報を提供するパラメーターを把握します。

認証情報タイプ使用する必要があるパラメータ

基本

これらは、IAM ユーザーの長期的な認証情報です。

-AccessKey

-SecretKey

セッション:

これらは、Use-STSRole コマンドレットを直接呼び出すなど、手動で取得する IAM ロールの短期的な認証情報です。

-AccessKey

-SecretKey

-SessionToken

33

https://docs.aws.amazon.com/powershell/latest/reference/items/Get-S3Bucket.html

&url-twp-ref;items/Use-STSRole.html

AWS Tools for PowerShell ユーザーガイドProfilesLocation 共通パラメータ

認証情報タイプ使用する必要があるパラメータ

ロール:

これらは、AWS Tools for PowerShell が取得するIAM ロールの短期認証情報です。

-SourceProfile

-RoleArn

オプション : -ExternalId

オプション : -MfaSerial

ProfilesLocation 共通パラメータ-ProfileLocation を使用して共有認証情報ファイルに書き出すことができると同時に、コマンドレットに認証情報ファイルから読み取るよう指示を出すこともできます。-ProfileLocation パラメータを追加することで、共有認証情報ファイルと .NET 認証情報ファイルのどちらを Tools for WindowsPowerShell で使用するかを制御できます。次の表で、Tools for Windows PowerShell でのこのパラメータの動作方法について説明します。

プロファイルの場所の値プロファイルの解決動作

null (未設定) または空最初に、.NET 認証情報ファイル内で指定された名前のプロファイルを検索します。プロファイルが見つからない場合は、(user's homedirectory)\.aws\credentials で AWS 共有認証情報ファイルを検索します。

AWS 共有認証情報ファイル形式のファイルへのパス

指定されたファイルのみを対象に、指定された名前のプロファイルを検索します。

認証情報の認証情報ファイルへの保存2 つの認証情報ファイルのどちらか一方に、認証情報を書き込み、保存するには、Set-AWSCredentialコマンドレットを実行します。次の例は、その方法を示しています。最初のコマンドは、Set-AWSCredential を -ProfileLocation と共に使用して、-ProfileName パラメータで指定されたプロファイルにアクセスキーとシークレットキーを追加します。2 行目では、Get-Content コマンドレットを実行して認証情報ファイルの内容を表示しています。

PS > Set-AWSCredential -ProfileLocation C:\Users\auser\.aws\credentials -ProfileName basic_profile -AccessKey access_key2 -SecretKey secret_key2PS > Get-Content C:\Users\auser\.aws\credentials

aws_access_key_id=access_key2aws_secret_access_key=secret_key2

認証情報プロファイルの表示Get-AWSCredential コマンドレットを実行して、-ListProfileDetail パラメータを追加すると、認証情報ファイルのタイプと場所、プロファイル名のリストが返されます。

PS > Get-AWSCredential -ListProfileDetail

ProfileName StoreTypeName ProfileLocation----------- ------------- ---------------source_profile NetSDKCredentialsFile

34

https://msdn.microsoft.com/en-us/powershell/reference/5.0/microsoft.powershell.management/get-content

https://docs.aws.amazon.com/powershell/latest/reference/items/Get-AWSCredential.html

AWS Tools for PowerShell ユーザーガイド認証情報プロファイルの削除

assume_role_profile NetSDKCredentialsFilebasic_profile SharedCredentialsFile C:\Users\auser\.aws\credentials

認証情報プロファイルの削除認証情報プロファイルを削除するには、新しい Remove-AWSCredentialProfile コマンドレットを実行します。Clear-AWSCredential は廃止されましたが、下位互換性のために引き続き使用できます。

重要な注意点ロールプロファイルのパラメータがサポートされるのは、Initialize-AWSDefaultConfiguration、New-AWSCredential、Set-AWSCredential のみです。Get-S3Bucket -SourceProfilesource_profile_name -RoleArn arn:aws:iam::999999999999:role/role_name などのコマンドでは、ロールパラメータを直接指定することはできません。サービスコマンドレットはSourceProfile または RoleArn パラメータを直接サポートしていないため、これは機能しません。代わりに、これらのパラメータをプロファイルに保存し、-ProfileName パラメータを指定してコマンドを呼び出す必要があります。

AWS リージョンの指定AWS Tools for PowerShell コマンドの実行時に使用する AWS リージョンを指定するには、次の 2 つの方法があります。

• 個々のコマンドで -Region 共通パラメータを使用します。• Set-DefaultAWSRegion コマンドを使用して、すべてのコマンドのデフォルトのリージョンを設定し

ます。

使用するリージョンを Tools for Windows PowerShell が把握できない場合、多くの AWS コマンドレットは失敗します。例外として、Amazon S3 (p. 56)、Amazon SES、AWS Identity and AccessManagement (IAM) (p. 61) のコマンドレットがあります。これらのコマンドレットは、自動的にグローバルエンドポイントに設定されます。

1 つの AWS コマンドに対してリージョンを指定するには

次のような -Region パラメータをコマンドに追加します。

PS > Get-EC2Image -Region us-west-2

現在のセッション内のすべての AWS CLI コマンドにデフォルトのリージョンを設定するには

PowerShell コマンドプロンプトに、次のコマンドを入力します。

PS > Set-DefaultAWSRegion -Region us-west-2

Note

この設定は、現在のセッション中にのみ維持されます。この設定をすべての PowerShell セッションに適用するには、Import-Module コマンドに対して行ったように、このコマンドをPowerShell プロファイルに追加します。

すべての AWS CLI コマンドの現在のデフォルトリージョンを表示するには


PS > Get-DefaultAWSRegion

35

https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-AWSCredentialProfile.html

https://docs.aws.amazon.com/powershell/latest/reference/items/Clear-AWSCredential.html





AWS Tools for PowerShell ユーザーガイドカスタムエンドポイントまたは非標準エンドポイントの指定

Region Name IsShellDefault------ ---- --------------us-west-2 US West (Oregon) True

すべての AWS CLI コマンドの現在のデフォルトリージョンをクリアするには


PS > Clear-DefaultAWSRegion

すべての利用可能な AWS リージョンを一覧表示するには

PowerShell コマンドプロンプトに、次のコマンドを入力します。3 番目の列で、現在のセッションのデフォルトのリージョンがわかります。

PS > Get-AWSRegion

Region Name IsShellDefault------ ---- --------------ap-east-1 Asia Pacific (Hong Kong) Falseap-northeast-1 Asia Pacific (Tokyo) Falseap-northeast-2 Asia Pacific (Seoul) Falseap-south-1 Asia Pacific (Mumbai) Falseap-southeast-1 Asia Pacific (Singapore) Falseap-southeast-2 Asia Pacific (Sydney) Falseca-central-1 Canada (Central) Falseeu-central-1 EU Central (Frankfurt) Falseeu-north-1 EU North (Stockholm) Falseeu-west-1 EU West (Ireland) Falseeu-west-2 EU West (London) Falseeu-west-3 EU West (Paris) Falseme-south-1 Middle East (Bahrain) Falsesa-east-1 South America (Sao Paulo) Falseus-east-1 US East (Virginia) Falseus-east-2 US East (Ohio) Falseus-west-1 US West (N. California) Falseus-west-2 US West (Oregon) True

Note

一部のリージョンはサポートされていても、Get-AWSRegion コマンドレットの結果に含まれていない場合があります。この例として、アジアパシフィック (大阪) リージョン (ap-northeast-3) があります。-Region パラメータを追加してもリージョンを指定できない場合は、次のセクションに示すように、代わりにカスタムエンドポイントでリージョンを指定してみてください。

カスタムエンドポイントまたは非標準エンドポイントの指定次のサンプル形式で、-EndpointUrl 共通パラメータを Tools for Windows PowerShell コマンドに追加して、カスタムエンドポイントを URL として指定します。

PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters

以下は Get-EC2Instance コマンドレットを使用した例です。この例では、カスタムエンドポイントはus-west-2 または米国西部 (オレゴン) リージョンにありますが、他のサポートされている任意の AWSリージョン (Get-AWSRegion で列挙されないリージョンも含む) を使用できます。

36

AWS Tools for PowerShell ユーザーガイドコマンドレットの検出とエイリアス

PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"

コマンドレットの検出とエイリアスこのセクションでは、AWS Tools for PowerShell でサポートされているサービスを一覧表示する方法、これらのサービスをサポートするために AWS Tools for PowerShell から提供されているコマンドレットのセットを表示する方法、これらのサービスにアクセスするための代替のコマンドレット名 (エイリアスとも呼ばれます) を見つける方法について説明します。

コマンドレットの検出すべての AWS サービスオペレーション (または API) は、各サービスの API リファレンスガイドに記載されています。たとえば、「IAM API リファレンス」を参照します。ほとんどの場合、AWS サービスAPI と AWS PowerShell コマンドレット間には 1 対 1 の対応があります。AWS サービスの API 名に対応するコマンドレット名を取得するには、-ApiOperation パラメータと AWS サービスの API 名を指定して AWS Get-AWSCmdletName コマンドレットを呼び出します。たとえば、利用可能なすべてのDescribeInstances AWS サービスの API に基づくすべてのコマンドレット名を取得するには、次のコマンドを実行します。

PS > Get-AWSCmdletName -ApiOperation DescribeInstances

CmdletName ServiceOperation ServiceName CmdletNounPrefix---------- ---------------- ----------- ----------------Get-EC2Instance DescribeInstances Amazon Elastic Compute Cloud EC2Get-GMLInstance DescribeInstances Amazon GameLift Service GMLGet-OPSInstance DescribeInstances AWS OpsWorks OPS

-ApiOperation パラメータはデフォルトのパラメータなので、パラメータ名は省略できます。次の例は、前の例と同等です。

PS > Get-AWSCmdletName DescribeInstances

API とサービスの両方の名前がわかっている場合は、コマンドレット名プレフィックスまたは AWS サービス名の一部と -Service パラメータを含めることができますたとえば、Amazon EC2 のコマンドレット名プレフィックスは EC2 です。Amazon EC2 サービスの DescribeInstances API に対応するコマンドレット名を取得するには、以下のいずれかのコマンドを実行します。どのコマンドでも同じ出力になります。

PS > Get-AWSCmdletName -ApiOperation DescribeInstances -Service EC2PS > Get-AWSCmdletName -ApiOperation DescribeInstances -Service ComputePS > Get-AWSCmdletName -ApiOperation DescribeInstances -Service "Compute Cloud"

CmdletName ServiceOperation ServiceName CmdletNounPrefix---------- ---------------- ----------- ----------------Get-EC2Instance DescribeInstances Amazon Elastic Compute Cloud EC2

これらのコマンドのパラメータ値では、大文字と小文字が区別されません。

使用する AWS サービス API または AWS サービスの名前がわからない場合は、マッチングパターンおよび -MatchWithRegex パラメータとともに -ApiOperation パラメータを使用できます。たとえば、SecurityGroup を含むすべてのコマンドレット名を取得するには、次のコマンドを実行します。

PS > Get-AWSCmdletName -ApiOperation SecurityGroup -MatchWithRegex

37

https://docs.aws.amazon.com/IAM/latest/APIReference/

AWS Tools for PowerShell ユーザーガイドコマンドレットの検出

CmdletName ServiceOperation ServiceName CmdletNounPrefix---------- ---------------- ----------- ----------------Approve-ECCacheSecurityGroupIngress AuthorizeCacheSecurityGroupIngress Amazon ElastiCache ECGet-ECCacheSecurityGroup DescribeCacheSecurityGroups Amazon ElastiCache ECNew-ECCacheSecurityGroup CreateCacheSecurityGroup Amazon ElastiCache ECRemove-ECCacheSecurityGroup DeleteCacheSecurityGroup Amazon ElastiCache ECRevoke-ECCacheSecurityGroupIngress RevokeCacheSecurityGroupIngress Amazon ElastiCache ECAdd-EC2SecurityGroupToClientVpnTargetNetwrk ApplySecurityGroupsToClientVpnTargetNetwork Amazon Elastic Compute Cloud EC2Get-EC2SecurityGroup DescribeSecurityGroups Amazon Elastic Compute Cloud EC2Get-EC2SecurityGroupReference DescribeSecurityGroupReferences Amazon Elastic Compute Cloud EC2Get-EC2StaleSecurityGroup DescribeStaleSecurityGroups Amazon Elastic Compute Cloud EC2Grant-EC2SecurityGroupEgress AuthorizeSecurityGroupEgress Amazon Elastic Compute Cloud EC2Grant-EC2SecurityGroupIngress AuthorizeSecurityGroupIngress Amazon Elastic Compute Cloud EC2New-EC2SecurityGroup CreateSecurityGroup Amazon Elastic Compute Cloud EC2Remove-EC2SecurityGroup DeleteSecurityGroup Amazon Elastic Compute Cloud EC2Revoke-EC2SecurityGroupEgress RevokeSecurityGroupEgress Amazon Elastic Compute Cloud EC2Revoke-EC2SecurityGroupIngress RevokeSecurityGroupIngress Amazon Elastic Compute Cloud EC2Update-EC2SecurityGroupRuleEgressDescription UpdateSecurityGroupRuleDescriptionsEgress Amazon Elastic Compute Cloud EC2Update-EC2SecurityGroupRuleIngressDescription UpdateSecurityGroupRuleDescriptionsIngress Amazon Elastic Compute Cloud EC2Edit-EFSMountTargetSecurityGroup ModifyMountTargetSecurityGroups Amazon Elastic File System EFSGet-EFSMountTargetSecurityGroup DescribeMountTargetSecurityGroups Amazon Elastic File System EFSJoin-ELBSecurityGroupToLoadBalancer ApplySecurityGroupsToLoadBalancer Elastic Load Balancing ELBSet-ELB2SecurityGroup SetSecurityGroups Elastic Load Balancing V2 ELB2Get-EMLInputSecurityGroup DescribeInputSecurityGroup AWS Elemental MediaLive EMLGet-EMLInputSecurityGroupList ListInputSecurityGroups AWS Elemental MediaLive EMLNew-EMLInputSecurityGroup CreateInputSecurityGroup AWS Elemental MediaLive EMLRemove-EMLInputSecurityGroup DeleteInputSecurityGroup AWS Elemental MediaLive EMLUpdate-EMLInputSecurityGroup UpdateInputSecurityGroup AWS Elemental MediaLive EMLEnable-RDSDBSecurityGroupIngress AuthorizeDBSecurityGroupIngress Amazon Relational Database Service RDSGet-RDSDBSecurityGroup DescribeDBSecurityGroups Amazon Relational Database Service RDSNew-RDSDBSecurityGroup CreateDBSecurityGroup Amazon Relational Database Service RDSRemove-RDSDBSecurityGroup DeleteDBSecurityGroup Amazon Relational Database Service RDSRevoke-RDSDBSecurityGroupIngress RevokeDBSecurityGroupIngress Amazon Relational Database Service RDS

38


Approve-RSClusterSecurityGroupIngress AuthorizeClusterSecurityGroupIngress Amazon Redshift RSGet-RSClusterSecurityGroup DescribeClusterSecurityGroups Amazon Redshift RSNew-RSClusterSecurityGroup CreateClusterSecurityGroup Amazon Redshift RSRemove-RSClusterSecurityGroup DeleteClusterSecurityGroup Amazon Redshift RSRevoke-RSClusterSecurityGroupIngress RevokeClusterSecurityGroupIngress Amazon Redshift RS

AWS サービスの名前はわかるが、AWS サービス API の名前がわからない場合は、-MatchWithRegexパラメータと -Service パラメータを追加して、検索範囲を単一のサービスに絞り込みます。たとえば、Amazon EC2 サービス内のみで、SecurityGroup を含むすべてのコマンドレット名を取得するには、次のコマンドを実行します。

PS > Get-AWSCmdletName -ApiOperation SecurityGroup -MatchWithRegex -Service EC2

CmdletName ServiceOperation ServiceName CmdletNounPrefix---------- ---------------- ----------- ----------------Add-EC2SecurityGroupToClientVpnTargetNetwrk ApplySecurityGroupsToClientVpnTargetNetwork Amazon Elastic Compute Cloud EC2Get-EC2SecurityGroup DescribeSecurityGroups Amazon Elastic Compute Cloud EC2Get-EC2SecurityGroupReference DescribeSecurityGroupReferences Amazon Elastic Compute Cloud EC2Get-EC2StaleSecurityGroup DescribeStaleSecurityGroups Amazon Elastic Compute Cloud EC2Grant-EC2SecurityGroupEgress AuthorizeSecurityGroupEgress Amazon Elastic Compute Cloud EC2Grant-EC2SecurityGroupIngress AuthorizeSecurityGroupIngress Amazon Elastic Compute Cloud EC2New-EC2SecurityGroup CreateSecurityGroup Amazon Elastic Compute Cloud EC2Remove-EC2SecurityGroup DeleteSecurityGroup Amazon Elastic Compute Cloud EC2Revoke-EC2SecurityGroupEgress RevokeSecurityGroupEgress Amazon Elastic Compute Cloud EC2Revoke-EC2SecurityGroupIngress RevokeSecurityGroupIngress Amazon Elastic Compute Cloud EC2Update-EC2SecurityGroupRuleEgressDescription UpdateSecurityGroupRuleDescriptionsEgress Amazon Elastic Compute Cloud EC2Update-EC2SecurityGroupRuleIngressDescription UpdateSecurityGroupRuleDescriptionsIngress Amazon Elastic Compute Cloud EC2

AWS Command Line Interface (AWS CLI) コマンドの名前がわかっている場合は、-AwsCliCommand パラメータと希望する AWS CLI コマンド名を使用して、同じ API に基づくコマンドレット名を取得します。たとえば、Amazon EC2 サービスの authorize-security-group-ingress AWS CLI コマンド呼び出しに対応するコマンドレット名を取得するには、次のコマンドを実行します。

PS > Get-AWSCmdletName -AwsCliCommand "aws ec2 authorize-security-group-ingress"

CmdletName ServiceOperation ServiceName CmdletNounPrefix---------- ---------------- ----------- ----------------Grant-EC2SecurityGroupIngress AuthorizeSecurityGroupIngress Amazon Elastic Compute Cloud EC2

39


Get-AWSCmdletName コマンドレットには、サービスと AWS API を特定できる AWS CLI コマンド名の一部を指定すれば十分です。

Tools for PowerShell Core のすべてのコマンドレットを一覧表示するには、次の例に示すようにPowerShell Get-Command コマンドレットを実行します。

PS > Get-Command -Module AWSPowerShell.NetCore

-Module AWSPowerShell で同じコマンドを実行すると、AWS Tools for Windows PowerShell でコマンドレットを確認できます。

Get-Command コマンドレットは、コマンドレットをアルファベット順に一覧表示します。デフォルトでは、リストは PowerShell 名詞ではなく、PowerShell 動詞によってソートされます。

代わりに、サービスによって結果をソートするには、次のコマンドを実行します。

PS > Get-Command -Module AWSPowerShell.NetCore | Sort-Object Noun,Verb

Get-Command コマンドレットから返されたコマンドレットをフィルタリングするには、PowerShell のSelect-String コマンドレットを実行します。たとえば、AWS リージョンを使用するコマンドレットのセットを表示するには、次のコマンドを実行します。

PS > Get-Command -Module AWSPowerShell.NetCore | Select-String region

Clear-DefaultAWSRegionCopy-HSM2BackupToRegionGet-AWSRegionGet-DefaultAWSRegionGet-EC2RegionGet-LSRegionListGet-RDSSourceRegionSet-DefaultAWSRegion

コマンドレット名詞のサービスプレフィックスでフィルタすることで特定のサービスのコマンドレットを見つけることもできます。使用可能なサービスプレフィックスのリストを表示するには、Get-AWSPowerShellVersion -ListServiceVersionInfo を実行します。次の例では、AmazonCloudWatch Events サービスをサポートするコマンドレットが返されます。

PS > Get-Command -Module AWSPowerShell -Noun CWE*

CommandType Name Version Source----------- ---- ------- ------Cmdlet Add-CWEResourceTag 3.3.563.1 AWSPowerShell.NetCoreCmdlet Disable-CWEEventSource 3.3.563.1 AWSPowerShell.NetCoreCmdlet Disable-CWERule 3.3.563.1 AWSPowerShell.NetCoreCmdlet Enable-CWEEventSource 3.3.563.1 AWSPowerShell.NetCoreCmdlet Enable-CWERule 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWEEventBus 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWEEventBusList 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWEEventSource 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWEEventSourceList 3.3.563.1 AWSPowerShell.NetCore

40

AWS Tools for PowerShell ユーザーガイドコマンドレットの名前付けとエイリアス

Cmdlet Get-CWEPartnerEventSource 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWEPartnerEventSourceAccountList 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWEPartnerEventSourceList 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWEResourceTag 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWERule 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWERuleDetail 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWERuleNamesByTarget 3.3.563.1 AWSPowerShell.NetCoreCmdlet Get-CWETargetsByRule 3.3.563.1 AWSPowerShell.NetCoreCmdlet New-CWEEventBus 3.3.563.1 AWSPowerShell.NetCoreCmdlet New-CWEPartnerEventSource 3.3.563.1 AWSPowerShell.NetCoreCmdlet Remove-CWEEventBus 3.3.563.1 AWSPowerShell.NetCoreCmdlet Remove-CWEPartnerEventSource 3.3.563.1 AWSPowerShell.NetCoreCmdlet Remove-CWEPermission 3.3.563.1 AWSPowerShell.NetCoreCmdlet Remove-CWEResourceTag 3.3.563.1 AWSPowerShell.NetCoreCmdlet Remove-CWERule 3.3.563.1 AWSPowerShell.NetCoreCmdlet Remove-CWETarget 3.3.563.1 AWSPowerShell.NetCoreCmdlet Test-CWEEventPattern 3.3.563.1 AWSPowerShell.NetCoreCmdlet Write-CWEEvent 3.3.563.1 AWSPowerShell.NetCoreCmdlet Write-CWEPartnerEvent 3.3.563.1 AWSPowerShell.NetCoreCmdlet Write-CWEPermission 3.3.563.1 AWSPowerShell.NetCoreCmdlet Write-CWERule 3.3.563.1 AWSPowerShell.NetCoreCmdlet Write-CWETarget 3.3.563.1 AWSPowerShell.NetCore

コマンドレットの名前付けとエイリアス各サービスの AWS Tools for PowerShell のコマンドレットは、そのサービスの AWS SDK で提供されているメソッドに基づいています。ただし、PowerShell の必須の命名規則のため、コマンドレットの名前は、それが基づく API コールやメソッドの名前とは異なる場合があります。たとえば、Get-EC2Instance コマンドレットは Amazon EC2DescribeInstances メソッドに基づいています。

コマンドレット名とメソッド名が同じ場合でも、実際に実行される機能は異なることがあります。たとえば、Amazon S3GetObject メソッドは Amazon S3 オブジェクトを取得します。一方、Get-S3Objectコマンドレットは、Amazon S3 オブジェクト自体ではなく、このオブジェクトに関する情報を取得します。

PS > Get-S3Object -BucketName text-content -Key aws-tech-docs

ETag : "df000002a0fe0000f3c000004EXAMPLE"BucketName : aws-tech-docsKey : javascript/frameset.js

41

AWS Tools for PowerShell ユーザーガイドコマンドレットの名前付けとエイリアス

LastModified : 6/13/2011 1:24:18 PMOwner : Amazon.S3.Model.OwnerSize : 512StorageClass : STANDARD

AWS Tools for PowerShell を使用して S3 オブジェクトを取得するには、Read-S3Object コマンドレットを実行します。

PS > Read-S3Object -BucketName text-content -Key text-object.txt -file c:\tmp\text-object-download.text

Mode LastWriteTime Length Name---- ------------- ------ -----a--- 11/5/2012 7:29 PM 20622 text-object-download.text

Note

AWS コマンドレットのコマンドレットヘルプには、コマンドレットが基づく AWS SDK API の名前が記載されています。標準の PowerShell 動詞とその意味の詳細については、「Approved Verbs for PowerShellCommands」を参照してください。

Remove 動詞を使用するすべての AWS コマンドレットおよび -Terminate パラメータの追加時の Stop-EC2Instance コマンドレットでは、処理を続行する前に確認プロンプトが表示されます。確認を省略するには、コマンドに -Force パラメータを追加します。

Important

AWS コマンドレットでは、-WhatIf スイッチはサポートされていません。

エイリアスAWS Tools for PowerShell のセットアップでは、多くの AWS コマンドレットのエイリアスが格納されたエイリアスファイルがインストールされます。これらのエイリアスは、コマンドレット名よりも直感的で理解しやすい場合があります。たとえば、一部のエイリアスでは、サービス名と AWS SDK メソッド名によって PowerShell の動詞と名詞が置き換えられます。例として EC2-DescribeInstances エイリアスがあります。

また、標準の PowerShell 命名規則には従わないものの、実際のオペレーションよりもわかりやすい動詞を使用するエイリアスもあります。たとえば、エイリアスファイルでは、エイリアス Get-S3Content がコマンドレット Read-S3Object に対応付けられています。

PS > Set-Alias -Name Get-S3Content -Value Read-S3Object

エイリアスファイルは、AWS Tools for PowerShell インストールディレクトリにあります。使用環境にエイリアスをロードするには、ドットソース形式でファイルを読み込みます。以下は、Windows ベースの例です。

PS > . "C:\Program Files (x86)\AWS Tools\PowerShell\AWSPowershell\AWSAliases.ps1"

Linux または macOS シェルの場合、次のようになります。

. ~/.local/share/powershell/Modules/AWSPowerShell.NetCore/3.3.563.1/AWSAliases.ps1

すべての AWS Tools for PowerShell エイリアスを表示するには、次のコマンドを実行します。このコマンドは、PowerShell Where-Object コマンドレットの ? エイリアスと Source プロパティを使用して、AWSPowerShell.NetCore モジュールからのエイリアスのみをフィルタリングします。

42

https://docs.microsoft.com/en-us/powershell/developer/cmdlet/approved-verbs-for-windows-powershell-commands

https://docs.microsoft.com/en-us/powershell/developer/cmdlet/approved-verbs-for-windows-powershell-commands

AWS Tools for PowerShell ユーザーガイドパイプライン処理と $AWSHistory

PS > Get-Alias | ? Source -like "AWSPowerShell.NetCore"

CommandType Name Version Source----------- ---- ------- ------Alias Add-ASInstances 3.3.343.0 AWSPowerShellAlias Add-CTTag 3.3.343.0 AWSPowerShellAlias Add-DPTags 3.3.343.0 AWSPowerShellAlias Add-DSIpRoutes 3.3.343.0 AWSPowerShellAlias Add-ELBTags 3.3.343.0 AWSPowerShellAlias Add-EMRTag 3.3.343.0 AWSPowerShellAlias Add-ESTag 3.3.343.0 AWSPowerShellAlias Add-MLTag 3.3.343.0 AWSPowerShellAlias Clear-AWSCredentials 3.3.343.0 AWSPowerShellAlias Clear-AWSDefaults 3.3.343.0 AWSPowerShellAlias Dismount-ASInstances 3.3.343.0 AWSPowerShellAlias Edit-EC2Hosts 3.3.343.0 AWSPowerShellAlias Edit-RSClusterIamRoles 3.3.343.0 AWSPowerShellAlias Enable-ORGAllFeatures 3.3.343.0 AWSPowerShellAlias Find-CTEvents 3.3.343.0 AWSPowerShellAlias Get-ASACases 3.3.343.0 AWSPowerShellAlias Get-ASAccountLimits 3.3.343.0 AWSPowerShellAlias Get-ASACommunications 3.3.343.0 AWSPowerShellAlias Get-ASAServices 3.3.343.0 AWSPowerShellAlias Get-ASASeverityLevels 3.3.343.0 AWSPowerShellAlias Get-ASATrustedAdvisorCheckRefreshStatuses 3.3.343.0 AWSPowerShellAlias Get-ASATrustedAdvisorChecks 3.3.343.0 AWSPowerShellAlias Get-ASATrustedAdvisorCheckSummaries 3.3.343.0 AWSPowerShellAlias Get-ASLifecycleHooks 3.3.343.0 AWSPowerShellAlias Get-ASLifecycleHookTypes 3.3.343.0 AWSPowerShellAlias Get-AWSCredentials 3.3.343.0 AWSPowerShellAlias Get-CDApplications 3.3.343.0 AWSPowerShellAlias Get-CDDeployments 3.3.343.0 AWSPowerShellAlias Get-CFCloudFrontOriginAccessIdentities 3.3.343.0 AWSPowerShellAlias Get-CFDistributions 3.3.343.0 AWSPowerShellAlias Get-CFGConfigRules 3.3.343.0 AWSPowerShellAlias Get-CFGConfigurationRecorders 3.3.343.0 AWSPowerShellAlias Get-CFGDeliveryChannels 3.3.343.0 AWSPowerShellAlias Get-CFInvalidations 3.3.343.0 AWSPowerShellAlias Get-CFNAccountLimits 3.3.343.0 AWSPowerShellAlias Get-CFNStackEvents 3.3.343.0 AWSPowerShell

...

このファイルに独自のエイリアスを追加するには、必要に応じて PowerShell の $MaximumAliasCountユーザー設定変数の値を 5500 より大きい値に引き上げます。デフォルト値は 4096 であり、これを最大32768 まで引き上げることができます。これを行うには、次のコマンドを実行します。

PS > $MaximumAliasCount = 32768

変更が正常に行われたことを確認するには、変数名を入力して現在の値を表示します。

PS > $MaximumAliasCount32768

パイプライン処理と $AWSHistoryコレクションを返す AWS サービス呼び出しで、コレクション内のオブジェクトはパイプラインに列挙されます。コレクションに含まれておらず、ページング制御フィールドではない追加フィールドを含む

43

https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_preference_variables?view=powershell-6

AWS Tools for PowerShell ユーザーガイド$AWSHistory

結果オブジェクトでは、これらのフィールドが呼出しの Note プロパティとして追加されます。これらのNote プロパティは、新しい $AWSHistory セッション変数に記録されるため、必要に応じて参照できます。$AWSHistory 変数については、次のセクションで説明します。

Note

v1.1 より前のバージョンの Tools for Windows PowerShell では、コレクションオブジェクト自体を出力していました。そのため、パイプライン処理を続行するには、foreach{$_.getenumerator()} を使用する必要がありました。

例

次の例では、各リージョンの AWS リージョンと Amazon EC2 マシンイメージ (AMI) のリストが返されます。

PS > Get-AWSRegion | % { Echo $_.Name; Get-EC2Image -Owner self -Region $_ }

次の例では、現在のデフォルトのリージョン内のすべての Amazon EC2 インスタンスが停止されます。

PS > Get-EC2Instance | Stop-EC2Instance

コレクションはパイプラインに列挙されるため、指定されたコマンドレットの出力は、$null、単一のオブジェクト、コレクションのいずれかである可能性があります。出力がコレクションの場合は、.Countプロパティを使用してコレクションのサイズを決定できます。ただし、単一のオブジェクトのみが送信される場合、.Count プロパティは存在しません。スクリプトが、送信されたオブジェクトの数を一貫した方法で判断する必要がある場合は、$AWSHistory で最後のコマンド値の EmittedObjectsCount プロパティを確認します。

$AWSHistoryパイプライン処理のサポートを改善するために、送信されたコレクションオブジェクトにサービスの応答および結果インスタンスを Note プロパティとして含めるための、AWS コマンドレットからの出力はリシェイプされません。代わりに、出力として単一のコレクションを送信する呼び出しについては、コレクションが PowerShell パイプラインに列挙されるようになりました。つまり、AWS SDK の応答および結果データをアタッチできるコレクションオブジェクトを格納できないため、これらのデータはパイプ内に存在できなくなります。

ほとんどのユーザーはこれらのデータを必要としませんが、コマンドレットによって呼び出された下層のAWS サービスとの間で送受信されたデータを詳細に確認できるため、診断目的には有用です。

バージョン 1.1 より、これらのデータを $AWSHistory という名前の新しいシェル変数として参照できるようになりました。この変数には、AWS コマンドレット呼び出しと、呼び出しごとに受信したサービス応答の記録が格納されます。必要に応じて、この履歴を、各コマンドレットによって行われたサービスリクエストを記録するように設定することもできます。コマンドレット全体の実行時間といった、その他の有益なデータを各エントリから取得することもできます。

$AWSHistory.Commands リスト内の各エントリの型は AWSCmdletHistory です。この型には、以下の有用なメンバーが含まれています。

CmdletName

コマンドレットの名前。CmdletStart

コマンドレットが実行された日時。

44


CmdletEnd

コマンドレットがすべての処理を終了した日時。リクエスト

リクエストの記録が有効になっている場合の最後のサービスリクエストのリスト。レスポンス

受信した最後のサービス応答のリスト。LastServiceResponse

最新のサービス応答を返すためのヘルパー。LastServiceRequest

最新のサービスリクエストを返すためのヘルパー (使用可能な場合)。

サービス呼び出しを実行する AWS コマンドレットが使用されるまで、$AWSHistory 変数は作成されません。それまでは $null に評価されます。

Note

旧バージョンの Tools for Windows PowerShell では、サービス応答に関連するデータを、返されたオブジェクトの Note プロパティとして出力していました。これらのデータは、リスト内の呼び出しごとに記録される応答エントリとして残されるようになりました。

Set-AWSHistoryConfigurationコマンドレットの呼び出しは、ゼロ個以上のサービスリクエストとサービス応答のエントリを保持できます。メモリの消費量を抑えるため、$AWSHistory リストには、デフォルトで、最新の 5 つのコマンドレットの実行記録のみが保持され、それぞれについて、最新の 5 つのサービス応答 (および、有効化されている場合は、最新の 5つのサービスリクエスト) のみが保持されます。これらのデフォルトの制限値は、Set-AWSHistoryConfiguration コマンドレットを実行することで変更できます。このコマンドレットを使用すると、リストのサイズ、およびサービスリクエストを記録するかどうかの両方を制御できます。

PS > Set-AWSHistoryConfiguration -MaxCmdletHistory <value> -MaxServiceCallHistory <value> -RecordServiceRequests

-MaxCmdletHistory パラメータには、いつでも追跡可能なコマンドレットの最大数を設定します。0 を設定すると、AWS コマンドレットアクティビティの記録がオフになります。-MaxServiceCallHistory パラメータには、各コマンドレットについて追跡されるサービス応答 (またはサービスリクエスト) の最大数を設定します。-RecordServiceRequests パラメータを指定すると、各コマンドレットのサービスリクエストの追跡が有効になります。すべてのパラメーターは省略可能です。

パラメータを一切指定せずに実行すると、Set-AWSHistoryConfiguration は単純に以前のリクエストの記録はすべてオフにして、現在のリストサイズを維持します。

現在の履歴内のすべてのエントリをクリアするには、Clear-AWSHistory コマンドレットを実行します。

$AWSHistory 例リストに保持されている AWS コマンドレットの詳細をパイプラインに列挙します。

45


PS > $AWSHistory.Commands

実行された最後の AWS コマンドレットの詳細にアクセスします。

PS > $AWSHistory.LastCommand

最後に実行された AWS コマンドレットによって受信された最後のサービス応答の詳細にアクセスします。出力をページングしている AWS コマンドレットでは、複数のサービス呼び出しを起動して、すべてのデータまたは最大量のデータ (どちらになるかはコマンドレットに与えられたパラメーターによって決まる) を取得します。

PS > $AWSHistory.LastServiceResponse

最後に行われたリクエストの詳細にアクセスします (この場合も、コマンドレットがユーザーのためにページングを行っている場合、コマンドレットは複数のリクエストを起動することがあります)。サービスリクエストのトレースが有効になっていない場合は、$null を出力します。

PS > $AWSHistory.LastServiceRequest

複数ページを返す操作のページ自動完成任意の呼び出しに対してデフォルトで最大オブジェクト返却数を課すサービス API、またはページング可能な結果セットをサポートしているサービス API では、すべてのコマンドレットがデフォルトでページを最後まで完成させます。各コマンドレットは、ユーザーに代わってパイプラインに完全なデータセットを返すために、必要な数だけ呼び出しを実行します。

次の例では、Get-S3Object を使用しています。$c 変数には、test バケット内のすべてのキーのS3Object インスタンスが格納されます (したがって、非常に大きなデータセットになる可能性があります)。

PS > $c = Get-S3Object -BucketName test

返されるデータ量をコントロールする必要がある場合は、個々のコマンドレットにパラメータ (Get-S3Object の MaxKey など) を指定できます。または、自身でページングを明示的に処理することもできます。この処理には、コマンドレットの各種ページングパラメータを組み合わせて使用し、$AWSHistory変数に格納されたデータを使用してサービスの次のトークンデータを取得します。次の例では、MaxKeysパラメータを使用して、返される S3Object インスタンスの数を、バケット内に見つかった最初の 500 個以下に制限しています。

PS > $c = Get-S3Object -BucketName test -MaxKey 500

まだ返されていない使用可能なデータが残っているかどうかを確認するには、コマンドレットによって行われたサービス呼び出しを記録した $AWSHistory セッション変数エントリを使用します。

次の式が $true に評価される場合は、$AWSHistory.LastServiceResponse.NextMarker を使用して、次の結果セットの next マーカーを見つけることができます。

$AWSHistory.LastServiceResponse -ne $null && $AWSHistory.LastServiceResponse.IsTruncated

Get-S3Object を使用して手動でページングを制御するには、コマンドレットの MaxKey パラメータとMarker パラメータを組み合わせて指定し、最後に記録された応答の IsTruncated/NextMarker メモを

46

AWS Tools for PowerShell ユーザーガイドフェデレーティッド ID の設定

使用します。次の例では、変数 $c に、バケットの指定されたキープレフィックスマーカーの開始後に見つかった次の 500 個のオブジェクトについて、最大 500 個の S3Object インスタンスが格納されます。

PS > $c = Get-S3Object -BucketName test -MaxKey 500 -Marker $AWSHistory.LastServiceResponse.NextMarker

AWS Tools for PowerShell を使用したフェデレーティッド ID の設定

組織のユーザーが AWS リソースにアクセスできるようにするには、セキュリティ、監査性、コンプライアンス、ロールとアカウントの分離のサポートという目的で、標準の繰り返し可能な認証方法を設定する必要があります。ユーザーに AWS API へのアクセス機能を提供するのが一般的ですが、フェデレーティッド API アクセスがない場合、AWS Identity and Access Management (IAM) ユーザーも作成する必要があり、フェデレーションを使用する意味がなくなります。このトピックでは、AWS Tools forPowerShell での SAML (Security Assertion Markup Language) のサポートについて説明します。このサポートにより、フェデレーティッドアクセスソリューションが簡単になります。

AWS Tools for PowerShell の SAML サポートを使用すると、ユーザーに AWS サービスへのフェデレーティッドアクセスを提供できます。SAML は、サービス間、特に ID プロバイダ (Active Directory フェデレーションサービスなど) とサービスプロバイダ (AWS など) の間でユーザーの認証と許可のデータを転送するための XML ベースのオープンスタンダード形式です。SAML とそのしくみの詳細については、Wikipedia の SAML、または Organization for the Advancement of Structured Information Standards(OASIS) ウェブサイトの SAML 技術仕様を参照してください。AWS Tools for PowerShell での SAML サポートは SAML 2.0 と互換性があります。

前提条件初めて SAML サポートを使用する前に、次の項目を用意しておく必要があります。

• 組織の認証情報のみを使用して、コンソールにアクセスするために AWS アカウントと正常に統合されたフェデレーティッド ID ソリューション。Active Directory フェデレーションサービスに対してこれを行う方法については、IAM ユーザーガイドの「SAML 2.0 ベースのフェデレーションについて」とブログの投稿「Enabling Federation to AWS Using Windows Active Directory, AD FS, and SAML 2.0」を参照してください。このブログの投稿では AD FS 2.0 について説明していますが、AD FS 3.0 を実行している場合でも手順は似ています。

• ローカルワークステーションにインストールされた AWS Tools for PowerShell のバージョン 3.1.31.0 以降。

ID フェデレーティッドユーザーが AWS のサービスAPI にフェデレーティッドアクセスするしくみ次のプロセスは、AWS リソースにアクセスするために Active Directory (AD) ユーザーが AD FS によってフェデレーションされるプロセスの概要を示しています。

47

http://technet.microsoft.com/library/bb897402.aspx

http://technet.microsoft.com/library/bb897402.aspx

https://en.wikipedia.org/wiki/Security_Assertion_Markup_Language

http://saml.xml.org/saml-specifications

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_providers_saml.html

http://aws.amazon.com/blogs/security/enabling-federation-to-aws-using-windows-active-directory-adfs-and-saml-2-0/

AWS Tools for PowerShell ユーザーガイドAWS Tools for PowerShell での SAML サポートのしくみ

1. フェデレーティッドユーザーのコンピュータ上のクライアントは、AD FS に対して認証されます。2. 認証が成功すると、AD FS はユーザーに SAML アサーションを送信します。3. ユーザーのクライアントは、SAML フェデレーション要求の一部として SAML アサーションを AWS

Security Token Service (STS) に送信します。4. STS は、ユーザーが継承できるロールの一時的な AWS 認証情報を含む SAML レスポンスを返します。5. ユーザーは、AWS Tools for PowerShell によるリクエストに一時的な認証情報を含めることによっ

て、AWS サービス API にアクセスします。

AWS Tools for PowerShell での SAML サポートのしくみこのセクションでは、AWS Tools for PowerShell コマンドレットを使用してユーザーの SAML ベースの IDフェデレーションの設定を有効にする方法を説明します。

48

AWS Tools for PowerShell ユーザーガイドPowerShell SAML 設定コマンドレットを使用する方法

1. AWS Tools for PowerShell は、Windows ユーザーの現在の認証情報を使用して、または、AWS に呼び出すために認証情報を必要とするコマンドレットが実行されたときはインタラクティブに、AD FS に対して認証を行います。

2. AD FS がユーザーを認証します。3. AD FS は、アサーションを含む SAML 2.0 認証応答を生成します。アサーションの目的は、ユーザーに

関する情報を識別して提供することです。AWS Tools for PowerShell は、SAML アサーションからユーザーの許可されたロールのリストを抽出します。

4. AWS Tools for PowerShell は、AssumeRoleWithSAMLRequest API コールを行って、リクエストされたロールの Amazon リソースネーム (ARN) などの SAML リクエストを STS に転送します。

5. SAML リクエストが有効な場合、STS は、AWSAccessKeyId、SecretAccessKey、SessionToken を含んだレスポンスを返します。これらの認証情報は 3,600 秒 (1 時間) 有効です。

6. これにより、ユーザーに、ユーザーのロールでアクセスを許可されている AWS サービス API を操作するための有効な認証情報が付与されます。AWS Tools for PowerShell は、これらの認証情報を後続のAWS API 呼び出しに自動的に適用し、有効期限が切れると自動的に更新します。

Note

認証情報の有効期限が切れ、新しい認証情報が必要になると、AWS Tools for PowerShell は自動的に AD FS と再認証を行い、次の 1 時間用の新しい認証情報を取得します。ドメイン結合されたアカウントのユーザーの場合、このプロセスはサイレントに行われます。ドメイン結合されていないアカウントの場合、ユーザーは、再認証のために認証情報を入力するようにAWS Tools for PowerShell によって指示されます。

PowerShell SAML 設定コマンドレットを使用する方法AWS Tools for PowerShell には、SAML サポートを提供する新しい 2 つのコマンドレットが含まれます。

• Set-AWSSamlEndpoint は、AD FS エンドポイントを設定し、エンドポイントにわかりやすい名前を割り当て、必要に応じて、エンドポイントの認証タイプを説明します。

• Set-AWSSamlRoleProfile は、AD FS エンドポイントと関連付ける必要があるユーザーアカウントのプロファイルを作成または編集します。このエンドポイントは、Set-AWSSamlEndpoint コマンド

49


レットにわかりやすい名前を指定することで識別されます。各ロールプロファイルは、ユーザーが実行を許可されている 1 つのロールにマップします。

AWS 認証情報プロファイルと同様、ロールプロファイルにわかりやすい名前を割り当てます。Set-AWSCredential コマンドレットと同じわかりやすい名前を使用するか、AWS のサービス API を呼び出すコマンドレットの -ProfileName パラメータの値として使用できます。

新しい AWS Tools for PowerShell セッションを開きます。PowerShell 3.0 以降を実行している場合、そのコマンドレットのいずれかを実行すると、AWS Tools for PowerShell モジュールが自動的にインポートされます。PowerShell 2.0 を実行している場合は、次の例に示すように、「Import-Module」コマンドレットを実行して、モジュールを手動でインポートする必要があります。

PS > Import-Module "C:\Program Files (x86)\AWS Tools\PowerShell\AWSPowerShell\AWSPowerShell.psd1"

Set-AWSSamlEndpoint と Set-AWSSamlRoleProfile コマンドレットを実行する方法1. まず、AD FS システムのエンドポイント設定を行います。最も簡単な方法は、次の手順に示すように、

変数にエンドポイントを保存する方法です。必ず、プレースホルダーアカウント ID と AD FS ホスト名を自分のアカウント ID と AD FS ホスト名に置き換えます。Endpoint パラメータに AD FS ホスト名を指定します。

PS > $endpoint = "https://adfs.example.com/adfs/ls/IdpInitiatedSignOn.aspx?loginToRp=urn:amazon:webservices"

2. エンドポイント設定を作成するには、Set-AWSSamlEndpoint パラメータに正しい値を指定して、AuthenticationType コマンドレットを実行します。有効な値には、Basic、Digest、Kerberos、Negotiate、および NTLM があります。このパラメータを指定しない場合、デフォルト値は Kerberos になります。

PS > $epName = Set-AWSSamlEndpoint -Endpoint $endpoint -StoreAs ADFS-Demo -AuthenticationType NTLM

コマンドレットは、-StoreAs パラメータを使用して割り当てたわかりやすい名前を返すため、次の行で Set-AWSSamlRoleProfile を実行するときにその名前を使用できます。

3. 次に、Set-AWSSamlRoleProfile コマンドレットを実行して、AD FS ID プロバイダとの認証を行い、ユーザーに実行が許可されている一連のロールを (SAML アサーションで) 取得します。

Set-AWSSamlRoleProfile コマンドレットは、返された一連のロールを使用して、指定のプロファイルに関連付けるロールを選択するようにユーザーに指示するか、パラメータに指定されたロールのデータが存在することを確認します (存在しない場合、ユーザーに選択するように指示します)。ユーザーに許可されたロールが 1 つのみの場合、コマンドレットは、ユーザーに指示することなく、ロールをプロファイルに自動的に割り当てます。ドメイン結合用途にプロファイルを設定するために認証情報を提供する必要はありません。

PS > Set-AWSSamlRoleProfile -StoreAs SAMLDemoProfile -EndpointName $epName

または、ドメイン結合されていないアカウントの場合、次の行に示すように、Active Directory 認証情報を提供し、ユーザーにアクセス権がある AWS ロールを選択できます。これは、別の Active Directoryユーザーアカウントが存在する場合に、組織内のロールを区別するときに役立ちます (たとえば、管理機能)。

50


PS > $credential = Get-Credential -Message "Enter the domain credentials for the endpoint"PS > Set-AWSSamlRoleProfile -EndpointName $epName -NetworkCredential $credential -StoreAs SAMLDemoProfile

4. どちらの場合も、Set-AWSSamlRoleProfile コマンドレットはプロファイルに保存するロールを選択するように指示します。次の例は、2 つの使用可能なロール ADFS-Dev および ADFS-Productionを示しています。IAM ロールは、AD FS 管理者によって AD ログイン認証情報に関連付けられます。

Select RoleSelect the role to be assumed when this profile is active[1] 1 - ADFS-Dev [2] 2 - ADFS-Production [?] Help (default is "1"):

または、RoleARN、PrincipalARN、オプションの NetworkCredential パラメータを入力して、プロンプトを表示せずにロールを指定することもできます。指定されたロールが認証によって返されたアサーションにリストされていない場合、ユーザーは使用可能なロールから選択するよう求められます。

PS > $params = @{ "NetworkCredential"=$credential, "PrincipalARN"="{arn:aws:iam::012345678912:saml-provider/ADFS}", "RoleARN"="{arn:aws:iam::012345678912:role/ADFS-Dev}"}PS > $epName | Set-AWSSamlRoleProfile @params -StoreAs SAMLDemoProfile1 -Verbose

5. 次のコードに示すように、StoreAllRoles パラメータを追加することで、1 つのコマンドですべてのロールのプロファイルを作成できます。ロール名はプロファイル名として使用されます。

PS > Set-AWSSamlRoleProfile -EndpointName $epName -StoreAllRolesADFS-DevADFS-Production

ロールプロファイルを使用して、AWS 認証情報を必要とするコマンドレットを実行する方法AWS 認証情報を必要とするコマンドレットを実行するには、AWS 共有認証情報ファイルで定義されたロールプロファイルを使用できます。ロールプロファイルの名前を Set-AWSCredential に (または、AWS Tools for PowerShell の任意の ProfileName パラメータの値として) 指定して、プロファイルに記述されているロールの一時的な AWS 認証情報を自動的に取得します。

使用するのは一度に 1 つのロールプロファイルですが、シェルセッション内でプロファイルを切り替えることができます。Set-AWSCredential コマンドレットは、単独で実行した場合、認証を行わず、認証情報を取得しません。コマンドレットは、指定したロールプロファイルの使用をユーザーが希望していることを記録します。AWS 認証情報を必要とするコマンドレットを実行するまで、認証または認証情報のリクエストは行われません。

これで、SAMLDemoProfile プロファイルを使用して取得した一時的な AWS 認証情報を使用して、AWSのサービス API を使用できるようになります。次のセクションでは、ロールプロファイルの使用方法の例を示します。

例 1: Set-AWSCredential でデフォルトロールを設定するこの例では、Set-AWSCredential を使用して、AWS Tools for PowerShell セッションのデフォルトロールを設定します。次に、認証情報を必要とするコマンドレットを実行できます。これにより、指定されたロールによって権限が付与されます。この例では、Set-AWSCredential コマンドレットで指定したプロファイルに関連付けられている、米国西部 (オレゴン) リージョンのすべての Amazon Elastic ComputeCloud インスタンスを一覧表示します。

51


PS > Set-AWSCredential -ProfileName SAMLDemoProfilePS > Get-EC2Instance -Region us-west-2 | Format-Table -Property Instances,GroupNames

Instances GroupNames--------- ----------{TestInstance1} {default}{TestInstance2} {}{TestInstance3} {launch-wizard-6}{TestInstance4} {default}{TestInstance5} {}{TestInstance6} {AWS-OpsWorks-Default-Server}

例 2: PowerShell セッション中にロールプロファイルを変更するこの例では、SAMLDemoProfile プロファイルに関連付けられているロールの AWS アカウントで、使用可能なすべての Amazon S3 バケットを一覧表示します。この例では、AWS Tools for PowerShellセッションで別のプロファイルを使用していた場合でも、それをサポートするコマンドレットで -ProfileName パラメータに別の値を指定することで、プロファイルを変更できることを示しています。これは、PowerShell コマンドラインから Amazon S3 を管理している管理者の一般的なタスクです。

PS > Get-S3Bucket -ProfileName SAMLDemoProfile

CreationDate BucketName------------ ----------7/25/2013 3:16:56 AM mybucket14/15/2015 12:46:50 AM mybucket24/15/2015 6:15:53 AM mybucket31/12/2015 11:20:16 PM mybucket4

Get-S3Bucket コマンドレットでは、Set-AWSSamlRoleProfile コマンドレットを実行して作成されたプロファイルの名前を指定します。このコマンドは、セッションで以前に (たとえば、Set-AWSCredential コマンドレットを実行して) ロールプロファイルを設定し、Get-S3Bucket コマンドレットに別のロールプロファイルを使用する場合に役立ちます。プロファイルマネージャーは、一時的な認証情報を Get-S3Bucket コマンドレットに使用できるようにします。

認証情報は 1 時間で有効期限が切れますが (STS によって実施される制限)、AWS Tools for PowerShell が現在の認証情報の有効期限が切れたことを検出すると、ツールは、新しい SAML アサーションをリクエストすることで、認証情報を自動的に更新します。

ドメイン結合されたユーザーの場合、現在のユーザーの Windows ID が認証時に使用されるため、このプロセスは中断なしで行われます。ドメイン結合されていないユーザーアカウントの場合、AWS Tools forPowerShell は、PowerShell 認証情報のプロンプトを表示して、ユーザーパスワードを要求します。ユーザーは、ユーザーの認証に使用する認証情報を指定し、新しいアサーションを取得します。

例 3: リージョンのインスタンスを取得する次の例では、ADFS-Production プロファイルの使用するアカウントに関連付けられたアジアパシフィック (シドニー) リージョンにあるすべての Amazon EC2 インスタンスを一覧表示します。これは、リージョンにあるすべての Amazon EC2 インスタンスを返す便利なコマンドです。

PS > (Get-Ec2Instance -ProfileName ADFS-Production -Region ap-southeast-2).Instances | Select InstanceType, @{Name="Servername";Expression={$_.tags | where key -eq "Name" | Select Value -Expand Value}}

InstanceType Servername ------------ ---------- t2.small DC2 t1.micro NAT1

52

AWS Tools for PowerShell ユーザーガイドその他の参考資料

t1.micro RDGW1 t1.micro RDGW2 t1.micro NAT2 t2.small DC1 t2.micro BUILD

その他の参考資料フェデレーティッド API アクセスの実装方法に関する一般的な情報については、「How to Implement aGeneral Solution for Federated API/CLI Access Using SAML 2.0」を参照してください。

ご質問やご意見がございましたら、PowerShell Scripting または .NET Development の AWS 開発者フォーラムにアクセスしてください。

53

http://aws.amazon.com/blogs/security/how-to-implement-a-general-solution-for-federated-apicli-access-using-saml-2-0/

http://aws.amazon.com/blogs/security/how-to-implement-a-general-solution-for-federated-apicli-access-using-saml-2-0/

https://forums.aws.amazon.com/forum.jspa?forumID=149

https://forums.aws.amazon.com/forum.jspa?forumID=61

AWS Tools for PowerShell ユーザーガイドPowerShell ファイルの連結エンコード

AWS Tools for Windows PowerShellの使用

トピック• PowerShell ファイルの連結エンコード (p. 54)• PowerShell ツールに対して返されるオブジェクト (p. 55)• Amazon EC2 (p. 55)• Amazon S3 (p. 55)• AWS Identity and Access Management (p. 55)• AWS Lambda と AWS Lambda Tools for PowerShell (p. 56)• Amazon SNS と Amazon SQS (p. 56)• CloudWatch (p. 56)• 以下の資料も参照してください。 (p. 56)• Amazon S3 および Tools for Windows PowerShell (p. 56)• IAM および Tools for Windows PowerShell (p. 61)• Amazon EC2 および Tools for Windows PowerShell (p. 64)• AWS Lambda および AWS Tools for PowerShell (p. 74)• Amazon SQS、Amazon SNS、および Tools for Windows PowerShell (p. 75)• AWS Tools for Windows PowerShell からの CloudWatch (p. 78)

このセクションでは、AWS Tools for PowerShell を使用して AWS のサービスにアクセスする例を示します。以下の例では、コマンドレットを使用して実際の AWS タスクを実行する方法を示します。

PowerShell ファイルの連結エンコードAWS Tools for PowerShell の一部のコマンドレットは、AWS にある既存のファイルまたはレコードを編集します。たとえば、Edit-R53ResourceRecordSet では、Amazon Route 53 のChangeResourceRecordSets API を呼び出します。

PowerShell 5.1 以前のリリースでファイルを編集または連結すると、PowerShell は UTF-8 ではなくUTF-16 で出力をエンコードします。これにより、不要な文字が追加されたり、有効でない結果が作成されたりする場合があります。16 進数エディタを使用すると、不要な文字を表示できます。

ファイル出力が UTF-16 に変換されないようにするには、次の例に示すように、PowerShell の Out-Fileコマンドレットにコマンドをパイプ処理し、UTF-8 エンコードを指定します。

PS > *some file concatenation command* | Out-File filename.txt -Encoding utf8

PowerShell コンソールで AWS CLI コマンドを実行している場合、同じ動作が適用されます。AWS CLI コマンドの出力を PowerShell コンソールの Out-File にパイプ処理できます。Export-Csv や Export-Clixml など、その他のコマンドレットにも Encoding パラメータがあります。Encoding パラメータを持つコマンドレット、および連結されたファイル出力のエンコードを修正できるコマンドレットの詳細なリストについては、次のコマンドを実行します。

54

https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html

AWS Tools for PowerShell ユーザーガイドPowerShell ツールに対して返されるオブジェクト

PS > Get-Command -ParameterName "Encoding"

Note

PowerShell Core を含む PowerShell 6.0 以降では、連結されたファイル出力の UTF-8 エンコードが自動的に保持されます。

PowerShell ツールに対して返されるオブジェクトネイティブの PowerShell 環境で AWS Tools for PowerShell をより便利にするために、AWS Tools forPowerShell コマンドレットによって返されるオブジェクトは .NET オブジェクトであり、AWS SDK の対応する API から通常返される JSON テキストオブジェクトではありません。たとえば、Get-S3Bucketは、Amazon S3 JSON 応答オブジェクトではなく、Buckets コレクションを返します。Buckets コレクションは PowerShell パイプラインに配置し、適切な方法で操作できます。同様に、Get-EC2Instanceは DescribeEC2Instances JSON 結果オブジェクトではなく、Reservation .NET オブジェクトコレクションを出力します。この動作は設計によるものであり、AWS Tools for PowerShell と慣用的なPowerShell との一貫性を向上させるためのものです。

実際のサービス応答は、返されたオブジェクトの note プロパティとして保存され、必要であれば利用できます。NextToken フィールドを使用してページングをサポートする API アクションの場合、note プロパティとしても添付されます。

Amazon EC2 (p. 64)このセクションでは、以下の方法を含む、Amazon EC2 インスタンスを起動するために必要な手順について説明します。

• Amazon Machine Image (AMI) のリストの取得• SSH 認証のキーペアの作成• Amazon EC2 セキュリティグループの作成と設定• インスタンスの起動、インスタンスに関する情報の取得

Amazon S3 (p. 56)このセクションでは、Amazon S3 でホストされる静的ウェブサイトを作成するために必要な手順について説明します。以下の方法について説明します。

• Amazon S3 バケットの作成と削除• Amazon S3 バケットへのオブジェクトとしてのファイルのアップロード• Amazon S3 バケットからのオブジェクトの削除• Amazon S3 バケットのウェブサイトとしての指定

AWS Identity and Access Management (p. 61)このセクションでは、以下の方法を含む、AWS Identity and Access Management (IAM) の基本的な操作方法を示します。

55

AWS Tools for PowerShell ユーザーガイドAWS Lambda と AWS Lambda Tools for PowerShell

• IAM グループの作成• IAM ユーザーの作成• IAM グループに IAM ユーザーを追加する• IAM ユーザーのポリシーの指定• IAM ユーザーのパスワードと認証情報の設定

AWS Lambda と AWS Lambda Tools forPowerShell (p. 74)

このセクションでは、AWS Lambda Tools for PowerShell モジュールを簡単に紹介し、このモジュールの設定に必要なステップについて説明します。

Amazon SNS と Amazon SQS (p. 75)このセクションでは、Amazon SQS キューを Amazon SNS トピックにサブスクライブするために必要なステップについて説明します。以下の方法について説明します。

• Amazon SNS トピックを作成します。• Amazon SQS キューを作成します。• キューをトピックにサブスクライブします。• メッセージをトピックに送信します。• キューからメッセージを受信します。

CloudWatch (p. 78)このセクションでは、カスタムデータを CloudWatch に発行する方法を例を挙げて説明します。

• カスタムメトリクスを CloudWatch ダッシュボードに発行します。

以下の資料も参照してください。• AWS Tools for Windows PowerShell の開始方法 (p. 26)

Amazon S3 および Tools for Windows PowerShellトピック

• 以下の資料も参照してください。 (p. 56)• Amazon S3 バケットの作成、そのリージョンの確認、および必要に応じたバケットの削除 (p. 57)• Amazon S3 バケットをウェブサイトとして設定し、ログを有効にする (p. 58)• オブジェクトの Amazon S3 バケットへのアップロード (p. 58)• Amazon S3 オブジェクトとバケットの削除 (p. 60)

56

AWS Tools for PowerShell ユーザーガイド以下の資料も参照してください。

• インラインテキストコンテンツの Amazon S3 へのアップロード (p. 61)

このセクションでは、Amazon S3 と CloudFront で AWS Tools for Windows PowerShell を使用して静的ウェブサイトを作成します。このプロセスでは、これらのサービスに共通な多くのタスクを扱います。このウォークスルーは、AWS マネジメントコンソールを使用した同様のプロセスを説明する静的ウェブサイトのホスティング入門ガイドをモデル化したものです。

ここで示すコマンドは、ユーザーの PowerShell セッションのデフォルトの認証情報とデフォルトのリージョンが設定済みであることを前提としています。したがって、認証情報とリージョンはコマンドレットの呼び出しには含まれません。

Note

現時点では、バケットまたはオブジェクトの名前を変更する Amazon S3 API はないため、このタスクを実行する単一の Tools for Windows PowerShell コマンドレットはありません。S3 のオブジェクトの名前を変更するには、Copy-S3Object コマンドレットを実行して、新しい名前でオブジェクトをコピーしてから、Remove-S3Object コマンドレットを実行して元のオブジェクトを削除することをお勧めします。

以下の資料も参照してください。• AWS Tools for Windows PowerShell の使用 (p. 54)• Amazon S3 で静的ウェブサイトをホスティングする• Amazon S3 コンソール

Amazon S3 バケットの作成、そのリージョンの確認、および必要に応じたバケットの削除新しい Amazon S3 バケットを作成するには、New-S3Bucket コマンドレットを使用します。次の例では、website-example という名前のバケットを作成します。バケットの名前はすべてのリージョン間で一意である必要があります。この例では、us-west-1 リージョンにバケットを作成します。

PS > New-S3Bucket -BucketName website-example -Region us-west-2

CreationDate BucketName------------ ----------8/16/19 8:45:38 PM website-example

バケットがあるリージョンを確認するには、Get-S3BucketLocation コマンドレットを使用します。

PS > Get-S3BucketLocation -BucketName website-example

Value-----us-west-2

このチュートリアルを終了したら、次の行を使用してこのバケットを削除できます。このバケットは以降の例で使用するため、そのままにしておくことをお勧めします。

PS > Remove-S3Bucket -BucketName website-example

バケットの削除プロセスは完了するまでに時間がかかる場合があります。同じ名前のバケットをすぐに再作成しようとすると、古いバケットが完全に削除されるまで New-S3Bucket コマンドレットが失敗することがあります。

57

https://console.aws.amazon.com/s3/home

https://aws.amazon.com/getting-started/projects/host-static-website/

https://aws.amazon.com/getting-started/projects/host-static-website/

https://docs.aws.amazon.com/powershell/latest/reference/items/Copy-S3Object.html

https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-S3Object.html

https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html

https://console.aws.amazon.com/s3/home

AWS Tools for PowerShell ユーザーガイドAmazon S3 バケットをウェブサイトとして設定し、ログを有効にする

以下の資料も参照してください。• AWS Tools for Windows PowerShell の使用 (p. 54)• PUT Bucket (Amazon S3 サービスリファレンス)• Amazon S3 の AWS PowerShell リージョン

Amazon S3 バケットをウェブサイトとして設定し、ログを有効にするWrite-S3BucketWebsite コマンドレットでは、Amazon S3 バケットを静的ウェブサイトとして設定します。次の例では、デフォルトのコンテンツウェブページの index.html の名前とデフォルトのエラーウェブページの error.html の名前を指定します。このコマンドレットは、これらのページを作成しません。Amazon S3 オブジェクトとしてアップロード (p. 58)する必要があります。

PS > Write-S3BucketWebsite -BucketName website-example -WebsiteConfiguration_IndexDocumentSuffix index.html -WebsiteConfiguration_ErrorDocument error.htmlRequestId : A1813E27995FFDDDAmazonId2 : T7hlDOeLqA5Q2XfTe8j2q3SLoP3/5XwhUU3RyJBGHU/LnC+CIWLeGgP0MY24xAlIResponseStream :Headers : {x-amz-id-2, x-amz-request-id, Content-Length, Date...}Metadata : {}ResponseXml :

以下の資料も参照してください。• AWS Tools for Windows PowerShell の使用 (p. 54)• PUT Bucket website (Amazon S3 API リファレンス)• PUT Bucket acl (Amazon S3 API リファレンス)

オブジェクトの Amazon S3 バケットへのアップロードWrite-S3Object コマンドレットでは、ローカルファイルシステムのファイルをオブジェクトとして Amazon S3 バケットにアップロードします。以下の例では、2 つの簡単な HTML ファイルを作成して、Amazon S3 バケットにアップロードし、アップロードされたオブジェクトが存在するかどうかを確認します。-File への Write-S3Object パラメータは、ローカルファイルシステム内のファイルの名前を指定します。-Key パラメータは、Amazon S3 での対応するオブジェクトの名前を指定します。

Amazon は、ファイルの拡張子、この場合、「.html」からオブジェクトのコンテンツタイプを推論します。

PS > # Create the two files using here-strings and the Set-Content cmdletPS > $index_html = @">> <html>>> <body>>> <p>>> Hello, World!>> </p>>> </body>>> </html>>> "@>>

58

https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUT.html

https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region

https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTwebsite.html

https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTacl.html

AWS Tools for PowerShell ユーザーガイドオブジェクトの Amazon S3 バケットへのアップロード

PS > $index_html | Set-Content index.htmlPS > $error_html = @">> <html>>> <body>>> <p>>> This is an error page.>> </p>>> </body>>> </html>>> "@>>>>$error_html | Set-Content error.html>># Upload the files to Amazon S3 using a foreach loop>>foreach ($f in "index.html", "error.html") {>> Write-S3Object -BucketName website-example -File $f -Key $f -CannedACLName public-read>> }>>PS > # Verify that the files were uploadedPS > Get-S3BucketWebsite -BucketName website-example

IndexDocumentSuffix ErrorDocument------------------- -------------index.html error.html

既定 ACL オプション

Tools for Windows PowerShell で既定 ACL を指定するための値は、AWS SDK for .NET によって使用される値と同じです。ただし、Amazon S3Put Object アクションによって使用される値とは異なります。Tools for Windows PowerShell では、次の既定 ACL をサポートしています。

• NoACL• プライベート• public-read• public-read-write• aws-exec-read• authenticated-read• bucket-owner-read• bucket-owner-full-control• log-delivery-write

この既定 ACL 設定の詳細については、「アクセスコントロールリスト (ACL) の概要」を参照してください。

マルチパートアップロードに関する注意事項Amazon S3 API を使用して、5 GB よりも大きいファイルをアップロードする場合、マルチパートアップロードを使用する必要があります。ただし、Tools for Windows PowerShell が提供する Write-S3Objectコマンドレットでは、5 GB よりも大きいファイルのアップロードを透過的に処理します。

ウェブサイトをテストするこの時点で、ブラウザを使用して移動することで、ウェブサイトをテストできます。Amazon S3 でホストされる静的ウェブサイトの URL は、標準形式に従います。

http://<bucket-name>.s3-website-<region>.amazonaws.com

例:

59

https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl

AWS Tools for PowerShell ユーザーガイドAmazon S3 オブジェクトとバケットの削除

http://website-example.s3-website-us-west-1.amazonaws.com

以下の資料も参照してください。

• AWS Tools for Windows PowerShell の使用 (p. 54)• PUT オブジェクト (Amazon S3 API リファレンス)• 既定 ACL (Amazon S3 API リファレンス)

Amazon S3 オブジェクトとバケットの削除このセクションでは、以前のセクションで作成したウェブサイトを削除する方法について説明します。HTML ファイルのオブジェクトを単純に削除し、その後にサイトの Amazon S3 バケットを削除します。

まず、Amazon S3 バケットから HTML ファイルのオブジェクトを削除するには、Remove-S3Object コマンドレットを実行します。

PS > foreach ( $obj in "index.html", "error.html" ) {>> Remove-S3Object -BucketName website-example -Key $obj>> }>> IsDeleteMarker--------------False

False レスポンスは、Amazon S3 のリクエスト処理で予期されるアーティファクトです。この場合、このレスポンスは問題を示しているわけではありません。

この時点で、Remove-S3Bucket コマンドレットを実行して、サイトの空になった Amazon S3 バケットを削除することができます。

PS > Remove-S3Bucket -BucketName website-example

RequestId : E480ED92A2EC703DAmazonId2 : k6tqaqC1nMkoeYwbuJXUx1/UDa49BJd6dfLN0Ls1mWYNPHjbc8/Nyvm6AGbWcc2PResponseStream :Headers : {x-amz-id-2, x-amz-request-id, Date, Server}Metadata : {}ResponseXml :

バージョン 1.1 以降の AWS Tools for PowerShell では、-DeleteBucketContent パラメータをRemove-S3Bucket に追加できます。このパラメータにより、指定したバケット内のすべてのオブジェクトとオブジェクトバージョンが削除された後でバケット自体が削除されます。バケット内のオブジェクトまたはオブジェクトのバージョンの数によっては、この操作にかなりの時間がかかることがあります。バージョン 1.1 より前の Tools for Windows PowerShell では、Remove-S3Bucket を使用してバケットを削除する前に、バケットを空にする必要がありました。

Note

-Force パラメータを追加しない限り、コマンドレットが実行される前に AWS Tools forPowerShell により確認プロンプトが表示されます。

以下の資料も参照してください。• AWS Tools for Windows PowerShell の使用 (p. 54)• DELETE オブジェクト (Amazon S3 API リファレンス)

60

https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html

https://docs.aws.amazon.com/AmazonS3/latest/dev/ACLOverview.html#CannedACL

https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html

AWS Tools for PowerShell ユーザーガイドインラインテキストコンテンツの Amazon S3 へのアップロード

• DeleteBucket (Amazon S3 API リファレンス)

インラインテキストコンテンツの Amazon S3 へのアップロードWrite-S3Object コマンドレットでは、インラインテキストコンテンツを Amazon S3 にアップロードする機能をサポートしています。-Content パラメータ (別名 -Text) を使用して、Amazon S3 にアップロードするテキストベースのコンテンツを指定することができます。この場合、事前にコンテンツをファイルに格納する必要はありません。このパラメーターでは、簡単な 1 行の文字列や、次のような複数の行が含まれている文字列が指定できます。

PS > # Specifying content in-line, single line text:PS > write-s3object mybucket -key myobject.txt -content "file content"

PS > # Specifying content in-line, multi-line text: (note final newline needed to end in-line here-string)PS > write-s3object mybucket -key myobject.txt -content @">> line 1>> line 2>> line 3>> "@>> PS > # Specifying content from a variable: (note final newline needed to end in-line here-string)PS > $x = @">> line 1>> line 2>> line 3>> "@>> PS > write-s3object mybucket -key myobject.txt -content $x

IAM および Tools for Windows PowerShellこのセクションでは、AWS Identity and Access Management (IAM) に関する一般的なタスクと、これらのタスクを AWS Tools for Windows PowerShell で実行する方法について説明します。

ここで示すコマンドは、ユーザーの PowerShell セッションのデフォルトの認証情報とデフォルトのリージョンが設定済みであることを前提としています。したがって、認証情報とリージョンはコマンドレットの呼び出しには含まれません。

トピック• 新しい IAM ユーザーとグループの作成 (p. 61)• IAM ユーザーへの IAM ポリシーの設定 (p. 62)• IAM ユーザーの初期パスワードの設定 (p. 63)

新しい IAM ユーザーとグループの作成このセクションでは、新しい IAM グループと新しい IAM ユーザーを作成して、ユーザーをグループに追加する方法を説明します。

まず、New-IAMGroup コマンドレットを使用して、グループを作成します。この例では指定していますが、-Path パラメーターはオプションです。

61

https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketDELETE.html

AWS Tools for PowerShell ユーザーガイドIAM ユーザーへの IAM ポリシーの設定

PS > New-IAMGroup -Path "/ps-created-groups/" -GroupName "powerUsers"

Path : /ps-created-groups/GroupName : powerUsersGroupId : AGPAJPHUEYD5XPCGIUH3EArn : arn:aws:iam::455364113843:group/ps-created-groups/powerUsersCreateDate : 11/20/2012 3:32:50 PM

次に、New-IAMUser コマンドレットを使用して、ユーザーを作成します。前の例と同様に、-Path パラメータはオプションです。

PS > New-IAMUser -Path "/ps-created-users/" -UserName "myNewUser"

Path : /ps-created-users/UserName : myNewUserUserId : AIDAJOJSPSPXADHBT7IN6Arn : arn:aws:iam::455364113843:user/ps-created-users/myNewUserCreateDate : 11/20/2012 3:26:31 PM

最後に、Add-IAMUserToGroup コマンドレットを使用して、そのユーザーをグループに追加します。

PS > Add-IAMUserToGroup -UserName myNewUser -GroupName powerUsers

ServiceResponse---------------Amazon.IdentityManagement.Model.AddUserToGroupResponse

powerUsers グループに myNewUser が含まれていることを確認するには、Get-IAMGroup コマンドレットを使用します。

PS > Get-IAMGroup -GroupName powerUsers

Group Users IsTruncated Marker----- ----- ----------- ------Amazon.IdentityManagement.... {myNewUser} False

また、AWS マネジメントコンソールを使用して IAM のユーザーとグループを表示することもできます。

• http://console.aws.amazon.com/iam/home?#s=Users (ユーザービュー)• http://console.aws.amazon.com/iam/home?#s=Groups (グループビュー)

以下の資料も参照してください。• AWS Tools for Windows PowerShell の使用 (p. 54)• AWS アカウントへの新しいユーザーの追加 (IAM ユーザーガイド)• CreateGroup (IAM サービスリファレンス)

IAM ユーザーへの IAM ポリシーの設定以下のコマンドは、IAM ポリシーを IAM ユーザーに割り当てる方法を示しています。以下に指定されたポリシーにより、ユーザーに "Power User Access" が提供されます。このポリシーは、IAM コンソールで提

62

https://console.aws.amazon.com/iam/home?#s=Users

https://console.aws.amazon.com/iam/home?#s=Groups

https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html

https://docs.aws.amazon.com/IAM/latest/APIReference/API_API_CreateGroup.html

AWS Tools for PowerShell ユーザーガイドIAM ユーザーの初期パスワードの設定

供されている Power User Access ポリシーテンプレートと同じです。以下に示すポリシー名は、IAM ポリシーテンプレート (Power User Access テンプレートなど) で使用されている命名規則に従います。この規則は次のとおりです。

<template name>+<user name>+<date stamp>

ポリシードキュメントを指定するには、PowerShell の here-string を使用します。here-string のコンテンツを変数に割り当て、その後 Write-IAMUserPolicy のパラメータ値としてこの変数を使用します。

PS > $policyDoc = @">> {>> "Version": "2012-10-17",>> "Statement": [>> {>> "Effect": "Allow",>> "NotAction": "iam:*",>> "Resource": "*">> }>> ]>> }>> "@>>

PS > Write-IAMUserPolicy -UserName myNewUser -PolicyName "PowerUserAccess-myNewUser-201211201605" -PolicyDocument $policyDoc

ServiceResponse---------------Amazon.IdentityManagement.Model.PutUserPolicyResponse

以下の資料も参照してください。• AWS Tools for Windows PowerShell の使用 (p. 54)• Windows PowerShell "Here-Strings" の使用• PutUserPolicy

IAM ユーザーの初期パスワードの設定次の例では、New-IAMLoginProfile コマンドレットを使用して、IAM ユーザーの初期パスワードを設定する方法を示します。パスワードの文字制限と推奨事項の詳細については、IAM ユーザーガイドの「パスワードポリシーのオプション」を参照してください。

PS > New-IAMLoginProfile -UserName myNewUser -Password "&!123!&"

UserName CreateDate-------- ----------myNewUser 11/20/2012 4:23:05 PM

IAM ユーザーのパスワードを変更するには、Update-IAMLoginProfile コマンドレットを使用します。

以下の資料も参照してください。• AWS Tools for Windows PowerShell の使用 (p. 54)• パスワードの管理

63

http://technet.microsoft.com/en-us/library/ee692792.aspx

https://docs.aws.amazon.com/IAM/latest/APIReference/API_PutUserPolicy.html

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_account-policy.html#password-policy-details

https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_passwords_account-policy.html#password-policy-details

https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingLogins.html

AWS Tools for PowerShell ユーザーガイドAmazon EC2 および Tools for Windows PowerShell

• CreateLoginProfile

Amazon EC2 および Tools for Windows PowerShellAWS Tools for PowerShell を使用して Amazon EC2 に関連する一般的なタスクを実行できます。

以下に示すコマンド例では、PowerShell セッションのデフォルトの認証情報とデフォルトのリージョンは設定済みであるとものとします。したがって、コマンドレットを呼び出す際に認証情報やリージョンは指定していません。詳細については、「AWS Tools for Windows PowerShell の開始方法 (p. 26)」を参照してください。

トピック• キーペアを作成する (p. 64)• Windows PowerShell を使用したセキュリティグループの作成 (p. 66)• Windows PowerShell を使用した Amazon Machine Image の検索 (p. 69)• Windows PowerShell を使用した Amazon EC2 インスタンスの起動 (p. 71)

キーペアを作成する次の New-EC2KeyPair 例では、キーペアを作成し、PowerShell 変数 $myPSKeyPair に保存します。

PS > $myPSKeyPair = New-EC2KeyPair -KeyName myPSKeyPair

キーペアオブジェクトを Get-Member コマンドレットにパイプ処理すると、オブジェクトの構造が表示されます。

PS > $myPSKeyPair | Get-Member

TypeName: Amazon.EC2.Model.KeyPair

Name MemberType Definition ---- ---------- ---------- Equals Method bool Equals(System.Object obj) GetHashCode Method int GetHashCode() GetType Method type GetType() ToString Method string ToString() KeyFingerprint Property System.String KeyFingerprint {get;set;} KeyMaterial Property System.String KeyMaterial {get;set;} KeyName Property System.String KeyName {get;set;}

キーペアオブジェクトを Format-List コマンドレットにパイプ処理すると、KeyName、KeyFingerprint、および KeyMaterial の各メンバーの値が表示されます(出力は読みやすくするために切り詰められます)。

PS > $myPSKeyPair | Format-List KeyName, KeyFingerprint, KeyMaterial

KeyName : myPSKeyPair KeyFingerprint : 09:06:70:8e:26:b6:e7:ef:8f:fe:4a:1d:bc:9c:6a:63:11:ac:ad:3c KeyMaterial : ----BEGIN RSA PRIVATE KEY---- MIIEogIBAAKCAQEAkK+ANYUS9c7niNjYfaCn6KYj/D0I6djnFoQE... Mz6btoxPcE7EMeH1wySUp8nouAS9xbl9l7+VkD74bN9KmNcPa/Mu... Zyn4vVe0Q5il/MpkrRogHqOB0rigeTeV5Yc3lvO0RFFPu0Kz4kcm... w3Jg8dKsWn0plOpX7V3sRC02KgJIbejQUvBFGi5OQK9bm4tXBIeC...

64

https://docs.aws.amazon.com/IAM/latest/UserGuide/API_CreateLoginProfile.html

AWS Tools for PowerShell ユーザーガイドキーペアの作成

daxKIAQMtDUdmBDrhR1/YMv8itFe5DiLLbq7Ga+FDcS85NstBa3h... iuskGkcvgWkcFQkLmRHRoDpPb+OdFsZtjHZDpMVFmA9tT8EdbkEF... 3SrNeqZPsxJJIxOodb3CxLJpg75JU5kyWnb0+sDNVHoJiZCULCr0... GGlLfEgB95KjGIk7zEv2Q7K6s+DHclrDeMZWa7KFNRZuCuX7jssC... xO98abxMr3o3TNU6p1ZYRJEQ0oJr0W+kc+/8SWb8NIwfLtwhmJEy... 1BX9X8WFX/A8VLHrT1elrKmLkNECgYEAwltkV1pOJAFhz9p7ZFEv... vvVsPaF0Ev9bk9pqhx269PB5Ox2KokwCagDMMaYvasWobuLmNu/1... lmwRx7KTeQ7W1J3OLgxHA1QNMkip9c4Tb3q9vVc3t/fPf8vwfJ8C... 63g6N6rk2FkHZX1E62BgbewUd3eZOS05Ip4VUdvtGcuc8/qa+e5C... KXgyt9nl64pMv+VaXfXkZhdLAdY0Khc9TGB9++VMSG5TrD15YJId... gYALEI7m1jJKpHWAEs0hiemw5VmKyIZpzGstSJsFStERlAjiETDH... YAtnI4J8dRyP9I7BOVOn3wNfIjk85gi1/0Oc+j8S65giLAfndWGR... 9R9wIkm5BMUcSRRcDy0yuwKBgEbkOnGGSD0ah4HkvrUkepIbUDTD... AnEBM1cXI5UT7BfKInpUihZi59QhgdK/hkOSmWhlZGWikJ5VizBf... drkBr/vTKVRMTi3lVFB7KkIV1xJxC5E/BZ+YdZEpWoCZAoGAC/Cd... TTld5N6opgOXAcQJwzqoGa9ZMwc5Q9f4bfRc67emkw0ZAAwSsvWR... x3O2duuy7/smTwWwskEWRK5IrUxoMv/VVYaqdzcOajwieNrblr7c... -----END RSA PRIVATE KEY-----

KeyMaterial メンバーにはキーペアのプライベートキーが保存されます。パブリックキーは AWSに保存されます。AWS からパブリックキーを取得することはできませんが、プライベートキーのKeyFingerprint を、AWS から返されたパブリックキーのフィンガープリントと比較することで、パブリックキーを確認することができます。

キーペアのフィンガープリントの表示Get-EC2KeyPair コマンドレットを使用して、キーペアのフィンガープリントを表示できます。

PS > Get-EC2KeyPair -KeyName myPSKeyPair | format-list KeyName, KeyFingerprint

KeyName : myPSKeyPair KeyFingerprint : 09:06:70:8e:26:b6:e7:ef:8f:fe:4a:1d:bc:9c:6a:63:11:ac:ad:3c

プライベートキーの保存ファイルにプライベートキーを保存するには、KeyFingerMaterial メンバーを Out-File コマンドレットにパイプ処理します。

PS > $myPSKeyPair.KeyMaterial | Out-File -Encoding ascii myPSKeyPair.pem

プライベートキーをファイルに書き込む際には、-Encoding ascii を指定する必要があります。指定しない場合、openssl などのツールがファイルを正しく読み取ることができなくなる可能性があります。作成したファイルの形式が正しいことを確認するには、次のようなコマンドを使用します。

PS > openssl rsa -check < myPSKeyPair.pem

(openssl ツールは AWS Tools for PowerShell または AWS SDK for .NET には含まれていません。)

キーペアの削除インスタンスを起動して接続するにはキーペアが必要です。キーペアを使用し終わったら、削除できます。AWS からパブリックキーを削除するには、Remove-EC2KeyPair コマンドレットを使用します。プロンプトが表示されたら、Enter キーを押して、キーペアを削除します。

PS > Remove-EC2KeyPair -KeyName myPSKeyPair

65

AWS Tools for PowerShell ユーザーガイドセキュリティグループの作成

ConfirmPerforming the operation "Remove-EC2KeyPair (DeleteKeyPair)" on target "myPSKeyPair".[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default is "Y"):

現行の PowerShell セッションにはまだ $myPSKeyPair 変数が存在しており、キーペア情報が含まれています。また、myPSKeyPair.pem ファイルも存在します。ただし、キーペアのパブリックキーが AWS に保存されていないため、プライベートキーは使用できません。

Windows PowerShell を使用したセキュリティグループの作成AWS Tools for PowerShell を使用して、セキュリティグループを作成および設定できます。セキュリティグループを作成するときは、EC2-Classic 用のセキュリティグループなのか、EC2-VPC 用のセキュリティグループなのかを指定します。応答はセキュリティグループの ID です。

インスタンスに接続する必要がある場合、SSH トラフィック (Linux) または RDP トラフィック (Windows)を許可するようにセキュリティグループを設定する必要があります。

トピック• 前提条件 (p. 66)• EC2-Classic 用セキュリティグループの作成 (p. 66)• EC2-VPC 用セキュリティグループの作成 (p. 67)

前提条件コンピュータの CIDR 表記のパブリック IP アドレスが必要です。サービスを使用して、ローカルコンピュータのパブリック IP アドレスを取得できます。たとえば、Amazon では、http://checkip.amazonaws.com/ または https://checkip.amazonaws.com/ のサービスを提供しています。IP アドレスを提供する別のサービスを検索するには、検索フレーズ「what is my IP address」を使用します。ISP経由で、またはファイアウォールの内側から静的な IP アドレスなしで接続している場合は、クライアントコンピュータで使用できる IP アドレスの範囲を見つける必要があります。

Warning

0.0.0.0/0 を指定すると、世界中の任意の IP アドレスからのトラフィックが有効になります。SSH と RDP プロトコルの場合、これはテスト環境で短時間なら許容できますが、実稼働環境で行うのは安全ではありません。実稼働環境では、適切な個別の IP アドレスまたはアドレス範囲からのアクセスのみを許可するようにしてください。

EC2-Classic 用セキュリティグループの作成次の例では、New-EC2SecurityGroup コマンドレットを使用して EC2-Classic のセキュリティグループを作成します。

PS > New-EC2SecurityGroup -GroupName myPSSecurityGroup -GroupDescription "EC2-Classic from PowerShell"

sg-0a346530123456789

セキュリティグループの初期設定を表示するには、Get-EC2SecurityGroup コマンドレットを使用します。

66

http://checkip.amazonaws.com/

http://checkip.amazonaws.com/

https://checkip.amazonaws.com/


PS > Get-EC2SecurityGroup -GroupNames myPSSecurityGroup

Description : EC2-Classic from PowerShellGroupId : sg-0a346530123456789GroupName : myPSSecurityGroupIpPermissions : {}IpPermissionsEgress : {Amazon.EC2.Model.IpPermission}OwnerId : 123456789012Tags : {}VpcId : vpc-9668ddef

TCP ポート 22 (SSH) と TCP ポート 3389 でインバウンドトラフィックを許可するようにセキュリティグループを設定するには、Grant-EC2SecurityGroupIngress コマンドレットを使用します。たとえば、次のスクリプト例では、単一の IP アドレス 203.0.113.25/32 からの SSH トラフィックを有効にする方法を示します。

$cidrBlocks = New-Object 'collections.generic.list[string]'$cidrBlocks.add("203.0.113.25/32")$ipPermissions = New-Object Amazon.EC2.Model.IpPermission$ipPermissions.IpProtocol = "tcp"$ipPermissions.FromPort = 22$ipPermissions.ToPort = 22ipPermissions.IpRanges = $cidrBlocksGrant-EC2SecurityGroupIngress -GroupName myPSSecurityGroup -IpPermissions $ipPermissions

セキュリティグループが更新されているかどうかを確認するには、再度、Get-EC2SecurityGroup コマンドレットを実行します。EC2-Classic のアウトバウンドルールは指定できません。

PS > Get-EC2SecurityGroup -GroupNames myPSSecurityGroup

OwnerId : 123456789012GroupName : myPSSecurityGroupGroupId : sg-0a346530123456789Description : EC2-Classic from PowerShellIpPermissions : {Amazon.EC2.Model.IpPermission}IpPermissionsEgress : {}VpcId :Tags : {}

セキュリティグループのルールを表示するには、IpPermissions プロパティを使用します。

PS > (Get-EC2SecurityGroup -GroupNames myPSSecurityGroup).IpPermissions

IpProtocol : tcpFromPort : 22ToPort : 22UserIdGroupPairs : {}IpRanges : {203.0.113.25/32}

EC2-VPC 用セキュリティグループの作成次の New-EC2SecurityGroup 例では、指定された VPC のセキュリティグループを作成するために -VpcId パラメータを追加します。

PS > $groupid = New-EC2SecurityGroup ` -VpcId "vpc-da0013b3" ` -GroupName "myPSSecurityGroup" `

67


-GroupDescription "EC2-VPC from PowerShell"

セキュリティグループの初期設定を表示するには、Get-EC2SecurityGroup コマンドレットを使用します。デフォルトでは、VPC 用のセキュリティグループにはすべてのアウトバウンドトラフィックを許可するルールが含まれています。EC2-VPC 用セキュリティグループは名前では参照できないことに注意してください。

PS > Get-EC2SecurityGroup -GroupId sg-5d293231

OwnerId : 123456789012GroupName : myPSSecurityGroupGroupId : sg-5d293231Description : EC2-VPC from PowerShellIpPermissions : {}IpPermissionsEgress : {Amazon.EC2.Model.IpPermission}VpcId : vpc-da0013b3Tags : {}

TCP ポート 22 (SSH) および TCP ポート 3389 のインバウンドトラフィックのアクセス許可を定義するには、New-Object コマンドレットを使用します。次のスクリプト例では、単一の IP アドレス、203.0.113.25/32 から TCP ポート 22 および 3389 のアクセス許可を定義します。

$ip1 = new-object Amazon.EC2.Model.IpPermission $ip1.IpProtocol = "tcp" $ip1.FromPort = 22 $ip1.ToPort = 22 $ip1.IpRanges.Add("203.0.113.25/32") $ip2 = new-object Amazon.EC2.Model.IpPermission $ip2.IpProtocol = "tcp" $ip2.FromPort = 3389 $ip2.ToPort = 3389 $ip2.IpRanges.Add("203.0.113.25/32") Grant-EC2SecurityGroupIngress -GroupId $groupid -IpPermissions @( $ip1, $ip2 )

セキュリティグループが更新されているかどうかを確認するには、再度、Get-EC2SecurityGroup コマンドレットを使用します。

PS > Get-EC2SecurityGroup -GroupIds sg-5d293231

OwnerId : 123456789012GroupName : myPSSecurityGroupGroupId : sg-5d293231Description : EC2-VPC from PowerShellIpPermissions : {Amazon.EC2.Model.IpPermission}IpPermissionsEgress : {Amazon.EC2.Model.IpPermission}VpcId : vpc-da0013b3Tags : {}

インバウンドルールを表示するには、前のコマンドで返されたコレクションオブジェクトからIpPermissions プロパティを取得します。

PS > (Get-EC2SecurityGroup -GroupIds sg-5d293231).IpPermissions


68

AWS Tools for PowerShell ユーザーガイドAMI の検索


Windows PowerShell を使用した Amazon MachineImage の検索Amazon EC2 インスタンスを起動する際には、インスタンスのテンプレートとなる Amazon マシンイメージ (AMI) を指定する必要があります。ただし、AWS では、最新の更新とセキュリティ強化が適用された新しい AMI を提供するため、AWS Windows AMI の ID は頻繁に変更されます。Get-EC2Image コマンドレットおよび Get-EC2ImageByName コマンドレットを使用し、最新の Windows AMI を検索して ID を取得できます。

トピック• Get-EC2Image (p. 69)• Get-EC2ImageByName (p. 70)

Get-EC2ImageGet-EC2Image コマンドレットは、使用できる AMI のリストを取得します。

-Owner パラメータに配列値 amazon, self を指定して、Get-EC2Image が、Amazon またはユーザー自身に属する AMI のみを取得するようにします。このコンテキストでは、ユーザーとは、コマンドレットの呼び出しに使用した認証情報を持つユーザーを指します。

PS > Get-EC2Image -Owner amazon, self

-Filter パラメータを使用して結果を絞り込むことができます。フィルタを指定するには、Amazon.EC2.Model.Filter 型のオブジェクトを作成します。たとえば、次のフィルタを使用すると、Windows AMI のみが表示されます

$platform_values = New-Object 'collections.generic.list[string]'$platform_values.add("windows")$filter_platform = New-Object Amazon.EC2.Model.Filter -Property @{Name = "platform"; Values = $platform_values}Get-EC2Image -Owner amazon, self -Filter $filter_platform

次の例は、コマンドレットによって返される AMI の 1 つです。上記のコマンドの実際の出力では、多くのAMI の情報が提供されます。

Architecture : x86_64BlockDeviceMappings : {/dev/sda1, xvdca, xvdcb, xvdcc…}CreationDate : 2019-06-12T10:41:31.000ZDescription : Microsoft Windows Server 2019 Full Locale English with SQL Web 2017 AMI provided by AmazonEnaSupport : TrueHypervisor : xenImageId : ami-000226b77608d973bImageLocation : amazon/Windows_Server-2019-English-Full-SQL_2017_Web-2019.06.12ImageOwnerAlias : amazonImageType : machineKernelId :

69

https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2Image.html

https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2ImageByName.html

AWS Tools for PowerShell ユーザーガイドAMI の検索

Name : Windows_Server-2019-English-Full-SQL_2017_Web-2019.06.12OwnerId : 801119661308Platform : WindowsProductCodes : {}Public : TrueRamdiskId : RootDeviceName : /dev/sda1RootDeviceType : ebsSriovNetSupport : simpleState : availableStateReason : Tags : {}VirtualizationType : hvm

Get-EC2ImageByNameGet-EC2ImageByName コマンドレットを使用すると、ユーザーが関心のあるサーバー設定のタイプに基づいて AWS Windows AMI のリストをフィルタリングできます。

次のようにパラメータを指定せずに実行すると、コマンドレットは、現在のすべてのフィルター名を出力します。

PS > Get-EC2ImageByName

WINDOWS_2016_BASEWINDOWS_2016_NANOWINDOWS_2016_COREWINDOWS_2016_CONTAINERWINDOWS_2016_SQL_SERVER_ENTERPRISE_2016WINDOWS_2016_SQL_SERVER_STANDARD_2016WINDOWS_2016_SQL_SERVER_WEB_2016WINDOWS_2016_SQL_SERVER_EXPRESS_2016WINDOWS_2012R2_BASEWINDOWS_2012R2_COREWINDOWS_2012R2_SQL_SERVER_EXPRESS_2016WINDOWS_2012R2_SQL_SERVER_STANDARD_2016WINDOWS_2012R2_SQL_SERVER_WEB_2016WINDOWS_2012R2_SQL_SERVER_EXPRESS_2014WINDOWS_2012R2_SQL_SERVER_STANDARD_2014WINDOWS_2012R2_SQL_SERVER_WEB_2014WINDOWS_2012_BASEWINDOWS_2012_SQL_SERVER_EXPRESS_2014WINDOWS_2012_SQL_SERVER_STANDARD_2014WINDOWS_2012_SQL_SERVER_WEB_2014WINDOWS_2012_SQL_SERVER_EXPRESS_2012WINDOWS_2012_SQL_SERVER_STANDARD_2012WINDOWS_2012_SQL_SERVER_WEB_2012WINDOWS_2012_SQL_SERVER_EXPRESS_2008WINDOWS_2012_SQL_SERVER_STANDARD_2008WINDOWS_2012_SQL_SERVER_WEB_2008WINDOWS_2008R2_BASEWINDOWS_2008R2_SQL_SERVER_EXPRESS_2012WINDOWS_2008R2_SQL_SERVER_STANDARD_2012WINDOWS_2008R2_SQL_SERVER_WEB_2012WINDOWS_2008R2_SQL_SERVER_EXPRESS_2008WINDOWS_2008R2_SQL_SERVER_STANDARD_2008WINDOWS_2008R2_SQL_SERVER_WEB_2008WINDOWS_2008RTM_BASEWINDOWS_2008RTM_SQL_SERVER_EXPRESS_2008WINDOWS_2008RTM_SQL_SERVER_STANDARD_2008WINDOWS_2008_BEANSTALK_IIS75WINDOWS_2012_BEANSTALK_IIS8VPC_NAT

70

AWS Tools for PowerShell ユーザーガイドインスタンスを起動する

返されるイメージのセットを絞り込むには、Names パラメータに 1 つ以上のフィルタ名を指定します。

PS > Get-EC2ImageByName -Names WINDOWS_2016_CORE

Architecture : x86_64BlockDeviceMappings : {/dev/sda1, xvdca, xvdcb, xvdcc…}CreationDate : 2019-08-16T09:36:09.000ZDescription : Microsoft Windows Server 2016 Core Locale English AMI provided by AmazonEnaSupport : TrueHypervisor : xenImageId : ami-06f2a2afca06f15fcImageLocation : amazon/Windows_Server-2016-English-Core-Base-2019.08.16ImageOwnerAlias : amazonImageType : machineKernelId : Name : Windows_Server-2016-English-Core-Base-2019.08.16OwnerId : 801119661308Platform : WindowsProductCodes : {}Public : TrueRamdiskId : RootDeviceName : /dev/sda1RootDeviceType : ebsSriovNetSupport : simpleState : availableStateReason : Tags : {}VirtualizationType : hvm

Windows PowerShell を使用した Amazon EC2 インスタンスの起動Amazon EC2 インスタンスの起動には、前のセクションで作成したキーペアとセキュリティグループが必要です。また、Amazon Machine Image (AMI) の ID も必要です。詳細については、次のドキュメントを参照してください。

• キーペアを作成する (p. 64)• Windows PowerShell を使用したセキュリティグループの作成 (p. 66)• Windows PowerShell を使用した Amazon Machine Image の検索 (p. 69)

Important

無料利用枠に含まれないインスタンスを起動する場合は、インスタンスを起動すると料金が発生し、そのインスタンスの実行中はアイドル状態であっても料金がかかります。

トピック• EC2-Classic でのインスタンスの起動 (p. 71)• VPC でのインスタンスの起動 (p. 73)• VPC でのスポットインスタンスの起動 (p. 74)

EC2-Classic でのインスタンスの起動次のコマンドは、単一の t1.micro インスタンスを作成して起動します。

71


PS > New-EC2Instance -ImageId ami-c49c0dac ` -MinCount 1 ` -MaxCount 1 ` -KeyName myPSKeyPair ` -SecurityGroups myPSSecurityGroup ` -InstanceType t1.micro

ReservationId : r-b70a0ef1OwnerId : 123456789012RequesterId :Groups : {myPSSecurityGroup}GroupName : {myPSSecurityGroup}Instances : {}

最初、インスタンスは pending 状態ですが、数分後には running 状態になります。インスタンスに関する情報を表示するには、Get-EC2Instance コマンドレットを使用します。複数のインスタンスがある場合は、Filter パラメータを使用して予約 ID の結果をフィルタします。まず、Amazon.EC2.Model.Filter 型のオブジェクトを作成します。次に、フィルターを使用する Get-EC2Instance を呼び出し、Instances プロパティを表示します。

PS > $reservation = New-Object 'collections.generic.list[string]'PS > $reservation.add("r-5caa4371")PS > $filter_reservation = New-Object Amazon.EC2.Model.Filter -Property @{Name = "reservation-id"; Values = $reservation}PS > (Get-EC2Instance -Filter $filter_reservation).Instances

AmiLaunchIndex : 0Architecture : x86_64BlockDeviceMappings : {/dev/sda1}ClientToken :EbsOptimized : FalseHypervisor : xenIamInstanceProfile :ImageId : ami-c49c0dacInstanceId : i-5203422cInstanceLifecycle :InstanceType : t1.microKernelId :KeyName : myPSKeyPairLaunchTime : 12/2/2018 3:38:52 PMMonitoring : Amazon.EC2.Model.MonitoringNetworkInterfaces : {}Placement : Amazon.EC2.Model.PlacementPlatform : WindowsPrivateDnsName :PrivateIpAddress : 10.25.1.11ProductCodes : {}PublicDnsName :PublicIpAddress : 198.51.100.245RamdiskId :RootDeviceName : /dev/sda1RootDeviceType : ebsSecurityGroups : {myPSSecurityGroup}SourceDestCheck : TrueSpotInstanceRequestId :SriovNetSupport :State : Amazon.EC2.Model.InstanceStateStateReason :StateTransitionReason :SubnetId :Tags : {}VirtualizationType : hvmVpcId :

72


VPC でのインスタンスの起動次のコマンドでは、指定したプライベートサブネットで、単一の m1.small インスタンスを作成しています。セキュリティグループは、指定したサブネットに対して有効である必要があります。

PS > New-EC2Instance ` -ImageId ami-c49c0dac ` -MinCount 1 -MaxCount 1 ` -KeyName myPSKeyPair ` -SecurityGroupId sg-5d293231 ` -InstanceType m1.small ` -SubnetId subnet-d60013bf

ReservationId : r-b70a0ef1OwnerId : 123456789012RequesterId :Groups : {}GroupName : {}Instances : {}

最初、インスタンスは pending 状態ですが、数分後には running 状態になります。インスタンスに関する情報を表示するには、Get-EC2Instance コマンドレットを使用します。複数のインスタンスがある場合は、Filter パラメータを使用して予約 ID の結果をフィルタします。まず、Amazon.EC2.Model.Filter 型のオブジェクトを作成します。次に、フィルターを使用する Get-EC2Instance を呼び出し、Instances プロパティを表示します。

PS > $reservation = New-Object 'collections.generic.list[string]'PS > $reservation.add("r-b70a0ef1")PS > $filter_reservation = New-Object Amazon.EC2.Model.Filter -Property @{Name = "reservation-id"; Values = $reservation}PS > (Get-EC2Instance -Filter $filter_reservation).Instances

AmiLaunchIndex : 0Architecture : x86_64BlockDeviceMappings : {/dev/sda1}ClientToken :EbsOptimized : FalseHypervisor : xenIamInstanceProfile :ImageId : ami-c49c0dacInstanceId : i-5203422cInstanceLifecycle :InstanceType : m1.smallKernelId :KeyName : myPSKeyPairLaunchTime : 12/2/2018 3:38:52 PMMonitoring : Amazon.EC2.Model.MonitoringNetworkInterfaces : {}Placement : Amazon.EC2.Model.PlacementPlatform : WindowsPrivateDnsName :PrivateIpAddress : 10.25.1.11ProductCodes : {}PublicDnsName :PublicIpAddress : 198.51.100.245RamdiskId :RootDeviceName : /dev/sda1RootDeviceType : ebsSecurityGroups : {myPSSecurityGroup}SourceDestCheck : TrueSpotInstanceRequestId :SriovNetSupport :

73

AWS Tools for PowerShell ユーザーガイドAWS Lambda および AWS Tools for PowerShell

State : Amazon.EC2.Model.InstanceStateStateReason :StateTransitionReason :SubnetId : subnet-d60013bfTags : {}VirtualizationType : hvmVpcId : vpc-a01106c2

VPC でのスポットインスタンスの起動次のスクリプト例は、指定されたサブネットのスポットインスタンスをリクエストします。セキュリティグループは、指定したサブネットが含まれている VPC 用に作成したものである必要があります。

$interface1 = New-Object Amazon.EC2.Model.InstanceNetworkInterfaceSpecification$interface1.DeviceIndex = 0$interface1.SubnetId = "subnet-b61f49f0"$interface1.PrivateIpAddress = "10.0.1.5"$interface1.Groups.Add("sg-5d293231")Request-EC2SpotInstance ` -SpotPrice 0.007 ` -InstanceCount 1 ` -Type one-time ` -LaunchSpecification_ImageId ami-7527031c ` -LaunchSpecification_InstanceType m1.small ` -Region us-west-2 ` -LaunchSpecification_NetworkInterfaces $interface1

AWS Lambda および AWS Tools for PowerShellAWSLambdaPSCore モジュールを使用すると、.NET Core 2.1 ランタイムを使用して PowerShell Core6.0 の AWS Lambda 関数を開発できます。PowerShell 開発者は、Lambda を使用して PowerShell 環境でAWS リソースを管理し、自動化スクリプトを記述できます。Lambda の PowerShell サポートにより、任意の Lambda イベント (Amazon S3 イベントやスケジュールされた Amazon CloudWatch イベントなど) に応じて PowerShell スクリプトまたは関数を実行できます。AWSLambdaPSCore モジュールは PowerShell の独立した AWS モジュールです。AWS Tools for PowerShell の一部ではありません。また、AWSLambdaPSCore モジュールをインストールしても、AWS Tools for PowerShell はインストールされません。

AWSLambdaPSCore モジュールのインストール後に、既存の PowerShell コマンドレットまたは独自に記述したコマンドレットを使用して、サーバーレス関数を作成できます。AWS Lambda Tools forPowerShell モジュールには、PowerShell ベースのサーバーレスアプリケーション用のプロジェクトテンプレートと、プロジェクトを AWS に発行するためのツールが含まれています。

AWSLambdaPSCore モジュールのサポートは、Lambda をサポートするすべてのリージョンで使用できます。サポートされるリージョンの詳細については、AWS リージョンの表を参照してください。

前提条件AWSLambdaPSCore モジュールをインストールして使用する前に、以下のステップを実行する必要があります。これらのステップの詳細については、AWS Lambda 開発者ガイドの「PowerShell 開発環境の設定」を参照してください。

• PowerShell の適切なリリースのインストール – Lambda での PowerShell のサポートは、クロスプラットフォームの PowerShell Core 6.0 リリースに基づいています。PowerShell Lambda 関数は、Windows、Linux、または Mac で作成できます。このリリースの PowerShell をインストールしていない場合は、Microsoft PowerShell ドキュメントのウェブサイトでインストール手順を参照してください。

74

https://www.powershellgallery.com/packages/AWSLambdaPSCore

https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/

https://docs.aws.amazon.com/lambda/latest/dg/lambda-powershell-setup-dev-environment.html


https://docs.microsoft.com/en-us/powershell/scripting/setup/installing-powershell?view=powershell-6

AWS Tools for PowerShell ユーザーガイドAWSLambdaPSCore モジュールのインストール

• .NET Core 2.1 SDK のインストール – PowerShell Core は .NET Core に基づいているため、Lambdaでの PowerShell のサポートでは同じ .NET Core 2.1 Lambda ランタイムを .NET Core と PowerShellLambda 関数の両方に使用します。Lambda PowerShell でコマンドレットを発行する際は、.NET Core2.1 SDK を使用して Lambda デプロイパッケージを作成します。.NET Core 2.1 SDK は Microsoft ダウンロードセンターから入手できます。ランタイムではなく、SDK を必ずインストールしてください。

AWSLambdaPSCore モジュールのインストール前提条件を満たすと、AWSLambdaPSCore モジュールをインストールする準備が整います。PowerShellCore セッションで次のコマンドを実行します。

PS> Install-Module AWSLambdaPSCore -Scope CurrentUser

これで PowerShell での Lambda 関数の作成を開始できます。開始方法の詳細については、AWS Lambda開発者ガイドの「PowerShell で Lambda 関数を作成するためのプログラミングモデル」を参照してください。

以下の資料も参照してください。• AWS 開発者プログの「Lambda での PowerShell Core のサポートの発表」• PowerShell Gallery ウェブサイトの AWSLambdaPSCore モジュール• PowerShell 開発環境の設定• GitHub の AWS Lambda Tools for PowerShell• AWS Lambda コンソール

Amazon SQS、Amazon SNS、および Tools forWindows PowerShell

このセクションでは、次の方法の例を示します。

• Amazon SQS キューを作成し、キュー ARN (Amazon リソースネーム) を取得します。• Amazon SNS トピックを作成します。• SNS トピックにアクセス許可を付与して、キューにメッセージを送信できるようにします。• キューの SNS トピックへのサブスクライブを行います。• IAM ユーザーまたは AWS アカウントに、SNS トピックに発行し、SQS キューからのメッセージを読む

ためのアクセス許可を与えます。• トピックにメッセージを発行し、キューからのメッセージを読むことで結果を確認します。

Amazon SQS キューの作成およびキュー ARN の取得次のコマンドは、デフォルトのリージョンに SQS キューを作成します。出力には、新しいキューの URLが表示されます。

PS > New-SQSQueue -QueueName myQueuehttps://sqs.us-west-2.amazonaws.com/123456789012/myQueue

次のコマンドは、キューの ARN を取得します。

75

https://www.microsoft.com/net/download

https://www.microsoft.com/net/download

https://docs.aws.amazon.com/lambda/latest/dg/powershell-programming-model.html

http://aws.amazon.com/blogs/developer/announcing-lambda-support-for-powershell-core/

https://www.powershellgallery.com/packages/AWSLambdaPSCore/1.0.0.2


https://github.com/aws/aws-lambda-dotnet/tree/master/PowerShell

https://console.aws.amazon.com/lambda/home

AWS Tools for PowerShell ユーザーガイドAmazon SNS トピックの作成

PS > Get-SQSQueueAttribute -QueueUrl https://sqs.us-west-2.amazonaws.com/123456789012/myQueue -AttributeName QueueArn...QueueARN : arn:aws:sqs:us-west-2:123456789012:myQueue...

Amazon SNS トピックの作成次のコマンドは、デフォルトリージョンに SNS トピックを作成し、新しいトピックの ARN を返します。

PS > New-SNSTopic -Name myTopicarn:aws:sns:us-west-2:123456789012:myTopic

SNS トピックへのアクセス許可の付与次のスクリプト例は、SQS キューと SNS トピックの両方を作成し、SQS キューにメッセージを送信できるように SNS トピックにアクセス許可を付与します。

# create the queue and topic to be associated$qurl = New-SQSQueue -QueueName "myQueue"$topicarn = New-SNSTopic -Name "myTopic"

# get the queue ARN to inject into the policy; it will be returned# in the output's QueueARN member but we need to put it into a variable# so text expansion in the policy string takes effect$qarn = (Get-SQSQueueAttribute -QueueUrl $qurl -AttributeNames "QueueArn").QueueARN

# construct the policy and inject arns$policy = @"{ "Version": "2012-10-17", "Statement": { "Effect": "Allow", "Principal": "*", "Action": "SQS:SendMessage", "Resource": "$qarn", "Condition": { "ArnEquals": { "aws:SourceArn": "$topicarn" } } }}"@

# set the policySet-SQSQueueAttribute -QueueUrl $qurl -Attribute @{ Policy=$policy }

キューの SNS トピックへのサブスクライブを行います。次のコマンドは、SNS トピック myTopic にキュー myQueue をサブスクライブし、サブスクリプションID を返します。

PS > Connect-SNSNotification ` -TopicARN arn:aws:sns:us-west-2:123456789012:myTopic ` -Protocol SQS ` -Endpoint arn:aws:sqs:us-west-2:123456789012:myQueuearn:aws:sns:us-west-2:123456789012:myTopic:f8ff77c6-e719-4d70-8e5c-a54d41feb754

76

AWS Tools for PowerShell ユーザーガイドアクセス許可の付与

アクセス許可の付与次のコマンドでは、トピック myTopic に対して sns:Publish アクションを実行するためのアクセス許可を付与します。

PS > Add-SNSPermission ` -TopicArn arn:aws:sns:us-west-2:123456789012:myTopic ` -Label ps-cmdlet-topic ` -AWSAccountIds 123456789012 ` -ActionNames publish

次のコマンドでは、キュー myQueue の sqs:ReceiveMessage および sqs:DeleteMessage アクションを実行するためのアクセス許可を付与します。

PS > Add-SQSPermission ` -QueueUrl https://sqs.us-west-2.amazonaws.com/123456789012/myQueue ` -AWSAccountId "123456789012" ` -Label queue-permission ` -ActionName SendMessage, ReceiveMessage

結果の確認次のコマンドは、SNS トピック myTopic にメッセージを発行して、新しいキューとトピックをテストし、MessageId を返します。

PS > Publish-SNSMessage ` -TopicArn arn:aws:sns:us-west-2:123456789012:myTopic ` -Message "Have A Nice Day!"728180b6-f62b-49d5-b4d3-3824bb2e77f4

次のコマンドは、SQS キュー myQueue からメッセージを取得し、表示します。

PS > Receive-SQSMessage -QueueUrl https://sqs.us-west-2.amazonaws.com/123456789012/myQueue

Attributes : {}Body : { "Type" : "Notification", "MessageId" : "491c687d-b78d-5c48-b7a0-3d8d769ee91b", "TopicArn" : "arn:aws:sns:us-west-2:123456789012:myTopic", "Message" : "Have A Nice Day!", "Timestamp" : "2019-09-09T21:06:27.201Z", "SignatureVersion" : "1", "Signature" : "llE17A2+XOuJZnw3TlgcXz4C4KPLXZxbxoEMIirelhl3u/oxkWmz5+9tJKFMns1ZOqQvKxk+ExfEZcD5yWt6biVuBb8pyRmZ1bO3hUENl3ayv2WQiQT1vpLpM7VEQN5m+hLIiPFcs vyuGkJReV7lOJWPHnCN+qTE2lId2RPkFOeGtLGawTsSPTWEvJdDbLlf7E0zZ0q1niXTUtpsZ8Swx01X3QO6u9i9qBFt0ekJFZNJp6Avu05hIklb4yoRs1IkbLVNBK/y0a8Yl9lWp7a7EoWaBn0zhCESe7o kZC6ncBJWphX7KCGVYD0qhVf/5VDgBuv9w8T+higJyvr3WbaSvg==", "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-6aad65c2f9911b05cd53efda11f913f9.pem", "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:123456789012:myTopic:22b77de7-a216-4000-9a23-bf465744ca84" }MD5OfBody : 5b5ee4f073e9c618eda3718b594fa257MD5OfMessageAttributes : MessageAttributes : {}MessageId : 728180b6-f62b-49d5-b4d3-3824bb2e77f4

77

AWS Tools for PowerShell ユーザーガイドAWS Tools for Windows PowerShell からの CloudWatch

ReceiptHandle : AQEB2vvk1e5cOKFjeIWJticabkc664yuDEjhucnIOqdVUmie7bX7GiJbl7F0enABUgaI2XjEcNPxixhVc/wfsAJZLNHnl8SlbQa0R/kD+Saqa4OIvfj8x3M4Oh1yM1cVKpYmhAzsYrAwAD5g5FvxNBD6zs +HmXdkax2Wd+9AxrHlQZV5ur1MoByKWWbDbsqoYJTJquCclOgWIak/sBx/daBRMTiVQ4GHsrQWMVHtNC14q7Jy/0L2dkmb4dzJfJq0VbFSX1G+u/lrSLpgae+Dfux646y8yFiPFzY4ua4mCF/SVUn63Spy sHN12776axknhg3j9K/Xwj54DixdsegnrKoLx+ctI+0jzAetBR66Q1VhIoJAq7s0a2MseyOeM/Jjucg6Sr9VUnTWVhV8ErXmotoiEg==

AWS Tools for Windows PowerShell からのCloudWatch

このセクションでは、Tools for Windows PowerShell を使用してカスタムメトリクスデータを CloudWatchに発行する方法の例を示します。

この例では、ユーザーの PowerShell セッションのデフォルトの認証情報とデフォルトのリージョンが設定済みであることを前提としています。

カスタムメトリクスの CloudWatch ダッシュボードへの発行次の PowerShell のコードでは、CloudWatch MetricDatum オブジェクトを初期化して、サービスに送信しています。このオペレーションの結果は、CloudWatch コンソールで確認できます。

$dat = New-Object Amazon.CloudWatch.Model.MetricDatum$dat.Timestamp = (Get-Date).ToUniversalTime()$dat.MetricName = "New Posts"$dat.Unit = "Count"$dat.Value = ".50"Write-CWMetricData -Namespace "Usage Metrics" -MetricData $dat

次の点に注意してください。

• $dat.Timestamp を初期化するために使用する日時情報は、協定世界時 (UTC) 形式で指定する必要があります。

• $dat.Value を初期化するために使用する値は、引用符で囲まれた文字列値または数値 (引用符なし) のどちらかで指定する必要があります。この例は、文字列値を示しています。

以下の資料も参照してください。• AWS Tools for Windows PowerShell の使用 (p. 54)• AmazonCloudWatchClient.PutMetricData (.NET SDK リファレンス)• MetricDatum (サービス API リファレンス)• Amazon CloudWatch コンソール

78

https://console.aws.amazon.com/cloudwatch/home

https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudWatch/MCloudWatchPutMetricDataPutMetricDataRequest.html

https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html

https://console.aws.amazon.com/cloudwatch/home

AWS Tools for PowerShell ユーザーガイドデータ保護

AWS Tools for PowerShell でのセキュリティ

AWS では、クラウドのセキュリティが最優先事項です。AWS のお客様は、セキュリティを最も重視する組織の要件を満たすように構築されたデータセンターとネットワークアーキテクチャーから利点を得られます。

セキュリティは、AWS とお客様の間の共有責任です。責任共有モデルでは、これをクラウドのセキュリティとクラウド内のセキュリティとして説明しています。

• クラウドのセキュリティ – AWS は、AWS クラウド内で AWS サービスを実行するインフラストラクチャを保護する責任を担います。また、AWS は、使用するサービスを安全に提供します。AWSコンプライアンスプログラムの一環として、サードパーティーの監査が定期的にセキュリティの有効性をテストおよび検証しています。AWS Tools for PowerShell に適用されるコンプライアンスプログラムの詳細については、「コンプライアンスプログラムによる AWS 対象範囲内のサービス」を参照してください。

• クラウド内のセキュリティ – お客様の責任はお客様が使用する AWS のサービスによって決まります。また、お客様は、お客様のデータの機密性、企業の要件、および適用可能な法律および規制などの他の要因についても責任を担います。

このドキュメントは、AWS Tools for PowerShell を使用する際に責任共有モデルを適用する方法を理解するのに役立ちます。以下のトピックでは、セキュリティおよびコンプライアンスの目的を達成するように AWS Tools for PowerShell を設定する方法を示します。また、AWS Tools for PowerShell を使用して、AWS リソースのモニタリングとセキュリティ保護を行う方法についても説明します。

トピック• AWS Tools for PowerShell でのデータ保護 (p. 79)• AWS Tools for PowerShell の Identity and Access Management (p. 80)• AWS Tools for PowerShell のコンプライアンス検証 (p. 81)

AWS Tools for PowerShell でのデータ保護AWS Tools for PowerShell は、データ保護の規制やガイドラインを含む AWS 責任共有モデルに準拠しています。AWS は、AWS のすべてのサービスを実行するグローバルなインフラストラクチャを保護する責任を負います。また、AWS は、カスタマーコンテンツや個人データを取り扱うためのセキュリティ設定の管理など、このインフラストラクチャでホストされるデータの管理を担当します。AWS のお客様およびAPN パートナーは、データ管理者やデータ処理者として AWS クラウドに保存した個人データに責任を負います。

データ保護目的の場合、AWS アカウント認証情報を保護して IAM (AWS Identity and AccessManagement) で個々のユーザーアカウントをセットアップし、そのユーザーに各自の職務を果たすために必要なアクセス許可のみが付与されるようにすることをお勧めします。また、以下の方法でデータを保護することをお勧めします。

• 各アカウントで多要素認証 (MFA) を使用します。• SSL/TLS を使用して AWS リソースと通信します。• AWS CloudTrail で API とユーザーアクティビティログをセットアップします。• AWS 暗号化ソリューションを、AWS サービス内のすべてのデフォルトのセキュリティ管理と一緒に使

用します。

79

http://aws.amazon.com/compliance/shared-responsibility-model/

http://aws.amazon.com/compliance/programs/


http://aws.amazon.com/compliance/services-in-scope/

http://aws.amazon.com/compliance/shared-responsibility-model/

AWS Tools for PowerShell ユーザーガイドデータの暗号化

• Amazon Macie などの高度なマネージドセキュリティサービスを使用します。これにより、Amazon S3に保存される個人データの検出と保護が支援されます。

顧客のアカウント番号などの機密の識別情報は、[名前] フィールドなどの自由形式のフィールドに配置しないことを強くお勧めします。これは、AWS Tools for PowerShell を操作する場合や、コンソール、API、または AWS SDK を使用する AWS の他のサービスを操作する場合も同様です。AWS Tools forPowerShell や他のサービスに入力したすべてのデータは、診断ログに取り込まれる場合があります。外部サーバーへの URL を指定するときは、そのサーバーへのリクエストを検証するための認証情報を URL に含めないでください。

データ保護の詳細については、AWS セキュリティブログのブログ投稿「AWS の責任共有モデルとGDPR」を参照してください。

データの暗号化セキュリティで保護されたサービスの重要な特徴として、情報はアクティブに使用されていないときに暗号化されます。

保管時の暗号化AWS Tools for PowerShell は、ユーザに代わって AWS のサービスとやり取りするために必要な認証情報を除き、それ自体にカスタマーデータを保存することはありません。

AWS Tools for PowerShell を使用して、カスタマーデータをローカルコンピュータに転送して保存するAWS のサービスを呼び出す場合は、そのサービスのユーザーガイドの「セキュリティ & コンプライアンス」の章で、データの保存、保護、および暗号化の方法を参照してください。

転送中の暗号化デフォルトでは、AWS Tools for PowerShell や AWS のサービスのエンドポイントを実行しているクライアントコンピュータから転送されるすべてのデータは、HTTPS/TLS 接続を介した送信により、すべてが暗号化されます。

HTTPS/TLS の使用を有効にするために必要な操作はありません。常に有効になっています。

AWS Tools for PowerShell の Identity and AccessManagement

AWS Tools for PowerShell は、AWS マネジメントコンソールで AWS リソースとそのサービスにアクセスするために使用するのと同じ IAM ユーザーとロールを使用します。アクセス許可を付与するポリシーも同様です。これは、AWS Tools for PowerShell が呼び出す API オペレーションが、サービスコンソールで使用されるものと同じであるためです。詳細については、使用する AWS のサービスで「セキュリティ」章の「Identity and Access Management」を参照してください。

唯一の大きな違いは、標準の IAM ユーザーと長期の認証情報を使用する場合の認証方法です。IAM ユーザーは AWS のサービスのコンソールにアクセスする場合にパスワードを必要としますが、同じ IAM ユーザーが AWS Tools for PowerShell を使用して同じオペレーションを実行する場合はパスワードの代わりにアクセスキーを必要とします。他のすべての短期の認証情報については、使用方法がコンソールと同じです。

AWS Tools for PowerShell で使用される認証情報は、通常、プレーンテキストファイルに保存され、暗号化されません。ただし、Windows で実行する場合は、暗号化された .NET SDK 認証情報ストアを使用するオプションがあります。

80

http://aws.amazon.com/blogs/security/the-aws-shared-responsibility-model-and-gdpr/

http://aws.amazon.com/blogs/security/the-aws-shared-responsibility-model-and-gdpr/

AWS Tools for PowerShell ユーザーガイドコンプライアンス検証

• $HOME/.aws/credentials には、AWS リソースにアクセスするために必要な長期の認証情報が保存されます。これには、アクセスキー ID とシークレットアクセスキーが含まれます。

リスクの軽減

• $HOME/.aws フォルダとその子フォルダおよびファイルに対して、許可されたユーザーにのみアクセスを制限するようにファイルシステムのアクセス許可を設定することを強くお勧めします。

• 一時的な認証情報を持つロールをできるだけ使用し、認証情報が漏洩した場合の損害の可能性を減らします。長期の認証情報は、短期のロールの認証情報を要求および更新する場合にのみ使用します。

AWS Tools for PowerShell のコンプライアンス検証サードパーティーの監査者は、複数の AWS コンプライアンスプログラムの一部として AWS のサービスのセキュリティとコンプライアンスを評価します。AWS Tools for PowerShell を使用してサービスにアクセスしても、そのサービスのコンプライアンスは変わりません。

特定のコンプライアンスプログラムの対象となる AWS サービスのリストについては、「コンプライアンスプログラムによる AWS 対象範囲内のサービス」を参照してください。一般的な情報については、「AWS コンプライアンスプログラム」を参照してください。

サードパーティーの監査レポートをダウンロードするには、AWS Artifact を使用します。詳細については、「AWS Artifact でレポートをダウンロードする」を参照してください。

AWS Tools for PowerShell サービスを使用する際のお客様のコンプライアンス責任は、データの機密性、貴社のコンプライアンス目的、適用法規によって決まります。AWS では、コンプライアンスに役立つ以下のリソースを用意しています。

• セキュリティおよびコンプライアンスのクイックスタートガイド – これらのデプロイガイドでは、アーキテクチャー上の考慮事項について説明し、セキュリティとコンプライアンスに重点を置いたベースライン環境を AWS でデプロイするための手順を説明します。

• HIPAA のセキュリティとコンプライアンスに関するホワイトペーパーを作成する – このホワイトペーパーでは、企業が AWS を使用して HIPAA 準拠のアプリケーションを作成する方法について説明します。

• AWS コンプライアンスのリソース – このワークブックおよびガイドのコレクションは、お客様の業界や場所に適用される場合があります。

• AWS Config 開発者ガイドの「ルールでのリソースの評価」– AWS Config サービスでは、リソース設定が社内のプラクティス、業界のガイドライン、規制にどの程度適合しているかを評価します。

• AWS Security Hub – この AWS サービスでは、AWS 内のセキュリティ状態を包括的に表示しており、セキュリティ業界の標準およびベストプラクティスへの準拠を確認するのに役立ちます。

81




https://docs.aws.amazon.com/artifact/latest/ug/downloading-documents.html

http://aws.amazon.com/quickstart/?awsf.quickstart-homepage-filter=categories%23security-identity-compliance

https://d0.awsstatic.com/whitepapers/compliance/AWS_HIPAA_Compliance_Whitepaper.pdf

http://aws.amazon.com/compliance/resources/

https://docs.aws.amazon.com/config/latest/developerguide/evaluate-config.html

https://docs.aws.amazon.com/securityhub/latest/userguide/what-is-securityhub.html


ドキュメント履歴このトピックでは、AWS Tools for PowerShell のドキュメントに対する重要な変更について説明します。

また、お客様からのフィードバックに応じて、定期的にドキュメントを更新します。トピックに関するフィードバックを送信するには、「このページは役に立ちましたか?」の横にある [フィードバック] ボタンを使用します。

AWS Tools for PowerShell の変更と更新の詳細については、リリースノートを参照してください。

update-history-change update-history-description update-history-date

AWS Tools for PowerShell バージョン 4 (p. 82)

バージョン 4 に関する情報を追加しました。この情報には、Windows と Linux/macOSの両方へのインストール手順、バージョン 3 との相違点と新機能を示す移行トピックが含まれます。

November 21, 2019

AWS Tools for PowerShell3.3.563 (p. 82)

AWS.Tools.Common モジュールのプレビューバージョンをインストールして使用する方法についての情報を追加しました。この新しいモジュールは、古いモノリシックパッケージを 1 つの共有モジュールと AWS サービスごとに 1 つのモジュールに分割します。

October 18, 2019

AWS Tools for PowerShell3.3.343.0 (p. 82)

「AWS Tools for PowerShellの使用」セクションに、PowerShell Core 開発者がAWS Lambda 関数を作成する際に役立つ AWS Lambda Tools forPowerShell に関する情報を追加しました。

September 11, 2018

AWS Tools for WindowsPowerShell 3.1.31.0 (p. 82)

「開始方法」セクションに新しいコマンドレットに関する情報を追加しました。これらのコマンドレットでは、Security AssertionMarkup Language (SAML) を使用してユーザーのフェデレーティッド ID を設定できます。

December 1, 2015

AWS Tools for WindowsPowerShell 2.3.19 (p. 82)

「コマンドレットの検出とエイリアス」セクションに新しい Get-AWSCmdletName コマンドレットに関する情報を追加しました。このコマンドレットを使用すると、目的の AWS コマンドレットを見つけやすくなります。

February 5, 2015


コマンドレットからのコレクション出力は、常に、PowerShell

May 15, 2013

82

https://aws.amazon.com/releasenotes/PowerShell

url-doc-domain;powershell/latest/userguide/pstools-getting-set-up-windows.html

url-doc-domain;powershell/latest/userguide/pstools-getting-set-up-linux-mac.html

url-doc-domain;powershell/latest/userguide/v4migration.html

https://docs.aws.amazon.com/powershell/latest/userguide/pstools-using.html

https://docs.aws.amazon.com/powershell/latest/userguide/pstools-using.html

https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-started.html

https://docs.aws.amazon.com/powershell/latest/userguide/pstools-discovery-aliases.html

https://docs.aws.amazon.com/powershell/latest/userguide/pstools-discovery-aliases.html


パイプラインに列挙されます。ページング可能なサービス呼び出しの自動サポート。新しい$AWSHistory シェル変数は、サービス応答を収集し、必要に応じてサービスリクエストを収集します。AWSRegion インスタンスは、パイプラインをサポートするために SystemNameではなくリージョンフィールドを使用します。Remove-S3Bucket は、-DeleteObjects スイッチオプションをサポートします。Set-AWSCredentials のユーザビリティの問題が修正されました。Initialize-AWSDefaultsは、認証情報とリージョンデータを取得した場所からレポートします。Stop-EC2Instanceは、Amazon.EC2.Model.Reservationインスタンスを入力として受け入れます。汎用 List<T> パラメータタイプは、配列タイプ (T[]) に置き換えられました。リソースを削除または終了するコマンドレットは、削除する前に確認プロンプトを表示します。Write-S3Objectは、Amazon S3 にアップロードするインラインテキストコンテンツをサポートします。

83



Tools for Windows PowerShellモジュールのインストール場所が変更され、WindowsPowerShell バージョン 3 を使用する環境で自動ロードを利用できるようになりました。モジュールとサポートファイルは、AWS ToolsPowerShellの下の AWSPowerShell サブフォルダにインストールされるようになりました。AWSToolsPowerShell フォルダに存在する旧バージョンのファイルは、インストーラによって自動的に削除されます。WindowsPowerShell の PSModulePath(すべてのバージョン) は、このリリースで更新され、モジュール (AWS ToolsPowerShell) の親フォルダを含むようになりました。Windows PowerShell バージョン 2 を使用するシステムの場合、スタートメニューショートカット [Windows PowerShellfor AWS] が更新され、新しい場所からモジュールをインポートし、Initialize-AWSDefaults を実行します。Windows PowerShell バージョン 3 を使用するシステムの場合、スタートメニューショートカット [WindowsPowerShell for AWS] が更新され、Import-Module コマンドが削除されて、Initialize-AWSDefaults だけになります。Import-Module ファイルの AWSPowerShell.psd1 を実行するために PowerShell プロファイルを編集した場合、ファイルの新しい場所を参照するように更新する必要があります (または、PowerShell バージョン 3を使用している場合、Import-Module ステートメントは不要なため、削除します)。この変更の結果として、Tools for WindowsPowerShell モジュールは、Get-Module -ListAvailable を実行したときに使用可能なモジュールとして表示されるようになりました。また、WindowsPowerShell バージョン 3 のユーザーの場合、モジュールによってエクスポートされるコマンドレットの実行は、最初に Import-Module を使用しなくても、現在

December 21, 2012

84


の PowerShell シェルでモジュールを自動的にロードします。これにより、スクリプトの実行を許可しない実行ポリシーのあるシステムで、コマンドレットをインタラクティブに使用できるようになりました。


初回リリース December 6, 2012

85

AWS Tools for PowerShell - ユーザーガイド...AWS Tools for PowerShell ユーザーガイド...

Documents

Transcript of AWS Tools for PowerShell - ユーザーガイド...AWS Tools for PowerShell ユーザーガイド...