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

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 Windows Amazon Tools for PowerShell 上安装

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

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

设置 Amazon Tools for PowerShell 涉及以下高级任务，本主题对此进行了详细介绍。

先决条件

包括 PowerShell 酷睿 PowerShell在内的较新版本可在微软网站上安装各种版本 PowerShell上从微软下载。

在 Windows 上安装 AWS.Tools

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

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

安装 AWSPowerShell。 NetCore 在 Windows 上

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

你可以安装 AWSPowerShell。 NetCore 有两种方式之一

要安装 AWSPowerShell。 NetCore 使用 Install-Module cmdlet 从 PowerShell 图库中获取

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

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 通过运行以下命令将核心模块添加到您的 PowerShell 会话中。

PS > Import-Module AWSPowerShell.NetCore

要加载 AWSPowerShell. NetCore 自动进入会 PowerShell 话，将该命令添加到您的 PowerShell 配置文件中。有关编辑个人 PowerShell 资料的更多信息，请参阅文档中的关于配置 PowerShell 文件。

在 Windows AWSPowerShell 上安装 PowerShell

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

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

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

 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

适用于 Windows 的工具 PowerShell 安装程序会自动更新 PS ModulePath 以包含该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

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

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

您也可以将-ListServiceVersionInfo参数添加到 Get-AWSPowerShellVersion 命令中，以查看当前版本工具支持的 Amazon 服务列表。如果使用模块化 AWS.Tools.* 选项，则只显示当前已导入的模块。

PS > Get-AWSPowerShellVersion -ListServiceVersionInfo
...

Service                            Noun Prefix Module Name                       SDK
                                                                                 Assembly
                                                                                 Version
-------                            ----------- -----------                       -----------
Alexa For Business                 ALXB        AWS.Tools.AlexaForBusiness        3.7.0.11
Amplify Backend                    AMPB        AWS.Tools.AmplifyBackend          3.7.0.11
Amazon API Gateway                 AG          AWS.Tools.APIGateway              3.7.0.11
Amazon API Gateway Management API  AGM         AWS.Tools.ApiGatewayManagementApi 3.7.0.11
Amazon API Gateway V2              AG2         AWS.Tools.ApiGatewayV2            3.7.0.11
Amazon Appflow                     AF          AWS.Tools.Appflow                 3.7.1.4
Amazon Route 53                    R53         AWS.Tools.Route53                 3.7.0.12
Amazon Route 53 Domains            R53D        AWS.Tools.Route53Domains          3.7.0.11
Amazon Route 53 Resolver           R53R        AWS.Tools.Route53Resolver         3.7.1.5
Amazon Simple Storage Service (S3) S3          AWS.Tools.S3                      3.7.0.13
...

要确定您正在运行 PowerShell 的版本，$PSVersionTable请输入查看 $PS VersionTable 自动变量的内容。

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

Amazon Tools for PowerShell 在 Windows 上更新

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

更新模块化模块 AWS.Tools

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

PS > Update-AWSToolsModule -CleanUp

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

更新 PowerShell 核心工具

运行 Get-AWSPowerShellVersion cmdlet 以确定你正在运行的版本，并将其与PowerShell 图库网站上提供的适用于 Windows PowerShell 的工具版本进行比较。我们建议您每两到三个星期检查一次。只有在更新到支持新命令和 Amazon 服务的版本后，才会提供对新命令和服务的支持。

在安装较新版本的之前 AWSPowerShell。 NetCore，卸载现有模块。在卸载现有软件包之前，请关闭所有打开的 PowerShell 会话。运行以下命令来卸载该程序包。

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

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

PS > Install-Module -Name AWSPowerShell.NetCore

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

更新适用于 Windows 的工具 PowerShell

运行 Get-AWSPowerShellVersion cmdlet 以确定你正在运行的版本，并将其与PowerShell 图库网站上提供的适用于 Windows PowerShell 的工具版本进行比较。我们建议您每两到三个星期检查一次。只有在更新到支持新命令和 Amazon 服务的版本后，才会提供对新命令和服务的支持。

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