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

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

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

Linux または MacOS での AWS Tools for PowerShell のインストール

このトピックでは、AWS Tools for PowerShell を Linux または macOS にインストールする手順について説明します。

セットアップの概要

Linux または macOS コンピュータに AWS Tools for PowerShell をインストールする場合は、次の 2 つのパッケージオプションから選択できます。

Linux または macOS を実行しているコンピュータでこれらのいずれかをセットアップする方法は、このトピックの後半で詳しく説明します。

前提条件

AWS Tools for PowerShell Core を実行するには、コンピュータで PowerShell Core 6.0 以降が実行されている必要があります。

Linux または MacOS での AWS.Tools のインストール

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

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

Linux または MacOS に AWSPowerShell.NetCore をインストールする

AWSPowerShell.NetCore の新しいリリースにアップグレードするには、Linux または macOS での AWS Tools for PowerShell の更新 の手順に従います。最初に AWSPowerShell.NetCore の以前のバージョンをアンインストールします。

次の 2 つの方法のうちの 1 つで AWSPowerShell.NetCore をインストールできます。

Install-Module コマンドレットを使用して Linux または macOS に AWSPowerShell.NetCore をインストールするには

次のコマンドを実行して、PowerShell コアセッションを開始します。

$ pwsh

PowerShell ギャラリーから AWSPowerShell.NetCore 単一モジュールパッケージをインストールするには、次のコマンドを実行します。

PS > Install-Module -Name AWSPowerShell.NetCore

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 を入力します。リポジトリを信頼せずにプロンプトを回避するには、次のコマンドを実行します。

PS > Install-Module -Name AWSPowerShell.NetCore -Force

コンピュータのすべてのユーザーに対して AWS Tools for PowerShell をインストールする場合を除き、このコマンドをルートとして実行する必要はありません。これを行うには、sudo pwsh を使用して開始した PowerShell セッションで、次のコマンドを実行します。

PS > Install-Module -Scope AllUsers -Name AWSPowerShell.NetCore -Force

スクリプトの実行

Set-ExecutionPolicy コマンドは、Windows 以外のシステムでは使用できません。Get-ExecutionPolicy は実行できます。これは、Windows 以外のシステムで実行されている PowerShell Core のデフォルトの実行ポリシー設定が Unrestricted であることを示します。詳細については、Microsoft Technet ウェブサイトの「About Execution Policies」を参照してください。

PSModulePath には AWS モジュールのディレクトリの場所が含まれているため、Get-Module -ListAvailable コマンドレットにより、インストール済みのモジュールが表示されます。

AWS.Tools

PS > Get-Module -ListAvailable

    Directory: /Users/username/.local/share/powershell/Modules

ModuleType Version    Name                                PSEdition ExportedCommands
---------- -------    ----                                --------- ----------------
Binary     3.3.563.1  AWS.Tools.Common                    Desk      {Clear-AWSHistory, Set-AWSHistoryConfiguration, Initialize-AWSDefaultConfiguration, Clear-AWSDefaultConfigurat…

AWSPowerShell.NetCore

PS > Get-Module -ListAvailable

Directory: /Users/username/.local/share/powershell/Modules

ModuleType Version    Name                                ExportedCommands
---------- -------    ----                                ----------------
Binary     3.3.563.1  AWSPowerShell.NetCore

AWS Tools for PowerShell Core を使用するための PowerShell コンソールの設定 (AWSPowerShell.NetCore のみ)

PowerShell Core は、通常、モジュールでコマンドレットを実行するたびにモジュールを自動的にロードします。しかし、これはサイズが大きいため AWSPowerShell.NetCore には機能しません。AWSPowerShell.NetCore コマンドレットの実行を開始するには、まず Import-Module AWSPowerShell.NetCore コマンドを実行する必要があります。これは、AWS.Tools モジュール内のコマンドレットには必要ありません。

PowerShell セッションの初期化

AWS Tools for PowerShell のインストール後に Linux ベースまたは macOS ベースのシステムで PowerShell を起動する場合は、Initialize-AWSDefaultConfiguration を実行して、使用する AWS アクセスキーを指定する必要があります。Initialize-AWSDefaultConfiguration の詳細については、「AWS 認証情報の使用」を参照してください。

バージョニング

新しい AWS サービスと機能をサポートするために、AWS Tools for PowerShell は AWS の新しいバージョンを定期的にリリースします。インストール済みの AWS Tools for PowerShell のバージョンを確認するには、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]

現行バージョンのツールでサポートされる AWS のサービスを一覧表示するには、-ListServiceVersionInfo パラメータを Get-AWSPowerShellVersion コマンドレットに追加します。

実行中の 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

Linux または macOS での 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 セッションにロードします。

関連情報