のバージョン 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 で AWSPowerShell.NetCore をインストールする 前提条件やその他のオプションなど、Windows AWS Tools for PowerShell への のインストールに関する一般的な情報については、[親トピック](pstools-getting-set-up-windows.md)を参照してください。 にプリインストールされている Tools for PowerShell の詳細については AWS CloudShell、「」を参照してください[CloudShell にインストール済み](pstools-getting-set-up-cloudshell.md)。 **注記** AWSPowerShell.NetCore は、 のインストールに推奨される方法ではありません AWS Tools for PowerShell。推奨される方法については、[のインストール `AWS.Tools` (推奨)](ps-installing-awstools.md)代わりに「」を参照してください。 AWSPowerShell.NetCore は、PowerShell バージョン 3～5.1 または PowerShell Core 6.0 以降を搭載する Windows が実行されているコンピュータにインストールできます。PowerShell Core をインストールする方法については、Microsoft の PowerShell ウェブサイトの「[PowerShell のさまざまなバージョンのインストール](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell)」を参照してください。 AWSPowerShell.NetCore は、次の 2 つの方法のいずれかのでインストールできます。 + [AWSPowerShell.NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v5/latest/AWSPowerShell.NetCore.zip) からモジュールをダウンロードし、モジュールディレクトリの 1 つにそのモジュールを展開する。`PSModulePath` 環境変数の値を表示することで、モジュールディレクトリを検出できます。 **警告** ZIP ファイルをダウンロードした後、コンテンツを抽出する前に、ブロックを解除する必要がある場合があります。これは通常、ファイルのプロパティを開き、**全般**タブを表示し、ブロック**解除**チェックボックスがある場合はそれを選択することによって行われます。 ZIP ファイルのブロックを解除する必要がある場合は、「Import-Module : Could not load file or assembly」のようなエラーが表示されることがあります。 + 次の手順で説明するように、`Install-Module` コマンドレットを使用して PowerShell ギャラリーからインストールします。 **Install-Module コマンドレットを使用して PowerShell ギャラリーから AWSPowerShell.NetCore をインストールするには** PowerShell ギャラリーから AWSPowerShell.NetCore をインストールするには、コンピュータで PowerShell 5.0 以降が実行されているか、[PowerShellGet](https://www.powershellgallery.com/packages/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](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles)」を参照してください。 ## スクリプト実行の有効化 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 がリリースされたら、定期的にローカルで実行しているバージョンを更新する必要があります。 ### Tools for PowerShell Core の更新 `Get-AWSPowerShellVersion` コマンドレットを実行して実行中のバージョンを確認し、[PowerShell Gallery](https://www.powershellgallery.com/packages/AWSPowerShell) ウェブサイトにある 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 セッションにロードします。