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` 命令來設定所有命令的預設區域。

如果 Tools for Windows PowerShell 無法找出要使用的區域，許多 AWS cmdlet 會失敗。例外狀況包括 [Amazon S3](pstools-s3.md)、Amazon SES 和 的 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
```

**注意**  
此設定僅會存在於目前的工作階段。請依照您在 `Import-Module` 命令中的作法，將此命令新增至 PowerShell 設定檔，即可將該設定套用至所有 PowerShell 工作階段。

 **檢視所有 CLI AWS 命令的目前預設區域** 

在 PowerShell 命令提示字元中，輸入下列命令。

```
PS > Get-DefaultAWSRegion

Region    Name             IsShellDefault
------    ----             --------------
us-west-2 US West (Oregon) True
```

 **清除所有 CLI AWS 命令的目前預設區域** 

在 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` 常用參數新增至 Tools for 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)。