翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 のリリースとエディションによって異なります。
注記
AWS Tools for PowerShell は、デフォルトですべての Windows ベースの Amazon マシンイメージ (AMIs。インストールされるオプションは、AMI によって異なります。多くの AMIs には AWSPowerShell モジュールがありますが、オプションが異なる場合もあります。例えば、Windows Server 2025 用の Amazon EC2 AMIsモジュラーAWS.Toolsオプションを使用します。
のセットアップ AWS Tools for PowerShell には、このトピックで詳しく説明されている以下の大まかなタスクが含まれます。
-
環境に適した AWS Tools for PowerShell パッケージオプションをインストールします。
-
Get-ExecutionPolicyコマンドレットを実行して、スクリプトの実行が有効になっていることを確認します。 -
AWS Tools for PowerShell モジュールを PowerShell セッションにインポートします。
前提条件
新しいバージョンの PowerShell (PowerShell Core を含む) は、Microsoft のウェブサイトの「PowerShell のさまざまなバージョンのインストール
Windows に AWS.Tools をインストールする
Windows PowerShell 5.1 または PowerShell Core 6.0 以降で Windows を実行しているコンピュータ AWS Tools for PowerShell に、モジュール化されたバージョンの をインストールできます。PowerShell Core をインストールする方法については、Microsoft のウェブサイトへの「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環境変数の値を表示することで、モジュールフォルダを検出できます。警告
ZIP ファイルをダウンロードした後、コンテンツを抽出する前に、ブロックを解除する必要がある場合があります。これは通常、ファイルのプロパティを開き、全般タブを表示して、ブロック解除チェックボックスがある場合はそれを選択することによって行われます。
ZIP ファイルをブロック解除する必要があるが、そうしないと、「Import-Module : ファイルをロードできませんでした」というエラーが表示されることがあります。
-
コマンドレットを使用して PowerShell Gallery
Install-Moduleから各サービスモジュールをインストールします。
AWS.Tools.Installer モジュールを使用して Windows AWS.Toolsに をインストールするには
-
PowerShell セッションを起動します。
注記
PowerShell は、実際のタスクで必要とされる場合を除き、昇格されたアクセス許可を持つ管理者として実行しないことをお勧めします。これは、潜在的なセキュリティリスクを避けるためであり、最小限の特権の原則にも反します。
-
モジュール化された
AWS.Toolsパッケージをインストールするには、次のコマンドを実行します。PS >Install-Module -Name AWS.Tools.InstallerUntrusted 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リポジトリについて「信頼されていない」という通知を受けた場合は、これをインストールするかどうかを確認するメッセージが表示されます。PowerShell がモジュールをインストールできるようにするには、
yを入力します。プロンプトを回避し、リポジトリを信頼せずにモジュールをインストールするには、-Forceパラメータを指定してコマンドを実行します。PS >Install-Module -Name AWS.Tools.Installer -Force -
コマンドレットを使用して、使用する AWS サービスごとに
Install-AWSToolsModuleモジュールをインストールできるようになりました。例えば、次のコマンドは Amazon EC2 モジュールと Amazon S3 モジュールをインストールします。このコマンドは、指定したモジュールの動作に必要な依存モジュールもインストールします。たとえば、最初のAWS.Toolsサービスモジュールをインストールすると、AWS.Tools.Commonもインストールされます。これは、すべての AWS サービスモジュールに必要な共有モジュールです。また、古いバージョンのモジュールを削除し、他のモジュールを同じ新しいバージョンに更新します。PS >Install-AWSToolsModule AWS.Tools.EC2,AWS.Tools.S3 -CleanUpConfirm 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 Gallery
にある適切なモジュール名で同様のコマンドを実行します。
Windows で AWSPowerShell.NetCore をインストールする
AWSPowerShell.NetCore は、PowerShell バージョン 3～5.1 または PowerShell Core 6.0 以降を搭載する Windows が実行されているコンピュータにインストールできます。PowerShell Core をインストールする方法については、Microsoft の PowerShell ウェブサイトの「PowerShell のさまざまなバージョンのインストール
AWSPowerShell.NetCore は、次の 2 つの方法のいずれかのでインストールできます。
-
AWSPowerShell.NetCore.zip
からモジュールをダウンロードし、モジュールディレクトリの 1 つにそのモジュールを展開する。 PSModulePath環境変数の値を表示することで、モジュールディレクトリを検出できます。警告
ZIP ファイルをダウンロードした後、コンテンツを抽出する前に、ブロックを解除する必要がある場合があります。これは通常、ファイルのプロパティを開き、全般タブを表示し、ブロック解除チェックボックスがある場合はそれを選択することによって行われます。
ZIP ファイルをブロック解除する必要があるが、そうしないと、「Import-Module : ファイルをロードできませんでした」というエラーが表示されることがあります。
-
次の手順で説明するように、
Install-Moduleコマンドレットを使用して PowerShell ギャラリーからインストールします。
Install-Module コマンドレットを使用して PowerShell ギャラリーから AWSPowerShell.NetCore をインストールするには
PowerShell ギャラリーから AWSPowerShell.NetCore をインストールするには、コンピュータで PowerShell 5.0 以降が実行されているか、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 モジュールは大きすぎるため、この機能をサポートしていません。代わりに、次のコマンドを実行して、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 でインストールできます。
-
AWSPowerShell.zip
からモジュールをダウンロードし、モジュールディレクトリの 1 つにそのモジュールを展開します。 PSModulePath環境変数の値を表示することで、モジュールディレクトリを検出できます。警告
ZIP ファイルをダウンロードした後、コンテンツを抽出する前に、ブロックを解除する必要がある場合があります。これは通常、ファイルのプロパティを開き、全般タブを表示し、ブロック解除チェックボックスがある場合はそれを選択することによって行われます。
ZIP ファイルをブロック解除する必要があるが、そうしないと、「Import-Module : ファイルをロードできませんでした」というエラーが表示されることがあります。
-
次の手順で説明するように、
Install-Moduleコマンドレットを使用して PowerShell ギャラリーからインストールする。
Install-Module コマンドレットを使用して PowerShell ギャラリーから AWSPowerShell をインストールするには
PowerShell 5.0 以降を実行している場合は、PowerShell ギャラリーから AWSPowerShell をインストールできます。PowerShellGet
PS >Install-Module -Name AWSPowerShell
AWSPowerShell モジュールを PowerShell セッションに自動的にロードするには、前の import-module コマンドレットを PowerShell プロファイルに追加します。PowerShell プロファイルの編集の詳細については、PowerShell ドキュメントの「About Profiles
注記
Tools for Windows PowerShell は、Windows ベースのすべての Amazon マシンイメージ (AMI) にデフォルトでインストールされています。
スクリプト実行の有効化
AWS Tools for PowerShell モジュールをロードするには、PowerShell スクリプト実行を有効にする必要があります。スクリプトの実行を有効にするには、Set-ExecutionPolicy のポリシーを設定するために RemoteSigned コマンドレットを実行します。詳細については、Microsoft Technet ウェブサイトの「About Execution Policies
注記
この必要条件は、Windows を実行しているコンピュータのみに適用されます。ExecutionPolicy セキュリティ制限は、他のオペレーティングシステムには存在しません。
スクリプト実行を有効化するには
-
実行ポリシーを設定するには管理者権限が必要です。管理者権限を持つユーザーとしてログインしていない場合は、管理者として PowerShell セッションを開きます。[スタート] ボタンをクリックし、[すべてのプログラム] を選択します。[アクセサリ] を選択し、[Windows PowerShell] を選択します。[Windows PowerShell] を右クリックして、コンテキストメニューから [管理者として実行] を選択します。
-
コマンドプロンプトで次のコマンドを入力します。
PS >Set-ExecutionPolicy RemoteSigned
注記
64 ビットシステムでは、32 ビットバージョンの PowerShell である Windows PowerShell (x86) でもこれを行う必要があります。
実行ポリシーが正しく設定されていない場合、プロファイルなどのスクリプトを実行しようとすると、次のエラーが表示されます。
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 : RuntimeExceptionTools for Windows PowerShell インストーラは PSModulePathAWSPowerShell モジュールが格納されているディレクトリの場所を反映します。
には AWS モジュールのディレクトリの場所PSModulePathが含まれているため、 Get-Module -ListAvailable コマンドレットにはモジュールが表示されます。
PS >Get-Module -ListAvailableModuleType Name ExportedCommands ---------- ---- ---------------- Manifest AppLocker {} Manifest BitsTransfer {} Manifest PSDiagnostics {} Manifest TroubleshootingPack {} Manifest AWSPowerShell {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...
バージョニング
AWS は、新しい AWS サービスや機能をサポートするために、 の新しいバージョン AWS Tools for PowerShell を定期的にリリースします。インストール済みのツールのバージョンを確認するには、Get-AWSPowerShellVersion コマンドレットを実行します。
例：
PS >Get-AWSPowerShellVersionAWS Tools for PowerShell Version 4.1.675 Copyright 2012-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved. Amazon Web Services SDK for .NET Core Runtime Version 3.7.400.33 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]
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 >$PSVersionTableName 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 の更新
Get-AWSPowerShellVersion コマンドレットを実行して実行中のバージョンを確認し、PowerShell Gallery
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
-
Install-Moduleコマンドレットを使用してインストールした場合は、次のコマンドを実行します。PS >Uninstall-Module -Name AWSPowerShell -AllVersionsPS >Install-Module -Name AWSPowerShell -
ダウンロードした ZIP ファイルを使用してインストールした場合:
-
Tools for PowerShell
ウェブサイトから最新バージョンをダウンロードします。ダウンロードしたファイル名に含まれるパッケージのバージョン番号と、 Get-AWSPowerShellVersionコマンドレットの実行時に取得したバージョン番号を比較します。 -
ダウンロードバージョンがインストールしたバージョンよりも高い場合は、すべての Tools for Windows PowerShell コンソールを閉じます。
-
新しいバージョンの Tools for Windows PowerShell をインストールします。
-
インストール後、Import-Module AWSPowerShell を実行して、更新されたコマンドレットを PowerShell セッションにロードします。または、スタートメニューからカスタム AWS Tools for PowerShell コンソールを実行します。
