Windows AWS Tools for PowerShell への のインストール - AWS Tools for PowerShell
前提条件AWS.Tools をインストールするをインストールします AWSPowerShell。NetCoreのインストール AWSPowerShellスクリプト実行の有効化バージョニング更新 AWS Tools for PowerShell

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

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

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

  • AWS.Tools - のモジュール化されたバージョン AWS Tools for PowerShell。各 AWS サービスは、個別の小さなモジュールでサポートAWS.Tools.Commonされ、共有サポートモジュールと がありますAWS.Tools.Installer。

  • AWSPowerShell.NetCore - の単一のラージモジュールバージョン AWS Tools for PowerShell。すべての AWS サービスは、この単一の大きなモジュールでサポートされています。

    注記

    単一のモジュールは大きすぎて AWS Lambda 関数で使用できない場合があることに注意してください。代わりに、上記のモジュール化されたバージョンを使用します。

  • AWSPowerShell - Windows 固有の大きな単独モジュールのレガシーバージョンの AWS Tools for PowerShell。すべての AWS サービスは、この単一の大きなモジュールでサポートされています。

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

注記

Tools for Windows PowerShell （AWSPowerShell モジュール) は、すべての Windows ベースの Amazon マシンイメージ (AMIs。

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

  1. 環境に適した AWS Tools for PowerShell パッケージオプションをインストールします。

  2. Get-ExecutionPolicy コマンドレットを実行して、スクリプトの実行が有効になっていることを確認します。

  3. AWS Tools for PowerShell モジュールを PowerShell セッションにインポートします。

前提条件

PowerShell Core PowerShellを含む の新しいバージョンは、Microsoft のウェブサイトでの のさまざまなバージョンのインストール PowerShellで Microsoft からのダウンロードとして利用できます。

Windows に AWS.Tools をインストールする

モジュール化されたバージョンの は、Windows PowerShell 5.1 または PowerShell Core 6.0 以降で Windows を実行しているコンピュータ AWS Tools for PowerShell にインストールできます。Core のインストール PowerShell方法については、Microsoft の Web サイトに「 のさまざまなバージョン PowerShellをインストールする」を参照してください。

次の 3 つの方法のいずれかで AWS.Tools をインストールできます。

  • AWS.Tools.Installer モジュール内のコマンドレットを使用する。このモジュールは、他のAWS.Toolsモジュールのインストールと更新を簡素化します。 AWS.Tools.Installerには が必要でPowerShellGet、更新されたバージョンを自動的にダウンロードしてインストールします。 はモジュールバージョンAWS.Tools.Installerを自動的に同期させます。1 つのモジュールの新しいバージョンをインストールまたは更新すると、 のコマンドレットによって他のすべてのAWS.Toolsモジュールが同じバージョンAWS.Tools.Installerに自動的に更新されます。

    この方法については、以下の手順で説明します。

  • AWS.Tools.zip からモジュールをダウンロードし、モジュールフォルダの 1 つにそのモジュールを展開する。PSModulePath 環境変数の値を表示することで、モジュールフォルダを検出できます。

  • コマンドレットを使用して PowerShell Gallery Install-Module から各サービスモジュールをインストールします。

AWS.Tools.Installer モジュールを使用して Windows AWS.Toolsに をインストールするには

  1. PowerShell セッションを開始します。

    注記

    タスクが必要とする場合を除き、昇格されたアクセス許可を持つ管理者 PowerShell として を実行しないことをお勧めします。これは、潜在的なセキュリティリスクを避けるためであり、最小限の特権の原則にも反します。

  2. モジュール化された AWS.Tools パッケージをインストールするには、次のコマンドを実行します。

    PS > Install-Module -Name AWS.Tools.Installer

Untrusted repository
You are installing the modules from an untrusted repository. If you trust this repository, change its InstallationPolicy value by running the Set-PSRepository cmdlet. Are you sure
 you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): y

    リポジトリについて「信頼されていない」という通知を受けた場合は、これをインストールするかどうかを確認するメッセージが表示されます。y を入力して、 PowerShell がモジュールをインストールできるようにします。プロンプトを回避し、リポジトリを信頼せずにモジュールをインストールするには、-Force パラメータを指定してコマンドを実行します。

    PS > Install-Module -Name AWS.Tools.Installer -Force

  3. Install-AWSToolsModule コマンドレットを使用して、使用する各 AWS サービスのモジュールをインストールできるようになりました。例えば、次のコマンドは Amazon EC2 モジュールと Amazon S3 モジュールをインストールします。このコマンドは、指定したモジュールの動作に必要な依存モジュールもインストールします。たとえば、最初の AWS.Tools サービスモジュールをインストールすると、AWS.Tools.Common もインストールされます。これは、すべての AWS サービスモジュールに必要な共有モジュールです。また、古いバージョンのモジュールを削除し、他のモジュールを同じ新しいバージョンに更新します。

    PS > Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUp
  Confirm
  Are you sure you want to perform this action?
  Performing the operation "Install-AWSToolsModule" on target "AWS Tools version 4.0.0.0".
  [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"):

  Installing module AWS.Tools.Common version 4.0.0.0
  Installing module AWS.Tools.EC2 version 4.0.0.0
  Installing module AWS.Tools.Glacier version 4.0.0.0
  Installing module AWS.Tools.S3 version 4.0.0.0

  Uninstalling AWS.Tools version 3.3.618.0
  Uninstalling module AWS.Tools.Glacier
  Uninstalling module AWS.Tools.S3
  Uninstalling module AWS.Tools.SimpleNotificationService
  Uninstalling module AWS.Tools.SQS
  Uninstalling module AWS.Tools.Common
    注記

    Install-AWSToolsModule コマンドレットは、すべての要求されたモジュールを PSGallery という名前の PSRepository (https://www.powershellgallery.com/) からダウンロードし、これを信頼できるソースと見なします。この PSRepository の詳細を参照するには、Get-PSRepository -Name PSGallery コマンドを使用します。

    デフォルトでは、前のコマンドはモジュールを %USERPROFILE%\Documents\WindowsPowerShell\Modules フォルダにインストールします。コンピュータ AWS Tools for PowerShell のすべてのユーザーに をインストールするには、管理者として開始した PowerShell セッションで次のコマンドを実行する必要があります。例えば、次のコマンドは、すべてのユーザーがアクセスできる %ProgramFiles%\WindowsPowerShell\Modules フォルダに IAM モジュールをインストールします。

    PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers

    他のモジュールをインストールするには、PowerShell ギャラリー にあるように、適切なモジュール名を使用して同様のコマンドを実行します。

Windows NetCore に をインストールします AWSPowerShell。

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

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

  • AWSPowerShell.NetCore.zip からモジュールをダウンロードし、モジュールディレクトリの 1 つに抽出します。PSModulePath 環境変数の値を表示することで、モジュールディレクトリを検出できます。

  • 次の手順で説明するように、 コマンドレットを使用して PowerShell Gallery Install-Module から をインストールします。

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

PowerShell Gallery AWSPowerShellNetCore から .. をインストールするには、コンピュータが PowerShell 5.0 以降、または PowerShell 3 以降PowerShellGetを実行している必要があります。以下のコマンドを実行します。

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 module は大きすぎてこの機能をサポートできません。代わりに、次のコマンドを実行して、 AWSPowerShell.NetCore Core モジュールを PowerShell セッションに明示的にロードする必要があります。

PS > Import-Module AWSPowerShell.NetCore

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

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

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

  • AWSPowerShell.zip からモジュールをダウンロードし、モジュールディレクトリの 1 つに展開します。PSModulePath 環境変数の値を表示することで、モジュールディレクトリを検出できます。

  • 次の手順で説明するように、 コマンドレットを使用して PowerShell Gallery Install-Module から をインストールします。

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

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

 PS > Install-Module -Name AWSPowerShell

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

注記

Tools for Windows PowerShell は、すべての Windows ベースの Amazon マシンイメージ (AMIs。

スクリプト実行の有効化

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

注記

この必要条件は、Windows を実行しているコンピュータのみに適用されます。ExecutionPolicy セキュリティ制限は、他のオペレーティングシステムには存在しません。

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

  1. 実行ポリシーを設定するには管理者権限が必要です。管理者権限を持つユーザーとしてログインしていない場合は、管理者として PowerShell セッションを開きます。[スタート] ボタンをクリックし、[すべてのプログラム] を選択します。を選択し、Windows PowerShellを選択します。Windows PowerShellを右クリックし、コンテキストメニューで管理者として実行を選択します。

  2. コマンドプロンプトで次のコマンドを入力します。

    PS > Set-ExecutionPolicy RemoteSigned
注記

64 ビットシステムでは、32 ビットバージョンの PowerShell、Windows PowerShell (x86) でこれを個別に実行する必要があります。

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

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モジュールを含むディレクトリの場所を含めます。

には AWS モジュールの ディレクトリの場所PSModulePathが含まれているため、 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-AWSPowerShellVersioncmdlet を実行します。

PS > Get-AWSPowerShellVersion

Tools for PowerShell
Version 4.1.11.0
Copyright 2012-2021 Amazon.com, Inc. or its affiliates. All Rights Reserved.

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

Release notes: https://github.com/aws/aws-tools-for-powershell/blob/master/CHANGELOG.md

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

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

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
Alexa For Business                 ALXB        AWS.Tools.AlexaForBusiness        3.7.0.11
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.0.11
Amazon API Gateway                 AG          AWS.Tools.APIGateway              3.7.0.11
Amazon API Gateway Management API  AGM         AWS.Tools.ApiGatewayManagementApi 3.7.0.11
Amazon API Gateway V2              AG2         AWS.Tools.ApiGatewayV2            3.7.0.11
Amazon Appflow                     AF          AWS.Tools.Appflow                 3.7.1.4
Amazon Route 53                    R53         AWS.Tools.Route53                 3.7.0.12
Amazon Route 53 Domains            R53D        AWS.Tools.Route53Domains          3.7.0.11
Amazon Route 53 Resolver           R53R        AWS.Tools.Route53Resolver         3.7.1.5
Amazon Simple Storage Service (S3) S3          AWS.Tools.S3                      3.7.0.13
...

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

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 モジュールを更新し、正常に更新されると、他のインストール済みバージョンを削除します。

注記

Update-AWSToolsModule コマンドレットは、すべてのモジュールを PSGallery という名前の PSRepository (https://www.powershellgallery.com/) からダウンロードし、これを信頼できるソースと見なします。この PSRepository の詳細を参照するには、Get-PSRepository -Name PSGallery コマンドを使用します。

Tools for PowerShell Core を更新する

コマンドレットを実行して実行中のバージョンを確認し、それを PowerShell Gallery Get-AWSPowerShellVersion ウェブサイト PowerShell にある Tools for Windows のバージョンと比較します。2～3 週間ごとにチェックすることをお勧めします。新しいコマンドと AWS サービスのサポートは、そのサポートがあるバージョンに更新した後にのみ利用できます。

の新しいリリースをインストールする前に AWSPowerShellNetCore、既存のモジュールをアンインストールします。既存のパッケージをアンインストールする前に、開いている PowerShell セッションをすべて閉じます。次のコマンドを実行して、パッケージをアンインストールします。

PS > Uninstall-Module -Name AWSPowerShell.NetCore -AllVersions

パッケージがアンインストールされたら、次のコマンドを実行して、更新されたモジュールをインストールします。

PS > Install-Module -Name AWSPowerShell.NetCore

インストール後、 コマンドを実行してImport-Module AWSPowerShell.NetCore、更新されたコマンドレットを PowerShell セッションにロードします。

Tools for Windows を更新する PowerShell

コマンドレットを実行して実行中のバージョンを確認し、それを PowerShell Gallery Get-AWSPowerShellVersion ウェブサイト PowerShell にある Tools for Windows のバージョンと比較します。2～3 週間ごとにチェックすることをお勧めします。新しいコマンドと AWS サービスのサポートは、そのサポートがあるバージョンに更新した後にのみ利用できます。

  • Install-Module コマンドレットを使用してインストールした場合は、次のコマンドを実行します。

    PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell

  • ダウンロードした ZIP ファイルを使用してインストールした場合:

    1. Tools for PowerShell ウェブサイトから最新バージョンをダウンロードします。ダウンロードしたファイル名に含まれるパッケージのバージョン番号と、Get-AWSPowerShellVersion コマンドレットの実行時に取得したバージョン番号を比較します。

    2. ダウンロードバージョンがインストールしたバージョンよりも高い場合は、すべての Tools for Windows PowerShell コンソールを閉じます。

    3. Tools for Windows の新しいバージョンをインストールします PowerShell。

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