AWS Tools for PowerShell バージョン 5 (V5) はプレビュー版であるため、このコンテンツは変更される可能性があります。重大な変更、インストール、移行については、移行トピックを参照してください。リリースされたコンテンツについては、代わりにバージョン 4 ユーザーガイドを参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS Tools for PowerShell バージョン 4 からバージョン 5 への移行
AWS Tools for PowerShell バージョン 5 (V5) には重大な変更があるため、既存のスクリプトが機能しなくなる可能性があります。このトピックでは、V5 の重大な変更と、V4 から環境またはコードを移行するために必要となる可能性のある作業について説明します。のその他の注目すべき変更 AWS Tools for PowerShell、および新しいバージョンをインストールしてテストする方法の詳細については、GitHub の「開発トラッカーの問題」を参照してくださいhttps://github.com/aws/aws-tools-for-powershell/issues/357
注記
は AWS Tools for PowerShell に依存するため AWS SDK for .NET、SDK の V4 に関連する変更の一部は Tools for PowerShell の V5 にも影響する可能性があります。の V4 で何が変更されたかを確認するには AWS SDK for .NET、「 AWS SDK for .NET デベロッパーガイド」の「移行情報」を参照してください。
PowerShell の最小バージョン
レガシー Windows 固有のシングルラージモジュールバージョンの AWSPowerShell AWS Tools for PowerShellでは、モジュールのサポートされている最小 PowerShell バージョンが 5.1 に更新されました。これは、.NET Framework 4.7.2 AWS SDK for .NET の新しい最小バージョンと一致するためです。
AWSPowerShell モジュールの詳細については、「」を参照してくださいWindows でのインストール。
値タイプ
から採用されたタイプ AWS SDK for .NET は、SDK の新しい null 可能な変更を使用するように更新されました。たとえば、 タイプのプロパティintが に変更されましたNullable[int]。詳細については、 AWS SDK for .NET デベロッパーガイドの Value タイプの移行コンテンツを参照してください。
コレクション
一部のコマンドレット出力は、空のコレクション$nullではなく を返すように変更されました。レガシー動作に戻す方法などの詳細については、「 AWS SDK for .NET デベロッパーガイド」の「 コレクションの移行コンテンツ」を参照してください。
パイプラインと $AWSHistory
V4 AWS Tools for PowerShell より前のバージョンの では、コマンドレット呼び出しと、呼び出しごとに受信したサービスレスポンスの記録を保持する AWS というセッション変数が導入され$AWSHistoryました。Tools for PowerShell の V4 では、このセッション変数は、サービスレスポンス全体を返すために使用できる -Select *パラメータと 引数を優先して廃止されました。このパラメータについては、「」を参照してくださいパイプライン、出力、イテレーション。
の V5 では AWS Tools for PowerShell、 $AWSHistory変数は削除されました。詳細については、ブログ記事AWS 「Tools for PowerShell の今後のメジャーバージョン 5 のお知らせ
認証情報とプロファイルの解決
コマンドレットの認証情報を解決するときに特定の環境変数を使用するように が更新され AWS Tools for PowerShell ました: AWS_PROFILE、AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、および AWS_SESSION_TOKEN。さらに、認証情報とプロファイルの解決順序にいくつかの変更があります。詳細については、「認証情報とプロファイルの解決」を参照してください。
一貫した自動反復
ページ分割されたコマンドレットはすべて、デフォルトですべてのデータを自動的に反復するように更新されました。Set-AWSAutoIterationMode コマンドレットを使用して、この動作を元に戻すことができます。を実行するとSet-AWSAutoIterationMode -IterationMode v4、v4 で自動反復されたオペレーションは引き続き自動反復されますが、残りは手動反復に戻ります。
S3 キーパラメータのクリーニング
キーパラメータを受け入れる特定の Amazon S3 コマンドレットKey、および ではKeyPrefix、ツールのバージョン 4 は、先頭のスペース、スラッシュ (「/」）、バックスラッシュ (「」) を削除し、他のすべてのバックスラッシュをスラッシュに変換し、末尾のスペースを削除します。この動作に戻すには、 -EnableLegacyKeyCleaningパラメータを指定します。
この情報は、次のコマンドレットに適用されます。
