のバージョン 5 (V5) AWS Tools for PowerShell がリリースされました。 重要な変更とアプリケーションの移行については、[「移行トピック](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)」を参照してください。 [https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # AWS Tools for PowerShell バージョン 4 からバージョン 5 への移行 AWS Tools for PowerShell バージョン 5 (V5) には重大な変更があるため、既存のスクリプトが機能しなくなる可能性があります。このトピックでは、V5 の重大な変更と、V4 から環境またはコードを移行するために必要となる可能性のある作業について説明します。 の注目すべき変更の詳細については、以下のリソース AWS Tools for PowerShell も参照してください。 + ブログ投稿 [AWS Tools for PowerShell V5 が一般公開されました](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v5-now-generally-available/)。 + [GitHub の V5 Development Tracker の問題](https://github.com/aws/aws-tools-for-powershell/issues/357)。重要な変更のリストに加えて、必ず各プレビューの詳細を確認してください。 + ブログ記事 Preview [1 of AWS Tools for PowerShell V5](https://aws.amazon.com/blogs/developer/preview-1-of-aws-tools-for-powershell-v5/) **注記** は AWS Tools for PowerShell に依存するため AWS SDK for .NET、SDK の V4 に関連する変更の一部は Tools for PowerShell の V5 にも影響する可能性があります。の V4 で何が変更されたかを確認するには AWS SDK for .NET、「 [AWS SDK for .NET デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/)」の[「移行情報](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html)」を参照してください。 ## PowerShell の最小バージョン *AWSPowerShell* AWS Tools for PowerShellと呼ばれるレガシーの Windows 固有のシングルラージモジュールバージョンでは、モジュールのサポートされている最小 PowerShell バージョンが 5.1 に更新されました。これは、.NET Framework 4.7.2 AWS SDK for .NET の新しい最小バージョンと一致するためです。 レガシー AWSPowerShell モジュールの詳細については、「」を参照してください[Windows でのインストール](pstools-getting-set-up-windows.md)。 ## `AWS.Tools` V4 のインストールまたは更新 AWS Tools for PowerShellと呼ばれる のモジュール化されたバージョンをインストールまたは更新する場合`AWS.Tools`、 コマンドレット`Install-AWSToolsModule`と コマンドレットは`AWS.Tools`デフォルトで のバージョン 5 `Update-AWSToolsModule` を使用します。何らかの理由で のバージョン 4 をインストールまたは更新する必要がある場合は`AWS.Tools`、それぞれ次のコマンドを使用してインストールできます。 ``` Install-AWSToolsModule -MaximumVersion '4.9.999' Update-AWSToolsModule -MaximumVersion '4.9.999' ``` Tools for PowerShell のインストールと更新の詳細については、「」を参照してください。 [はじめに](pstools-getting-set-up.md) ## CTRL\$1C を使用してコマンドレット実行をキャンセルする のバージョン 5 AWS Tools for PowerShell では、Ctrl\$1C などのキーボードショートカットを使用してコマンドレットの実行をキャンセルできます。 ## Nullable 値タイプ から採用されたタイプ AWS SDK for .NET は、SDK の新しい NULL 可能な変更を使用するように更新されました。たとえば、 タイプのプロパティ`int`が に変更されました`Nullable[int]`。この変更は、AWS コマンドレットの入力パラメータ値を指定する方法には影響しません。これらの値タイプのパラメータは既に nullable としてモデル化されているためです。ただし、コマンドレット出力の NULL 可能な型は重大な変更です。コマンドレット出力内のプロパティには、型のさまざまなデフォルト値`$null`の代わりに が含まれるためです。 次の例は、 Tools for PowerShell の V4 の動作を示しています。この例では、 `MissingMeta`プロパティは 型のデフォルト値であるため、0 に設定されています`int`。 ``` # In V4 PS > Get-S3ObjectMetadata -BucketName amzn-s3-demo-bucket -Key 'test' | >> Select LastModified, MissingMeta, ObjectLockRetainUntilDate, BucketKeyEnabled LastModified MissingMeta ObjectLockRetainUntilDate BucketKeyEnabled ------------ ----------- ------------------------- ---------------- 8/29/2023 10:20:44 PM 0 1/1/0001 12:00:00 AM ``` 次の例は、 Tools for PowerShell の V5 の動作を示しています。この例では、 `MissingMeta`プロパティは に設定されています`$null`。 ``` # In V5 PS > Get-S3ObjectMetadata -BucketName amzn-s3-demo-bucket -Key 'test' | >> Select LastModified, MissingMeta, ObjectLockRetainUntilDate, BucketKeyEnabled LastModified MissingMeta ObjectLockRetainUntilDate BucketKeyEnabled ------------ ----------- ------------------------- ---------------- 8/29/2023 10:20:44 PM ``` ほとんどの場合、PowerShell には null 可能な値型から null 不可能な値型への暗黙的な変換があるため、コードを変更する必要はありません。ただし、これは NULL 可能な値タイプのデフォルト値を明示的にチェックする比較ロジックコードの重大な変更です。null 不可能なタイプのデフォルト値をチェックする比較ロジックは、 をチェックするように変更する必要があります`$null`。 これらのタイプの一部について、次の例は、何も返されなかったかどうかを確認する V4 用に記述されたコードを更新する方法を示しています。 ``` #Type int: # In V4, if you were checking whether an int is 0... if($s3Metadata.MissingMeta -eq 0){} # In V5, check if the int is null instead: if($s3Metadata.MissingMeta -eq $null) {} # Type datetime: # In V4, if you were checking whether a datetime is '0001-01-01'... if($s3Metadata.ObjectLockRetainUntilDate -eq '0001-01-01'){} # In V5, check if the datetime is null instead: if($s3Metadata.ObjectLockRetainUntilDate -eq $null){} # Type boolean: # In V4, if you were checking whether a boolean is $false... if($s3Metadata.BucketKeyEnabled -eq $false){} # In V5, check if the boolean is null instead: if($s3Metadata.BucketKeyEnabled -eq $null) ``` は AWS Tools for PowerShell に依存するため AWS SDK for .NET、同様の変更が SDK のバージョン 4 にどのように影響したかを調べると役立つ場合があります。この情報を確認するには、「 [AWS SDK for .NET デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/)」の[「Value types](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html#net-dg-v4-value-types) migration content」を参照してください。 ## コレクション 一部のコマンドレット出力は、タイプ `List`または の空のコレクション`$null`ではなく、 を返すように変更されました`Dictionary`。レガシー動作に戻す方法などの詳細については、「 [AWS SDK for .NET デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/)」の[「 コレクションの移行コンテンツ](https://docs.aws.amazon.com/sdk-for-net/v4/developer-guide/net-dg-v4.html#net-dg-v4-collections)」を参照してください。 ## DateTime と UTC DateTime 一部の V4 コマンドレットは、古い DateTime パラメータと代替の UTC DateTime パラメータを定義します。これらの古い DateTime パラメータは V5 コマンドレットから削除され、UTC DateTime パラメータの名前は UTC DateTime 以外のパラメータの元の名前に変更されました。 この変更が実装されたコマンドレットの例を次に示します。 + `Get-ASScheduledAction` ([V4 コマンドレット](https://docs.aws.amazon.com/powershell/v4/reference/items/Get-ASScheduledAction.html)と [V5 コマンドレット](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-ASScheduledAction.html)): + `StartTime` パラメータが削除され、`UtcStartTime`パラメータの名前がStartTime」に変更されました。 + `EndTime` パラメータが削除され、`UtcEndTime`パラメータの名前がEndTime」に変更されました。 + `Copy-S3Object` ([V4 コマンドレット](https://docs.aws.amazon.com/powershell/v4/reference/items/Copy-S3Object.html)と [V5 コマンドレット](https://docs.aws.amazon.com/powershell/v5/reference/items/Copy-S3Object.html)): + `ModifiedSinceDate` パラメータが削除され、`UtcModifiedSinceDate`パラメータの名前がModifiedSinceDate」に変更されました。 + `UnmodifiedSinceDate` パラメータが削除され、`UtcUnmodifiedSinceDate`パラメータの名前がUnmodifiedSinceDate」に変更されました。 この変更の影響を受けるコマンドレットの完全なリストを次に示します。 ### を開いて項目を表示する + [Get-ASScheduledAction](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-ASScheduledAction.html) + [Write-ASScheduledUpdateGroupAction](https://docs.aws.amazon.com/powershell/v5/reference/items/Write-ASScheduledUpdateGroupAction.html) + [Get-CWAlarmHistory](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-CWAlarmHistory.html) + [Get-CWMetricData](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-CWMetricData.html) + [Get-CWMetricStatistic](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-CWMetricStatistic.html) (エイリアス Get-CWMetricStatistics) + [New-EC2Fleet](https://docs.aws.amazon.com/powershell/v5/reference/items/New-EC2Fleet.html) + [Get-EC2FleetHistory](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2FleetHistory.html) + [Get-EC2ScheduledInstance](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2ScheduledInstance.html) + [Get-EC2ScheduledInstanceAvailability](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2ScheduledInstanceAvailability.html) + [Get-EC2SpotFleetRequestHistory](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2SpotFleetRequestHistory.html) + [Get-EC2SpotPriceHistory](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EC2SpotPriceHistory.html) + [Import-EC2Image](https://docs.aws.amazon.com/powershell/v5/reference/items/Import-EC2Image.html) + [Import-EC2Snapshot](https://docs.aws.amazon.com/powershell/v5/reference/items/Import-EC2Snapshot.html) + [Request-EC2SpotFleet](https://docs.aws.amazon.com/powershell/v5/reference/items/Request-EC2SpotFleet.html) + [Request-EC2SpotInstance](https://docs.aws.amazon.com/powershell/v5/reference/items/Request-EC2SpotInstance.html) + [Send-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/v5/reference/items/Send-EC2InstanceStatus.html) + [Get-ECEvent](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-ECEvent.html) + [Get-EBEnvironment](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EBEnvironment.html) + [Get-EBEvent](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-EBEvent.html) + [Get-IOTTaskList](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-IOTTaskList.html) + [Get-IOTViolationEventList](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-IOTViolationEventList.html) + [Get-RDSEvent](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-RDSEvent.html) + [Reset-RDSDBCluster](https://docs.aws.amazon.com/powershell/v5/reference/items/Reset-RDSDBCluster.html) + [Restore-RDSDBClusterToPointInTime](https://docs.aws.amazon.com/powershell/v5/reference/items/Restore-RDSDBClusterToPointInTime.html) + [Restore-RDSDBInstanceToPointInTime](https://docs.aws.amazon.com/powershell/v5/reference/items/Restore-RDSDBInstanceToPointInTime.html) + [Get-RSClusterSnapshot](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-RSClusterSnapshot.html) (エイリアス Get-RSClusterSnapshots) + [Get-RSEvent](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-RSEvent.html) (エイリアス Get-RSEvents) + [Copy-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Copy-S3Object.html) + [Read-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Read-S3Object.html) + [Get-S3ObjectMetadata](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ObjectMetadata.html) + [Send-SESBounce](https://docs.aws.amazon.com/powershell/v5/reference/items/Send-SESBounce.html) + [Get-WDActivity](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-WDActivity.html) ## パイプラインと `$AWSHistory` V4 AWS Tools for PowerShell より前のバージョンの では、コマンドレット呼び出しと、呼び出しごとに受信したサービスレスポンスの記録を保持する AWS というセッション変数が導入され`$AWSHistory`ました。 Tools for PowerShell の V4 では、このセッション変数は廃止され、代わりにサービスレスポンス全体を返すための `-Select *` パラメータと引数が推奨されるようになりました。`-Select *` パラメータについては、「」を参照してください[パイプライン、出力、イテレーション](pstools-pipelines.md)。 Tools for PowerShell の V5 では、`$AWSHistory`セッション変数が完全に削除されました。その結果、 `Set-AWSHistoryConfiguration` コマンドレット`Clear-AWSHistory`と コマンドレットも削除されました。 ## `-PassThru` パラメータ `-PassThru` パラメータは削除されました。コマンドレットがデフォルトで出力を返さない場合、ユーザーは を使用して返されたパラメータ値をリクエストできます`-Select ^ParameterName`。詳細と例については、ブログ記事[V5 の AWS Tools for PowerShell プレビュー 1](https://aws.amazon.com/blogs/developer/preview-1-of-aws-tools-for-powershell-v5/)」を参照してください。 ## 一部の DynamoDB コマンドレットが移動および名前変更されました コマンドレット`Get-DDBStream`と `Get-DDBStreamList` コマンドレットが DynamoDBV2 モジュールから DynamoDBStreams と呼ばれる新しいモジュールに移動されました。また、それぞれ [Get-DDBSStream](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-DDBSStream.html) と Get[Get-DDBSStreamList](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-DDBSStreamList.html)に名前が変更されました。 ## 機密情報のログ記録 ログ記録の動作が変更され、特に CI/CD 状況では、機密情報がコマンドレット出力に含まれる可能性が低くなりました。V4 の動作に戻す方法の詳細と手順については、「」を参照してください[機密情報のログ記録](additional-security-considerations.md#add-sec-cons-sensitive-logs)。 ## 認証情報とプロファイルの解決 コマンドレットの認証情報を解決するときに特定の環境変数を使用するように が更新され AWS Tools for PowerShell ました: `AWS_PROFILE`、`AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、および `AWS_SESSION_TOKEN`。さらに、認証情報とプロファイルの解決順序にいくつかの変更がありました。詳細については、「[認証情報とプロファイルの解決](creds-assign.md)」を参照してください。 ## 認証情報エラーメッセージ 適切な認証情報を取得できない場合に が AWS Tools for PowerShell 返すエラーメッセージが変更されました。 ツールの v4 では、メッセージは次のようになります。 ``` Get-SFNExecutionList -Region us-west-2 Get-SFNExecutionList: No credentials specified or obtained from persisted/shell defaults. ``` ツールの V5 では、メッセージは次のようになります。 ``` Get-SFNExecutionList -Region us-west-2 Get-SFNExecutionList: Failed to resolve AWS credentials. The credential providers used to search for credentials returned the following errors: ... ``` ## 一貫した自動イテレーション ページ分割されたコマンドレットはすべて、デフォルトですべてのデータを自動反復するように更新されました。[Set-AWSAutoIterationMode](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-AWSAutoIterationMode.html) コマンドレットを使用して、この動作を元に戻すことができます。を実行すると`Set-AWSAutoIterationMode -IterationMode v4`、v4 で自動反復されたオペレーションは引き続き自動反復されますが、残りは手動反復に戻ります。自動反復がどのモードに設定されているかを判断するには、[Get-AWSAutoIterationMode](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSAutoIterationMode.html) コマンドレットを使用します。 この方法で更新されたコマンドレットの例を確認するには、`Get-CWLLogEvent`「 コマンドレット ([V4 コマンドレット](https://docs.aws.amazon.com/powershell/v4/reference/index.html?page=Get-CWLLogEvent.html&tocid=Get-CWLLogEvent)と [V5 コマンドレット](https://docs.aws.amazon.com/powershell/v5/reference/index.html?page=Get-CWLLogEvent.html&tocid=Get-CWLLogEvent))」を参照してください。 自動反復の詳細については、「」を参照してください[ページ分割されたデータによる反復処理](pstools-pipelines.md#pstools-iteration)。 ## S3 コマンドレットの廃止と置き換え Amazon S3 では、[Get-S3ACL](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ACL.html) および [Set-S3ACL](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-S3ACL.html) コマンドレットは廃止されました。代わりに、Get[Get-S3BucketACL](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3BucketACL.html)、[Set-S3BucketACL](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-S3BucketACL.html)、[Get-S3ObjectACL](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ObjectACL.html)、[Set-S3ObjectACL](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-S3ObjectACL.html) の新しいコマンドレットを使用します。 ## S3 キーパラメータのクリーニングとトリミング 特定の Amazon S3 コマンドレットは、 `Key`および という名前のパラメータを受け入れます`KeyPrefix`。の V4 AWS Tools for PowerShell は、先頭のスペース、スラッシュ (「/」）、バックスラッシュ (「」) の削除、他のすべてのバックスラッシュのスラッシュへの変換、末尾のスペースの削除の方法でこれらのパラメータをクリーンアップおよびトリミングします。Tools for PowerShell の V5 では、これはデフォルトの動作ではなくなりました。この動作に戻すには、 `-EnableLegacyKeyCleaning`パラメータを指定します。 この情報は、次のコマンドレットに適用されます。 + [Copy-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Copy-S3Object.html) + [Get-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3Object.html) + [Get-S3ObjectV2](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-S3ObjectV2.html) + [Read-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Read-S3Object.html) + [Remove-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Remove-S3Object.html) + [Set-S3ACL](https://docs.aws.amazon.com/powershell/v5/reference/items/Set-S3ACL.html) + [Write-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Write-S3Object.html) ## インタラクティブセッション機能 AWS CLI 動作に沿ったインタラクティブセッション機能が [Start-SSMSession](https://docs.aws.amazon.com/powershell/v5/reference/items/Start-SSMSession.html) コマンドレットに追加されました。例えば、次のようになります。 ``` Start-SSMSession -Target 'i-1234567890abcdef0' ``` レガシー動作が必要な場合は、 `Start-SSMSession` コマンドに `-DisablePluginInvocation`パラメータを含めます。 ## CloudWatch アラーム [Get-CWAlarm](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-CWAlarm.html) コマンドレットは、デフォルトでメトリクスアラームと複合 Amazon CloudWatch アラームの両方を返すように更新されました。出力をメトリクスアラームまたは複合アラームに制限するには、`-AlarmType`パラメータ `Get-CWAlarm -AlarmType 'MetricAlarms'`または `Get-CWAlarm -AlarmType 'CompositeAlarms'`をそれぞれ指定する必要があります。 ## `LitJson` AWS Tools for PowerShell は、シリアル化`System.Text.Json``LitJson`ではなく を使用するように更新されました。 `LitJson`はツールの V5 から削除されています。 ## `LoggedAt` 出力プロパティ `LoggedAt` 出力プロパティが削除されました。ツールの V4 では、このプロパティは一部のコマンドレット ( `Get-SSMCommandInvocationDetail`や など) でデフォルトで返されました`Invoke-LMFunction`。 `LoggedAt` 出力プロパティによって提供された情報をレプリケートする必要がある場合は、次のような情報をスクリプトに含めることができます。 ``` $loggedAt = (Get-Date).ToUniversalTime().ToString('s') ``` ## 削除された要素のプログラミング Tools for PowerShell の V5 から多くのプログラミング要素が削除されました。これらは、以前に説明されていない場合は、削除に対応するために実行できる潜在的な手順とともに、以下にリストされます。 + `Invoke-LMFunctionAsync` コマンドレット。 + `Get-EC2ImageByName` コマンドレット。代わりに [Get-SSMLatestEC2Image](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-SSMLatestEC2Image.html) コマンドレットを使用します。 + [Write-S3Object](https://docs.aws.amazon.com/powershell/v5/reference/items/Write-S3Object.html) コマンドレットの `CalculateContentMD5Header`パラメータ。