Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon Tools for PowerShell 版本 5（V5）已经发布！

要开始使用新版本的工具，请参阅《Amazon Tools for PowerShell 用户指南（V5）》，特别是关于迁移到 V5 的主题。

在 Windows 上安装 Amazon Tools for PowerShell

基于 Windows 的计算机可以运行以下任何 Amazon Tools for PowerShell 程序包选项：

您选择的程序包取决于您正在运行的 Windows 的发行版和版本。

设置适用于Amazon Tools for PowerShell涉及本主题中所述的以下概括性任务。

先决条件

PowerShell 的更新版本，包括 PowerShell Core，可以从 Microsoft 下载，地址为 Microsoft 网站上的安装各种版本的 PowerShell。

在 Windows 上安装 AWS.Tools

您可以在运行 Windows 且具有 Windows PowerShell 5.1 或者 PowerShell Core 6.0 或更高版本的计算机上安装Amazon Tools for PowerShell的模块化版本。有关如何安装 PowerShell Core 的信息，请参阅 Microsoft 网站上的安装各种版本的 PowerShell。

您可以通过以下三种方式之一安装 AWS.Tools：

在 Windows 上安装 AWSPowerShell.NetCore

您可以在运行 Windows 且具有 PowerShell 版本 3 到 5.1 或 PowerShell Core 6.0 或更高版本的计算机上安装 AWSPowerShell.NetCore。有关如何安装 PowerShell Core 的信息，请参阅 Microsoft PowerShell 网站上的安装各种版本的 PowerShell。

您可以通过以下两种方式之一安装 AWSPowerShell.NetCore

使用 Install-Module cmdlet 从 PowerShell 库安装 AWSPowerShell.NetCore

要从 PowerShell 库安装 AWSPowerShell.NetCore，您的计算机必须运行 PowerShell 5.0 或更高版本，或者在 PowerShell 3 或更高版本上运行 PowerShellGet。运行以下命令。

PS > Install-Module -name AWSPowerShell.NetCore

如果您以管理员身份运行 PowerShell，则先前的命令将为计算机上的所有用户安装Amazon Tools for PowerShell。如果您以没有管理员权限的标准用户身份运行 PowerShell，则该命令仅针对当前用户安装Amazon Tools for PowerShell。

要仅在当前用户具有管理员权限时为该用户安装，请按以下步骤带有 -Scope CurrentUser 参数集运行此命令。

PS > Install-Module -name AWSPowerShell.NetCore -Scope CurrentUser

虽然 PowerShell 3.0 或更高版本通常会在您首次在模块中运行 cmdlet 时将模块加载到 PowerShell 会话中，但 AWSPowerShell.NetCore 模块太大而无法支持此功能。相反，您必须通过运行以下命令将 AWSPowerShell.NetCore Core 模块显式加载到 PowerShell 会话中。

PS > Import-Module AWSPowerShell.NetCore

要将 AWSPowerShell.NetCore 模块自动加载到 PowerShell 会话中，请将该命令添加到您的 PowerShell 配置文件中。有关如何编辑您的 PowerShell 配置文件的更多信息，请参阅 PowerShell 文档中的关于配置文件。

在 Windows PowerShell 上安装 AWSPowerShell

您可以通过以下两种方式之一安装 Amazon Tools for Windows PowerShell：

使用 Install-Module cmdlet 从 PowerShell 库安装 AWSPowerShell

如果您的计算机运行 PowerShell 5.0 或更高版本，或者在 PowerShell 3 或更高版本上安装 PowerShellGet，则可以从 PowerShell 库安装 AWSPowerShell。您可以通过运行以下命令，从 Microsoft 的 PowerShell 库安装和更新 AWSPowerShell。

 PS > Install-Module -Name AWSPowerShell

要将 AWSPowerShell 模块自动加载到 PowerShell 会话中，请将先前的 import-module cmdlet 添加到您的 PowerShell 配置文件中。有关如何编辑您的 PowerShell 配置文件的更多信息，请参阅 PowerShell 文档中的关于配置文件。

启用脚本执行

要加载Amazon Tools for PowerShell模块，必须启用 PowerShell 脚本执行。要启用脚本执行，请运行 Set-ExecutionPolicy cmdlet 以设置 RemoteSigned 策略。有关更多信息，请参阅 Microsoft Technet 网站上的关于执行策略。

启用脚本执行

如果您没有正确设置执行策略，则每当您尝试运行脚本（如您的配置文件）时，PowerShell 都会显示以下错误。

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 以包括其中包含 AWSPowerShell 模块的目录位置。

由于 PSModulePath 包含Amazon模块的目录的位置，因此 Get-Module -ListAvailable cmdlet 将显示该模块。

PS > Get-Module -ListAvailable

ModuleType Name                      ExportedCommands
---------- ----                      ----------------
Manifest   AppLocker                 {}
Manifest   BitsTransfer              {}
Manifest   PSDiagnostics             {}
Manifest   TroubleshootingPack       {}
Manifest   AWSPowerShell             {Update-EBApplicationVersion, Set-DPStatus, Remove-IAMGroupPol...

版本控制

Amazon 定期发布 Amazon Tools for PowerShell 的新版本，以支持新的 Amazon 服务和特征。要确定您安装的工具版本，请运行 Get-AWSPowerShellVersion cmdlet。

例如：

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]

也可以将 -ListServiceVersionInfo 参数添加到 Get-AWSPowerShellVersion 命令来查看当前版本的工具支持的Amazon服务的列表。如果使用模块化 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 以查看 $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

在 Windows 上更新Amazon Tools for PowerShell

随着Amazon Tools for PowerShell的更新版本定期发布，您应更新在本地运行的版本。

更新模块化的 AWS.Tools 模块

要将 AWS.Tools 模块更新到最新版本，请运行以下命令：

PS > Update-AWSToolsModule -CleanUp

此命令会更新所有当前已安装的 AWS.Tools 模块，并在成功更新后删除其他已安装的版本。

更新 Tools for PowerShell Core

运行 Get-AWSPowerShellVersion cmdlet 以确定您正在运行的版本，并将此版本与 PowerShell 库网站中提供的 Tools for Windows PowerShell 版本进行比较。我们建议您每两到三个星期检查一次。只有在更新到支持新命令和 Amazon 服务的版本后，该支持才可用。

在安装 AWSPowerShell.NetCore 的更高版本之前，请卸载任何现有模块。在卸载现有程序包之前，请关闭任何打开的 PowerShell 会话。运行以下命令来卸载该程序包。

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

在卸载程序包后，通过运行以下命令来安装更新的模块。

PS > Install-Module -Name AWSPowerShell.NetCore

安装后，运行命令 Import-Module AWSPowerShell.NetCore 将更新的 cmdlet 加载到 PowerShell 会话中。

更新 Tools for Windows PowerShell

运行 Get-AWSPowerShellVersion cmdlet 以确定您正在运行的版本，并将此版本与 PowerShell 库网站中提供的 Tools for Windows PowerShell 版本进行比较。我们建议您每两到三个星期检查一次。只有在更新到支持新命令和 Amazon 服务的版本后，该支持才可用。

安装后，运行 Import-Module AWSPowerShell 将更新的 cmdlet 加载到 PowerShell 会话中。或者，从开始菜单运行自定义 Amazon Tools for PowerShell 控制台。