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

指定 Amazon 区域

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

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

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

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

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

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

按照如下示例的格式,在您的 Tools for Windows PowerShell 命令中添加 -EndpointUrl 通用参数,以 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"