安装 AWSPower外壳。 NetCore 在 Windows 上 - AWS Tools for PowerShell （版本 5）
启用脚本执行版本控制正在更新 AWS Tools for PowerShell

的版本 5 (V5) AWS Tools for PowerShell 已经发布！

有关重大更改和迁移应用程序的信息，请参阅迁移主题。

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

安装 AWSPower外壳。 NetCore 在 Windows 上

有关 AWS Tools for PowerShell 在 Windows 上安装的一般信息，包括先决条件和其他选项，请参阅父主题。

有关上预安装 PowerShell 的工具的信息 AWS CloudShell，请参阅已安装在 CloudShell。

注意

AWSPower壳牌。 NetCore 不是安装的推荐方法 AWS Tools for PowerShell。有关推荐的方法，请参安装AWS.Tools（推荐）阅。

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

你可以安装 AWSPower命令行管理程序。 NetCore 有两种方式之一

  • 从AWSPower命令行管理程序下载模块。 NetCore.zip 并将其解压缩到其中一个模块目录中。您可以通过显示 PSModulePath 变量的值来查找模块目录。

    警告

    下载 ZIP 文件后，在解压缩内容之前，可能需要将其解除封锁。这通常是通过打开文件属性，查看 “常规” 选项卡，然后选择 “取消阻止” 复选框（如果存在）来完成的。

    如果 ZIP 文件需要解除阻止，但您没有这样做，则可能会收到类似以下内容的错误：“导入模块：无法加载文件或程序集”。

  • 使用 Install-Module cmdlet 从 PowerShell 库中安装，如以下过程所述。

安装 AWSPower命令行管理程序。 NetCore 使用 Install-Module cmdlet 从 PowerShell 图库中获取

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

PS > Install-Module -name AWSPowerShell.NetCore

如果您以管理员 PowerShell 身份运行，则会 AWS Tools for PowerShell 为计算机上的所有用户安装前面的命令。如果您以没有管理员权限的标准用户 PowerShell 身份运行，则仅 AWS Tools for PowerShell 为当前用户安装相同的命令。

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

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

尽管 PowerShell 3.0 及更高版本通常会在您第一次在模块（命令行管理程序）中运行 cmdlet 时将模块加载到您的 PowerShell 会话中。 AWSPower NetCore 模块太大，无法支持此功能。您必须改为显式加载 AWSPower命令行管理程序。 NetCore 通过运行以下命令将核心模块添加到您的 PowerShell 会话中。

PS > Import-Module AWSPowerShell.NetCore

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

启用脚本执行

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

注意

此要求仅适用于运行 Windows 的计算机。ExecutionPolicy 安全限制不存在于其他操作系统上。

启用脚本执行

  1. 需要管理员权限才能设置执行策略。如果您不是以具有管理员权限的用户身份登录，请以管理员身份打开 PowerShell 会话。选择开始，然后选择所有程序。选择 “附件”，然后选择 “Windows” PowerShell。右键单击 Windows PowerShell，然后在上下文菜单上选择 “以管理员身份运行”。

  2. 在命令提示符处，输入以下命令。

    PS > Set-ExecutionPolicy RemoteSigned
注意

在 64 位系统上，对于 32 位版本的 Windows PowerShell (x 86) PowerShell，必须单独执行此操作。

如果您没有正确设置执行策略，则每当您尝试运行脚本（例如您的配置文件）时，都会 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 安装程序会自动更新PSModule路径，以包括包含该AWSPowerShell模块的目录的位置。

由于PSModulePath包含 AWS 模块目录的位置，因此 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...

版本控制

AWS AWS Tools for PowerShell 定期发布新版本以支持新的 AWS 服务和功能。要确定已安装的工具的版本，请运行 Get-AWSPower ShellVersion 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]

您也可以将-ListServiceVersionInfo参数添加到 Get-AWSPower ShellVersion 命令中，以查看当前版本的工具支持的 AWS 服务列表。如果使用模块化 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请输入查看 $ T PSVersion able 自动变量的内容。

例如：

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

AWS Tools for PowerShell 在 Windows 上更新

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

更新 PowerShell 核心工具

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

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

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

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

PS > Install-Module -Name AWSPowerShell.NetCore

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