のバージョン 5 (V5) AWS Tools for PowerShell がリリースされました。

新しいバージョンのツールの使用を開始するには、「AWS Tools for PowerShell ユーザーガイド (V5)」、特に V5 への移行に関するトピックを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Windows への AWS Tools for PowerShell のインストール

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

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

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

前提条件

新しいバージョンの 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 をインストールできます。

Windows で AWSPowerShell.NetCore をインストールする

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

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

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

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

Windows PowerShell に AWSPowerShell をインストールする

次の 2 つの方法のいずれかで AWS Tools for Windows PowerShell をインストールできます。

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

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

 PS > Install-Module -Name AWSPowerShell

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

スクリプト実行の有効化

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

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

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

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 インストーラは PSModulePath を更新し、AWSPowerShell モジュールが格納されているディレクトリの場所を反映します。

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 Tools for PowerShell は AWS の新しいバージョンを定期的にリリースします。インストール済みのツールのバージョンを確認するには、Get-AWSPowerShellVersion コマンドレットを実行します。

例:

PS > Get-AWSPowerShellVersion

AWS Tools for PowerShell
Version 4.1.849
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Amazon Web Services SDK for .NET
Core Runtime Version 3.7.402.75
Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/v4.1/changelogs/CHANGELOG.ALL.md

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

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

例:

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
AWS IAM Access Analyzer            IAMAA       AWS.Tools.AccessAnalyzer          3.7.400.33
AWS Account                        ACCT        AWS.Tools.Account                 3.7.400.33
AWS Certificate Manager Private... PCA         AWS.Tools.ACMPCA                  3.7.400.34
AWS Amplify                        AMP         AWS.Tools.Amplify                 3.7.401.28
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.400.33
...

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

例:

PS > $PSVersionTable

Name                           Value
----                           -----
PSVersion                      6.2.2
PSEdition                      Core
GitCommitId                    6.2.2
OS                             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_64
Platform                       Unix
PSCompatibleVersions           {1.0, 2.0, 3.0, 4.0…}
PSRemotingProtocolVersion      2.3
SerializationVersion           1.1.0.1
WSManStackVersion              3.0

Windows での AWS Tools for PowerShell の更新

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

モジュール化された AWS.Tools パッケージのモジュールを更新する

AWS.Tools モジュールを最新バージョンに更新するには、次のコマンドを実行します。

PS > Update-AWSToolsModule -CleanUp

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

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 サービスのサポートは、そのサポートのあるバージョンに更新した後にのみ利用できます。

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