指定 AWS 区域 - AWS Tools for PowerShell
指定自定义或非标准终端节点其他信息

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

指定 AWS 区域

有两种方法可以指定运行 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 工具参考指南》中的 “AWS 区域”。