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

我们建议您迁移到 [AWS Tools for PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/)。有关如何迁移的更多详细信息和信息，请参阅我们的[维护模式公告](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/)。

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

# 指定 AWS 区域
<a name="pstools-installing-specifying-region"></a>

有两种方法可以指定运行 AWS Tools for PowerShell 命令时要使用的 AWS 区域：
+ 对单个命令使用 `-Region` 通用参数。
+ 使用 `Set-DefaultAWSRegion` 命令为所有命令设置默认区域。

如果 Windows 工具 PowerShell 无法确定要使用哪个区域，许多 AWS cmdlet 就会失败。例外情况包括适用于 [Amazon S3、Amazon S](pstools-s3.md) 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` 参数来指定某个区域，请尝试在一个自定义端点中指定该区域，如以下部分中所述。

## 指定自定义或非标准终端节点
<a name="specifying-a-custom-or-nonstandard-endpoint"></a>

按照以下示例格式，将`-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"
```

## 附加信息
<a name="region-additional-info"></a>

有关 AWS 区域的更多信息，请参阅*AWS SDKs 和工具参考指南*中的[AWS 区域](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html)。