のバージョン 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) 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Windows `AWS.Tools`に をインストールする (推奨) 前提条件やその他のオプションなど、Windows AWS Tools for PowerShell での のインストールに関する一般的な情報については、[親トピック](pstools-getting-set-up-windows.md)を参照してください。 にプリインストールされている Tools for PowerShell の詳細については AWS CloudShell、「」を参照してください[CloudShell にインストール済み](pstools-getting-set-up-cloudshell.md)。 Windows PowerShell 5.1 または PowerShell Core 6.0 以降で Windows を実行しているコンピュータ AWS Tools for PowerShell には、 のモジュール化されたバージョンをインストールできます。PowerShell Core をインストールする方法については、Microsoft のウェブサイトへの「[PowerShell のさまざまなバージョンのインストール](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell)」を参照してください。 次の 3 つの方法のいずれかで `AWS.Tools` をインストールできます。 + `AWS.Tools.Installer` モジュール内のコマンドレットを使用する。このモジュールは、他の `AWS.Tools` モジュールのインストールと更新を簡素化します。`AWS.Tools.Installer` は `PowerShellGet` を必要とし、その最新版を自動的にダウンロードしてインストールします。`AWS.Tools.Installer` は、モジュールのバージョンを自動的に同期させます。あるモジュールの新しいバージョンをインストールまたは更新すると、`AWS.Tools.Installer` 内のコマンドレットによって、他のすべての `AWS.Tools` モジュールが同じバージョンに自動的に更新されます。 この方法については後述の手順で説明します。 + `[AWS.Tools.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWS.Tools.zip)` からモジュールをダウンロードし、モジュールフォルダの 1 つにそのモジュールを展開する。`PSModulePath` 環境変数の値を表示することで、モジュールフォルダを検出できます。 **警告** ZIP ファイルをダウンロードした後、展開する前にブロック解除が必要になる場合があります。そのために通常は、ファイルのプロパティを開き、**[General]** (全般) タブで **[Unblock]** (ブロック解除) チェックボックス (存在する場合) をオンにします。 ZIP ファイルのブロック解除が必要だったが行わなかった場合は、「Import-Module : Could not load file or assembly」 (ファイルまたはアセンブリをロードできませんでした) のようなエラーが表示されることがあります。 + `Install-Module` コマンドレットを使用して、PowerShell Gallery から各サービスモジュールをインストールします。 **`AWS.Tools.Installer` モジュールを使用して Windows に `AWS.Tools` をインストールするには** 1. PowerShell セッションを起動します。 **注記** PowerShell は、実際のタスクで必要とされる場合を除き、昇格されたアクセス許可を持つ管理者として実行*しない*ことをお勧めします。これは、潜在的なセキュリティリスクを避けるためであり、最小限の特権の原則にも反します。 1. モジュール化された `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 ``` リポジトリについて「信頼されていない」という通知を受けた場合は、これをインストールするかどうかを確認するメッセージが表示されます。PowerShell がモジュールをインストールできるようにするには、**y** を入力します。プロンプトを回避し、リポジトリを信頼せずにモジュールをインストールするには、`-Force` パラメータを指定してコマンドを実行します。 ``` PS > Install-Module -Name AWS.Tools.Installer -Force ``` 1. コマンドレットを使用して、使用する AWS サービスごとに `Install-AWSToolsModule` モジュールをインストールできるようになりました。例えば、次のコマンドは 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/](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](https://www.powershellgallery.com/packages?q=aws) にある適切なモジュール名で同様のコマンドを実行します。 ## スクリプト実行の有効化 AWS Tools for PowerShell モジュールをロードするには、PowerShell スクリプト実行を有効にする必要があります。スクリプトの実行を有効にするには、`Set-ExecutionPolicy` のポリシーを設定するために `RemoteSigned` コマンドレットを実行します。詳細については、Microsoft Technet ウェブサイトの「[About Execution Policies](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies)」を参照してください。 **注記** この必要条件は、Windows を実行しているコンピュータのみに適用されます。`ExecutionPolicy` セキュリティ制限は、他のオペレーティングシステムには存在しません。 **スクリプト実行を有効化するには** 1. 実行ポリシーを設定するには管理者権限が必要です。管理者権限を持つユーザーとしてログインしていない場合は、管理者として PowerShell セッションを開きます。[**スタート**] ボタンをクリックし、[**すべてのプログラム**] を選択します。[**アクセサリ**] を選択し、[**Windows PowerShell**] を選択します。[**Windows PowerShell**] を右クリックして、コンテキストメニューから [**管理者として実行**] を選択します。 1. コマンドプロンプトで次のコマンドを入力します。 ``` 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 : RuntimeException ``` Tools for Windows PowerShell インストーラは [PSModulePath](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_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 サービスや機能をサポートするために、 の新しいバージョン AWS Tools for PowerShell を定期的にリリースします。インストール済みのツールのバージョンを確認するには、[Get-AWSPowerShellVersion](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) コマンドレットを実行します。 例えば、次のようになります。 ``` PS > Get-AWSPowerShellVersion AWS Tools for PowerShell Version 5.0.3 Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. Amazon Web Services SDK for .NET Core Runtime Version 4.0.0.13 Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved. Release notes: https://github.com/aws/aws-tools-for-powershell/blob/main/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](https://docs.aws.amazon.com/powershell/v5/reference/items/Get-AWSPowerShellVersion.html) コマンドに `-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`」と入力して、\$1PSVersionTable [自動変数](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6)の内容を表示します。 例えば、次のようになります。 ``` 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/](https://www.powershellgallery.com/)) からダウンロードし、これを信頼できるソースと見なします。この の詳細については、 `Get-PSRepository -Name PSGallery` コマンドを使用します`PSRepository`。