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

AWS Tools for PowerShell 版本 5（V5）已经发布！

要开始使用新版本的工具，请参阅《AWS Tools for PowerShell 用户指南（V5）》，特别是关于迁移到 V5 的主题。

指定 AWS 区域

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

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

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

如果 Tools for Windows PowerShell 无法确定要使用的区域，则许多 AWS cmdlet 会失败。例外情况包括适用于 Amazon S3、Amazon SES 和 AWS Identity and Access Management 的 cmdlet，它会自动默认为全局端点。

为单个 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 参数来指定某个区域，请尝试在一个自定义端点中指定该区域，如以下部分中所述。

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

按照如下示例的格式，在您的 Tools for Windows PowerShell 命令中添加 -EndpointUrl 通用参数，以 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 SDK 和工具参考指南》中的 AWS 区域。