セットアップの概要前提条件 AWS.Tools をインストールするをインストールします AWSPowerShell。NetCore スクリプトの実行 PowerShell コンソールの設定 PowerShell セッションを初期化するバージョニング Linux または macOS AWS Tools for PowerShell でのの更新関連情報

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

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

セットアップの概要

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

AWS.Tools – モジュール化されたバージョンの AWS Tools for PowerShell。各 AWS サービスは、個々の小さなモジュールでサポートされ、共有サポートモジュールを持ちますAWS.Tools.Common。
AWSPowerShell.NetCore – の単一のラージモジュールバージョン AWS Tools for PowerShell。すべての AWS サービスは、この単一の大きなモジュールでサポートされています。

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

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

サポートされているシステムに PowerShell Core 6.0 以降をインストールします。
PowerShell Core をインストールしたら、まずシステムシェルpwshで PowerShell を実行します。
AWS.Tools またはをインストール AWSPowerShellしますNetCore。
適切なImport-Moduleコマンドレットを実行して、モジュールをセッションにインポートします PowerShell。
Initialize-AWSDefaultConfigurationcmdlet を実行して、 AWS 認証情報を指定します。

前提条件

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

サポートされている Linux プラットフォームリリースのリストと PowerShell 、Linux ベースのコンピュータにの最新バージョンをインストールする方法については、Microsoft のウェブサイト PowerShell の「Linux へのインストール」を参照してください。一部の Linux ベースのオペレーティングシステム (Arch、Kali、Raspbian など) は、公式にはサポートされていませんが、さまざまなレベルのコミュニティサポートがあります。
サポートされている macOS バージョンと macOS にの最新バージョンをインストールする方法については PowerShell macOS 、Microsoft のウェブサイト PowerShell の「macOS でののインストール」を参照してください。

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

Core 6.0 以降を実行 PowerShellしているコンピュータ AWS Tools for PowerShell に、モジュール化されたバージョンのをインストールできます。 PowerShell Core のインストール方法については、Microsoft PowerShell ウェブサイトの「のさまざまなバージョン 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 つにそのモジュールを展開します。$Env:PSModulePath 変数の値を出力することで、モジュールディレクトリを検出できます。
コマンドレットを使用して PowerShell Gallery Install-Module から各サービスモジュールをインストールします。

`AWS.Tools.Installer` モジュールを使用して `AWS.Tools` Linux または macOS にをインストールするには

次のコマンドを実行して、 PowerShell Core セッションを開始します。
```
$ pwsh
```
注記
タスクが必要とする場合を除き、昇格されたアクセス許可を持つ管理者 PowerShell としてを実行しないことをお勧めします。これは、潜在的なセキュリティリスクを避けるためであり、最小限の特権の原則にも反します。
AWS.Tools.Installer モジュールを使用してモジュール化された 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 がモジュールをインストールできるようにします。プロンプトを回避し、リポジトリを信頼せずにモジュールをインストールするには、次のコマンドを実行します。
```
PS > Install-Module -Name AWS.Tools.Installer -Force
```
これで、使用するサービスごとにモジュールをインストールできます。例えば、次のコマンドは 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 コマンドを使用します。

前のコマンドは、システムのデフォルトディレクトリにモジュールをインストールします。実際のディレクトリは、オペレーティングシステムのディストリビューションとバージョン、およびインストール PowerShell したのバージョンによって異なります。例えば、RHEL に似たシステムに PowerShell 7 をインストールした場合、デフォルトのモジュールは /opt/microsoft/powershell/7/Modules (または $PSHOME/Modules) にあり、ユーザーモジュールはにある可能性が最も高くなります~/.local/share/powershell/Modules。詳細については、Microsoft PowerShell ウェブサイトの PowerShell 「Linux へのインストール」を参照してください。モジュールがインストールされている場所を確認するには、次のコマンドを実行します。
```
PS > Get-Module -ListAvailable
```
他のモジュールをインストールするには、PowerShell ギャラリーにあるように、適切なモジュール名を使用して同様のコマンドを実行します。

Linux または macOS NetCore にをインストールします AWSPowerShell。

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

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

AWSPowerShell.NetCore.zip からモジュールをダウンロードし、モジュールディレクトリの 1 つにそのモジュールを展開します。$Env:PSModulePath 変数の値を出力することで、モジュールディレクトリを検出できます。
次の手順で説明するように、コマンドレットを使用して PowerShell Gallery Install-Module からをインストールします。

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

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


$ pwsh

注記

を実行する PowerShell ことから始めて、昇格された管理者権限 PowerShell でsudo pwsh実行しないことをお勧めします。これは、潜在的なセキュリティリスクを避けるためであり、最小限の特権の原則にも反します。

PowerShell Gallery から AWSPowerShell.NetCore single-module パッケージをインストールするには、次のコマンドを実行します。


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

リポジトリが「信頼されていない」という通知を受けた場合は、インストールするかどうかを尋ねられます。y を入力して、 PowerShell がモジュールをインストールできるようにします。リポジトリを信頼せずにプロンプトを回避するには、次のコマンドを実行します。


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

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


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

スクリプトの実行

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

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

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

PowerShell セッションを初期化する

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

注記

の以前のリリース (3.3.96.0 以前) では AWS Tools for PowerShell、このコマンドレットの名前はでしたInitialize-AWSDefaults。

バージョニング

AWS は、の新バージョン AWS Tools for PowerShell を定期的にリリースし、新しい AWS のサービスと機能をサポートします。インストール AWS Tools for PowerShell したのバージョンを確認するには、Get-AWSPowerShellVersioncmdlet を実行します。


PS > Get-AWSPowerShellVersion

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

Amazon Web Services SDK for .NET
Core Runtime Version 3.3.103.22
Copyright 2009-2015 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]

現在のバージョンのツールでサポートされている AWS サービスのリストを表示するには、Get-AWSPowerShellVersioncmdlet に -ListServiceVersionInfoパラメータを追加します。

実行 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 モジュールを更新し、正常に更新されたモジュールについては、以前のバージョンを削除します。

注記

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 セッションにロードします。

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

セットアップの概要

注記

前提条件

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

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

注記

注記

Linux または macOS NetCore に をインストールします AWSPowerShell。

注記