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

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

指定 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 工具参考指南》中的 “Amazon 区域”。