PowerShell ファイルの連結エンコード PowerShell ツールに対して返されるオブジェクト Amazon EC2 Amazon S3 AWS Lambda および AWS Tools for PowerShell Amazon SNS と Amazon SQS CloudWatch 以下も参照してください。トピック

AWS Tools for PowerShell での AWS サービスの操作

このセクションでは、AWS Tools for PowerShell を使用して AWS のサービスにアクセスする例を示します。以下の例では、コマンドレットを使用して実際の AWS タスクを実行する方法を示します。これらの例は、Tools for PowerShell が提供するコマンドレットに依存しています。使用できるコマンドレットについては、「AWS Tools for PowerShell コマンドレットリファレンス」を参照してください。

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 パラメータを持つコマンドレット、および連結されたファイル出力のエンコードを修正できるコマンドレットの詳細なリストについては、次のコマンドを実行します。


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 プロパティとしても添付されます。