View a markdown version of this page

为... 指定 AWS 区域 AWS Tools for PowerShell - AWS Tools for PowerShell （版本 5）
指定自定义或非标准终端节点附加信息

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

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

Orange button with text "Click here for details".

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

为... 指定 AWS 区域 AWS Tools for PowerShell

有两种方法可以指定运行 AWS Tools for PowerShell 命令时要使用的 AWS 区域：

  • 对单个命令使用 -Region 通用参数。

  • 使用 Set-DefaultAWSRegion 命令为所有命令设置默认区域。

如果 Windows 工具 PowerShell 无法确定要使用哪个区域，许多 AWS cmdlet 就会失败。例外情况包括适用于 Amazon S3、Amazon S ES 和的 cmdlet AWS Identity and Access Management，它们会自动默认为全局终端节点。

为单个 AWS 命令指定区域

将 -Region 参数添加到命令中，如下所示。

PS > Get-EC2Image -Region us-west-2

为当前会话中的所有 AWS CLI 命令设置默认区域

在 PowerShell 命令提示符下，键入以下命令。

PS > Set-DefaultAWSRegion -Region us-west-2
注意

此设置仅为当前会话保留。要将该设置应用于您的所有 PowerShell会话，请将此命令添加到您的 PowerShell 配置文件中，就像在Import-Module命令中所做的那样。

查看所有 AWS CLI 命令的当前默认区域

在 PowerShell 命令提示符下，键入以下命令。

PS > Get-DefaultAWSRegion

Region    Name             IsShellDefault
------    ----             --------------
us-west-2 US West (Oregon) True

清除所有 AWS CLI 命令的当前默认区域

在 PowerShell 命令提示符下，键入以下命令。

PS > Clear-DefaultAWSRegion

查看所有可用 AWS 区域的列表

在 PowerShell 命令提示符下，键入以下命令。请注意，示例输出中的第三列标识您当前会话的默认区域。

PS > Get-AWSRegion

Region         Name                      IsShellDefault
------         ----                      --------------
ap-east-1      Asia Pacific (Hong Kong)  False
ap-northeast-1 Asia Pacific (Tokyo)      False
...
us-east-2      US East (Ohio)            False
us-west-1      US West (N. California)   False
us-west-2      US West (Oregon)          True
...
注意

某些区域可能受支持，但不包含在 Get-AWSRegion cmdlet 的输出中。例如，对于尚不具有全局性的区域，有时也是如此。如果您无法通过添加 -Region 参数来指定某个区域，请尝试在一个自定义端点中指定该区域，如以下部分中所述。

指定自定义或非标准终端节点

按照以下示例格式，将-EndpointUrl通用参数添加到 Windows 工具 PowerShell 命令中，将自定义终端节点指定为 URL。

PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters

下面是一个使用 Get-EC2Instance cmdlet 的示例。在该示例中，自定义端点位于 us-west-2 或美国西部（俄勒冈）区域中，但您可以使用任何其他支持的 AWS 区域，包括 Get-AWSRegion 未列举的区域。

PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"

附加信息

有关 AWS 区域的更多信息，请参阅AWS SDKs 和工具参考指南中的AWS 区域。