Amazon Tools for PowerShell V4 已进入维护模式。
我们建议您迁移到 [Amazon Tools for PowerShell V5](https://docs.amazonaws.cn/powershell/v5/userguide/)。有关如何迁移的更多详细信息和信息，请参阅我们的[维护模式公告](https://www.amazonaws.cn/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在 Windows 上安装 Amazon Tools for PowerShell
基于 Windows 的计算机可以运行以下任何 Amazon Tools for PowerShell 程序包选项：
+ [**`AWS.Tools`**](#ps-installing-awstools) - 的模块化版本。。Amazon Tools for PowerShell每个 Amazon 服务都由其自己的小模块以及共享的支持模块 `AWS.Tools.Common` 和 `AWS.Tools.Installer` 提供支持。
+ [**AWSPowerShell.NetCore**](#ps-installing-awspowershellnetcore) – Amazon Tools for PowerShell 的单一大模块版本。所有 Amazon 服务都由这个单一大模块支持。
**注意**
请注意，单个模块可能太大，无法与 [Amazon Lambda](https://www.amazonaws.cn/lambda/) 函数一起使用。请改用上面显示的模块化版本。
+ [**AWSPowerShell**](#ps-installing-awswindowspowershell) - 特定于传统 Windows 的单一大模块版本 Amazon Tools for PowerShell。所有 Amazon 服务都由这个单一大模块支持。
您选择的程序包取决于您正在运行的 Windows 的发行版和版本。
**注意**
Amazon Tools for PowerShell 默认安装在所有基于 Windows 的 Amazon 系统映像 (AMI) 上。安装的选项取决于 AMI。许多 AMI 包含 AWSPowerShell 模块，但有些可能具有不同的选项。例如，用于 Windows Server 2025 的 Amazon EC2 AMI 使用模块化 `AWS.Tools` 选项。
设置适用于Amazon Tools for PowerShell涉及本主题中所述的以下概括性任务。
1. 安装适合您的环境的Amazon Tools for PowerShell程序包选项。
1. 通过运行 `Get-ExecutionPolicy` cmdlet 验证是否已启用脚本执行。
1. 将Amazon Tools for PowerShell模块导入您的 PowerShell 会话。
## 先决条件
PowerShell 的更新版本，包括 PowerShell Core，可以从 Microsoft 下载，地址为 Microsoft 网站上的[安装各种版本的 PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell)。
## 在 Windows 上安装 `AWS.Tools`
您可以在运行 Windows 且具有 Windows PowerShell 5.1 或者 PowerShell Core 6.0 或更高版本的计算机上安装Amazon Tools for PowerShell的模块化版本。有关如何安装 PowerShell Core 的信息，请参阅 Microsoft 网站上的[安装各种版本的 PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell)。
您可以通过以下三种方式之一安装 `AWS.Tools`：
+ 使用 `AWS.Tools.Installer` 模块中的 cmdlet。该模块简化了其他 `AWS.Tools` 模块的安装和更新。`AWS.Tools.Installer` 需要 `PowerShellGet`，并自动下载和安装其更新版本。`AWS.Tools.Installer` 会自动保持您的模块版本同步。当您安装或更新到一个模块的较新版本时，`AWS.Tools.Installer` 中的 cmdlet 会自动将所有其他 `AWS.Tools` 模块更新为同一版本。
该方法在以下过程中描述。
+ 从 `[AWS.Tools.zip](https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWS.Tools.zip)` 下载模块并将它们提取到其中一个模块文件夹中。您可以通过显示 `PSModulePath` 变量的值来查找模块文件夹。
**警告**
下载 ZIP 文件后并在提取内容之前，您可能需要将其解除锁定。通常，通过打开文件的属性，查看**常规**选项卡，并选择**解除锁定**复选框（如果存在）即可完成这一操作。
如果 ZIP 文件需要解除锁定但您没有这样做，您可能会收到类似这样的错误：“Import-Module : 无法加载文件或程序集”。
+ 使用 `Install-Module` cmdlet 从 PowerShell 库安装每个服务模块。
**使用 `AWS.Tools.Installer` 模块在 Windows 上安装 `AWS.Tools` 的步骤**
1. 启动 PowerShell 会话。
**注意**
除非所处理的任务需要，否则我们建议您*不要* 以具有提升权限的管理员身份运行 PowerShell。这是因为此操作具有潜在的安全风险，并且不符合最低特权原则。
1. 要安装模块化 `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 安装模块。为了避免在不信任存储库的情况下出现提示并安装模块，您可以使用 `-Force` 参数运行以下命令。
```
PS > Install-Module -Name AWS.Tools.Installer -Force
```
1. 现在，您可以使用 Amazon cmdlet，为要使用的每个 `Install-AWSToolsModule` 服务安装模块。例如，以下命令将安装 Amazon EC2 和 Amazon S3 模块。此命令还会安装指定模块工作所需的任何依赖模块。例如，当您安装第一个 `AWS.Tools` 服务模块时，它还会安装 `AWS.Tools.Common`。这是所有 Amazon 服务模块所需的共享模块。它还会删除模块的较早版本，并将其他模块更新到相同的较新版本。
```
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` cmdlet 从名为 `PSGallery` 的 `PSRepository` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) 下载所有请求的模块，并将其视为可信来源。有关此 `Get-PSRepository -Name PSGallery` 的更多信息，请使用命令 `PSRepository`。
默认情况下，前面的命令会将模块安装到 `%USERPROFILE%\Documents\WindowsPowerShell\Modules` 文件夹中。若要为计算机的所有用户安装Amazon Tools for PowerShell，您必须在以管理员身份启动的 PowerShell 会话中运行以下命令。例如，以下命令将 IAM 模块安装到所有用户均可访问的 `%ProgramFiles%\WindowsPowerShell\Modules` 文件夹中。
```
PS > Install-AWSToolsModule AWS.Tools.IdentityManagement -Scope AllUsers
```
要安装其他模块，请使用相应的模块名称运行类似的命令，可参阅 [PowerShell 库](https://www.powershellgallery.com/packages?q=aws)。
## 在 Windows 上安装 AWSPowerShell.NetCore
您可以在运行 Windows 且具有 PowerShell 版本 3 到 5.1 或 PowerShell Core 6.0 或更高版本的计算机上安装 AWSPowerShell.NetCore。有关如何安装 PowerShell Core 的信息，请参阅 Microsoft PowerShell 网站上的[安装各种版本的 PowerShell](https://docs.microsoft.com/en-us/powershell/scripting/install/installing-powershell)。
您可以通过以下两种方式之一安装 AWSPowerShell.NetCore
+ 从 [AWSPowerShell.NetCore.zip](https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWSPowerShell.NetCore.zip) 下载模块并将其提取到其中一个模块目录中。您可以通过显示 `PSModulePath` 变量的值来查找模块目录。
**警告**
下载 ZIP 文件后并在提取内容之前，您可能需要将其解除锁定。通常，通过打开文件的属性，查看**常规**选项卡，并选择**解除锁定**复选框（如果存在）即可完成这一操作。
如果 ZIP 文件需要解除锁定但您没有这样做，您可能会收到类似这样的错误：“Import-Module : 无法加载文件或程序集”。
+ 使用 `Install-Module` cmdlet 从 PowerShell 库进行安装，如以下过程中所述。
**使用 Install-Module cmdlet 从 PowerShell 库安装 AWSPowerShell.NetCore**
要从 PowerShell 库安装 AWSPowerShell.NetCore，您的计算机必须运行 PowerShell 5.0 或更高版本，或者在 PowerShell 3 或更高版本上运行 [PowerShellGet](https://www.powershellgallery.com/packages/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 文档中的[关于配置文件](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles)。
## 在 Windows PowerShell 上安装 AWSPowerShell
您可以通过以下两种方式之一安装 Amazon Tools for Windows PowerShell：
+ 从 [AWSpWhell.zip](https://sdk-for-net.amazonwebservices.com/ps/v4/latest/AWSPowerShell.zip) 下载模块并将其提取到其中一个模块目录中。您可以通过显示 `PSModulePath` 变量的值来查找模块目录。
**警告**
下载 ZIP 文件后并在提取内容之前，您可能需要将其解除锁定。通常，通过打开文件的属性，查看**常规**选项卡，并选择**解除锁定**复选框（如果存在）即可完成这一操作。
如果 ZIP 文件需要解除锁定但您没有这样做，您可能会收到类似这样的错误：“Import-Module : 无法加载文件或程序集”。
+ 使用 `Install-Module` cmdlet 从 PowerShell 库进行安装，如以下过程中所述。
**使用 Install-Module cmdlet 从 PowerShell 库安装 AWSPowerShell**
如果您的计算机运行 PowerShell 5.0 或更高版本，或者在 PowerShell 3 或更高版本上安装 [PowerShellGet](https://www.powershellgallery.com/packages/PowerShellGet)，则可以从 PowerShell 库安装 AWSPowerShell。您可以通过运行以下命令，从 Microsoft 的 [PowerShell 库](https://www.powershellgallery.com/packages/AWSPowerShell)安装和更新 AWSPowerShell。
```
PS > Install-Module -Name AWSPowerShell
```
要将 AWSPowerShell 模块自动加载到 PowerShell 会话中，请将先前的 `import-module` cmdlet 添加到您的 PowerShell 配置文件中。有关如何编辑您的 PowerShell 配置文件的更多信息，请参阅 PowerShell 文档中的[关于配置文件](https://docs.microsoft.com/powershell/module/microsoft.powershell.core/about/about_profiles?view=powershell-6)。
**注意**
Tools for Windows PowerShell 默认安装在所有基于 Windows 的 Amazon Machine Image (AMI) 上。
## 启用脚本执行
要加载Amazon Tools for PowerShell模块，必须启用 PowerShell 脚本执行。要启用脚本执行，请运行 `Set-ExecutionPolicy` cmdlet 以设置 `RemoteSigned` 策略。有关更多信息，请参阅 Microsoft Technet 网站上的[关于执行策略](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies)。
**注意**
此要求仅适用于运行 Windows 的计算机。`ExecutionPolicy` 安全限制不存在于其他操作系统上。
**启用脚本执行**
1. 需要管理员权限才能设置执行策略。如果您未以具有管理员权限的用户身份登录，请以管理员身份打开 PowerShell 会话。选择**开始**，然后选择**所有程序**。选择**附件**，然后选择 **Windows PowerShell**。右键单击 **Windows PowerShell**，然后在上下文菜单中选择**以管理员身份运行**。
1. 在命令提示符处，输入以下命令。
```
PS > Set-ExecutionPolicy RemoteSigned
```
**注意**
在 64 位系统上，您必须单独对 32 位版本的 PowerShell (**Windows PowerShell (x86)**) 执行该操作。
如果您没有正确设置执行策略，则每当您尝试运行脚本（如您的配置文件）时，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 安装程序自动更新 ](http://msdn.microsoft.com/en-us/library/windows/desktop/dd878326.aspx)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](https://docs.amazonaws.cn/powershell/v4/reference/items/Get-AWSPowerShellVersion.html) 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](https://docs.amazonaws.cn/powershell/v4/reference/items/Get-AWSPowerShellVersion.html) 命令来查看当前版本的工具支持的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` 以查看 \$1PSVersionTable [自动变量](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-6)内容。
例如：
```
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` 模块，并在成功更新后删除其他已安装的版本。
**注意**
`Update-AWSToolsModule` cmdlet 从名为 `PSGallery` 的 `PSRepository` ([https://www.powershellgallery.com/](https://www.powershellgallery.com/)) 下载所有模块，并将其视为可信来源。有关此 `Get-PSRepository -Name PSGallery` 的更多信息，请使用命令：`PSRepository`。
### 更新 Tools for PowerShell Core
运行 `Get-AWSPowerShellVersion` cmdlet 以确定您正在运行的版本，并将此版本与 [PowerShell 库](https://www.powershellgallery.com/packages/AWSPowerShell)网站中提供的 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 库](https://www.powershellgallery.com/packages/AWSPowerShell)网站中提供的 Tools for Windows PowerShell 版本进行比较。我们建议您每两到三个星期检查一次。只有在更新到支持新命令和 Amazon 服务的版本后，该支持才可用。
+ 如果使用 `Install-Module` cmdlet 进行了安装，请运行以下命令。
```
PS > Uninstall-Module -Name AWSPowerShell -AllVersions
PS > Install-Module -Name AWSPowerShell
```
+ 如果您已使用下载的 ZIP 文件进行安装：
1. 从 [Tools for PowerShell](https://www.amazonaws.cn/powershell/) 网站下载最新版本。将下载的文件名中的程序包版本号与运行 `Get-AWSPowerShellVersion` cmdlet 时获得的版本号进行比较。
1. 如果下载版本的版本号高于您已安装的版本，请关闭所有 Tools for Windows PowerShell 控制台。
1. 安装更新版本的 Tools for Windows PowerShell。
安装后，运行 `Import-Module AWSPowerShell` 将更新的 cmdlet 加载到 PowerShell 会话中。或者，从**开始**菜单运行自定义 Amazon Tools for PowerShell 控制台。