指定 Amazon 区域 - Amazon Tools for PowerShell （第 4 版）
指定自定义或非标准终端节点附加信息
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Amazon Tools for PowerShell V4 已进入维护模式。

我们建议您迁移到 Amazon Tools for PowerShell V5。有关如何迁移的更多详细信息和信息，请参阅我们的维护模式公告。

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

指定 Amazon 区域

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

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

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

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

为单个 Amazon 命令指定区域

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

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

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

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

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

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

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

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

PS > Get-DefaultAWSRegion

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

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

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

PS > Clear-DefaultAWSRegion

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

在 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 或美国西部（俄勒冈）区域中，但您可以使用任何其他支持的 Amazon 区域，包括 Get-AWSRegion 未列举的区域。

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

附加信息

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