AWS Tools for PowerShell V4 がメンテナンスモードになりました。
[AWS Tools for PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/) に移行することをお勧めします。移行方法の詳細と情報については、[メンテナンスモードのお知らせ](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# で AWS のサービスを操作する AWS Tools for PowerShell
このセクションでは、 AWS Tools for PowerShell を使用して AWS サービスにアクセスする例を示します。これらの例は、 コマンドレットを使用して実際の AWS タスクを実行する方法を示すのに役立ちます。これらの例は、Tools for PowerShell が提供するコマンドレットに依存しています。使用できるコマンドレットについては、「[AWS Tools for PowerShell コマンドレットリファレンス](https://docs.aws.amazon.com/powershell/v4/reference/)」を参照してください。
## PowerShell ファイルの連結エンコード
のいくつかのコマンドレットは、既存のファイルまたはレコード AWS Tools for PowerShell を編集します AWS。一例は `Edit-R53ResourceRecordSet` です。これは Amazon Route 53 の [ChangeResourceRecordSets](https://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets.html) 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` パラメータを持つコマンドレット、および連結されたファイル出力のエンコードを修正できるコマンドレットの詳細なリストについては、次のコマンドを実行します。
```
PS > Get-Command -ParameterName "Encoding"
```
**注記**
PowerShell Core を含む PowerShell 6.0 以降では、連結されたファイル出力の UTF-8 エンコードが自動的に保持されます。
## PowerShell ツールに対して返されるオブジェクト
ネイティブ PowerShell 環境で AWS Tools for PowerShell より便利なように、 AWS Tools for PowerShell コマンドレットによって返されるオブジェクトは .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](pstools-ec2.md)
このセクションでは、以下の方法を含む、Amazon EC2 インスタンスを起動するために必要な手順について説明します。
+ Amazon Machine Image (AMI) のリストを取得する
+ SSH 認証のキーペアを作成する
+ Amazon EC2 セキュリティグループを作成して設定する。
+ インスタンスの起動、インスタンスに関する情報を取得する
## [Amazon S3](pstools-s3.md)
このセクションでは、Amazon S3 でホストされる静的ウェブサイトを作成するために必要な手順について説明します。以下の方法について説明します。
+ Amazon S3 バケットの作成と削除を行う
+ Amazon S3 バケットへのオブジェクトとしてファイルをアップロードする
+ Amazon S3 バケットからオブジェクトを削除する
+ Amazon S3 バケットをウェブサイトとして指定する
## [AWS Lambda および AWS Tools for PowerShell](pstools-lambda.md)
このセクションでは、 AWS Lambda Tools for PowerShell モジュールの概要と、モジュールのセットアップに必要な手順について説明します。
## [Amazon SNS と Amazon SQS](pstools-sqs-queue-sns-topic.md)
このセクションでは、Amazon SQS キューを Amazon SNS トピックにサブスクライブするために必要なステップについて説明します。以下の方法について説明します。
+ Amazon SNS トピックを作成します。
+ Amazon SQS キューを作成します。
+ キューをトピックにサブスクライブする。
+ メッセージをトピックに送信する。
+ キューからメッセージを受信する。
## [CloudWatch](pstools-cw.md)
このセクションでは、カスタムデータを CloudWatch に発行する方法を例を挙げて説明します。
+ カスタムメトリクスを CloudWatch ダッシュボードに発行する。
## 以下の資料も参照してください。
+ [AWS Tools for Windows PowerShell の開始方法](pstools-getting-started.md)
## トピック
+ [Amazon S3 と Tools for Windows PowerShell](pstools-s3.md)
+ [Amazon EC2 と Tools for Windows PowerShell](pstools-ec2.md)
+ [AWS Lambda および AWS Tools for PowerShell](pstools-lambda.md)
+ [Amazon SQS、Amazon SNS、および Tools for Windows PowerShell](pstools-sqs-queue-sns-topic.md)
+ [の CloudWatch AWS Tools for Windows PowerShell](pstools-cw.md)
+ [コマンドレットでの ClientConfig パラメータの使用](pstools-clientconfig.md)