指令碼執行設定 PowerShell 主控台初始化您的 PowerShell 工作階段版本控制在 Linux 或 macOS AWS Tools for PowerShell 上更新相關資訊

在 Linux 或 macOS 上安裝 AWSPowerShell.NetCore

如需 AWS Tools for PowerShell 在 Linux 或 macOS 上安裝的一般資訊，包括先決條件和其他選項，請參閱父主題。

如需預先安裝在上的 Tools for PowerShell 的相關資訊 AWS CloudShell，請參閱在 CloudShell 上安裝。

注意

AWSPowerShell.NetCore 不是安裝的建議方法 AWS Tools for PowerShell。如需建議的方法，請安裝 AWS.Tools（建議）改為參閱。

若要升級到 AWSPowerShell.NetCore 的較新版本，請遵循在 Linux 或 macOS AWS Tools for PowerShell 上更新中的說明。請先解除安裝舊版 AWSPowerShell.NetCore。

您可以透過下列兩種方式安裝 AWSPowerShell.NetCore：

從 AWSPowerShell.NetCore.zip 下載模組，然後解壓縮至其中一個模組目錄。您可以列印 $Env:PSModulePath 變數的值來探索您的模組目錄。
使用 Install-Module Cmdlet 從 PowerShell Gallery 安裝，如下列程序中所描述。

使用 Install-Module cmdlet 在 Linux 或 macOS 上安裝 AWSPowerShell.NetCore

執行以下命令來啟動 PowerShell Core 工作階段。


$ pwsh

注意

建議「請勿」執行 sudo pwsh 來以提升的管理員權限啟動 PowerShell。這是因為可能會有潛在的安全風險，且不符合最低權限原則。

若要從 PowerShell Gallery 安裝 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

如果您收到儲存庫「不受信任」的通知，系統會詢問您是否仍要安裝。輸入 y 來允許 PowerShell 安裝模組。若要在不信任儲存庫的情況下避免出現提示，您可以執行以下命令。


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 cmdlet 會顯示您安裝的模組。

AWSPowerShell.NetCore


PS > Get-Module -ListAvailable

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

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

設定 PowerShell 主控台以使用 AWS Tools for PowerShell Core (僅適用於 AWSPowerShell.NetCore)

PowerShell Core 通常會在您執行模組中的 Cmdlet 時自動載入模組。但這不適用於 AWSPowerShell.NetCore，因為其大小較大。若要開始執行 AWSPowerShell.NetCore Cmdlet，您必須先執行 Import-Module AWSPowerShell.NetCore 命令。AWS.Tools 模組中的 Cmdlet 不需要此操作。

初始化您的 PowerShell 工作階段

當您在安裝之後，在 Linux 型或 macOS 型系統上啟動 PowerShell 時 AWS Tools for PowerShell，您必須執行 Initialize-AWSDefaultConfiguration，以指定要使用的 AWS 存取金鑰。如需 Initialize-AWSDefaultConfiguration 的相關資訊，請參閱使用 AWS 登入資料。

注意

在舊版 (3.3.96.0 之前）中 AWS Tools for PowerShell，此 cmdlet 名為 Initialize-AWSDefaults。

版本控制

AWS AWS Tools for PowerShell 會定期發行的新版本，以支援新的 AWS 服務和功能。若要判斷 AWS Tools for PowerShell 您已安裝的版本，請執行 Get-AWSPowerShellVersion cmdlet。

例如：


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]

若要查看目前版本工具 AWS 中支援服務的清單，請將 -ListServiceVersionInfo 參數新增至 Get-AWSPowerShellVersion cmdlet。

若要確認您執行的 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 發行更新版本的時，您應該更新在本機執行的版本。

更新 Tools for PowerShell Core

執行 Get-AWSPowerShellVersion Cmdlet 來確認您正在執行的版本，並將此版本與 PowerShell Gallery 網站上可用的 Tools for Windows PowerShell 版本進行比較。我們建議您每兩到三週檢查一次。只有在您更新到具有該支援的版本之後，才能支援新的命令 AWS 和服務。

安裝 AWSPowerShell.NetCore 的較新版本前，請解除安裝現有模組。請在您解除安裝現有套件前關閉任何開啟的 PowerShell 工作階段。執行下列命令以解除安裝套件。


PS > Uninstall-Module -Name AWSPowerShell.NetCore -AllVersions

解除安裝套件後，請執行以下命令來安裝更新後的模組。


PS > Install-Module -Name AWSPowerShell.NetCore

安裝完成後，請執行 Import-Module AWSPowerShell.NetCore 命令來將更新後的 Cmdlet 載入您的 PowerShell 工作階段。