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 リージョンを指定する
AWS Tools for PowerShell コマンドを実行するときに使用する AWS リージョンを指定するには、次の 2 つの方法があります。
+ 個々のコマンドで `-Region` 共通パラメータを使用します。
+ `Set-DefaultAWSRegion` コマンドを使用して、すべてのコマンドのデフォルトのリージョンを設定します。
Tools for Windows PowerShell AWS が使用するリージョンを特定できない場合、多くのコマンドレットは失敗します。例外には[Amazon S3](pstools-s3.md)、Amazon SES、および のコマンドレットが含まれます。これは AWS Identity and Access Management、デフォルトで自動的にグローバルエンドポイントになります。
**1 つの AWS コマンドのリージョンを指定するには**
次のような `-Region` パラメータをコマンドに追加します。
```
PS > Get-EC2Image -Region us-west-2
```
**現在のセッションのすべての AWS CLI コマンドにデフォルトのリージョンを設定するには**
PowerShell コマンドプロンプトに、次のコマンドを入力します。
```
PS > Set-DefaultAWSRegion -Region us-west-2
```
**注記**
この設定は、現在のセッション中にのみ維持されます。この設定をすべての PowerShell セッションに適用するには、`Import-Module` コマンドに対して行ったように、このコマンドを PowerShell プロファイルに追加します。
**すべての AWS CLI コマンドの現在のデフォルトリージョンを表示するには**
PowerShell コマンドプロンプトに、次のコマンドを入力します。
```
PS > Get-DefaultAWSRegion
Region Name IsShellDefault
------ ---- --------------
us-west-2 US West (Oregon) True
```
**すべての AWS CLI コマンドの現在のデフォルトリージョンをクリアするには**
PowerShell コマンドプロンプトに、次のコマンドを入力します。
```
PS > Clear-DefaultAWSRegion
```
**使用可能なすべての AWS リージョンのリストを表示するには**
PowerShell コマンドプロンプトに、次のコマンドを入力します。サンプルの 3 番目の列で、現在のセッションのデフォルトのリージョンがわかります。
```
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` コマンドレットの出力に含まれていない場合があります。例えば、これはまだグローバルではないリージョンにも当てはまる場合があります。`-Region` パラメータをコマンドに追加してもリージョンを指定できない場合は、次のセクションに示すように、代わりにカスタムエンドポイントでリージョンを指定してみてください。
## カスタムエンドポイントまたは非標準エンドポイントの指定
次のサンプル形式で、`-EndpointUrl` 共通パラメータを Tools for Windows PowerShell コマンドに追加して、カスタムエンドポイントを URL として指定します。
```
PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters
```
以下は `Get-EC2Instance` コマンドレットを使用した例です。この例では、カスタムエンドポイントは `us-west-2` または米国西部 (オレゴン) にありますが、他のサポートされている任意の AWS リージョン (`Get-AWSRegion` で列挙されないリージョンも含む) を使用できます。
```
PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"
```
## 追加情報
AWS リージョンの詳細については、 SDK およびツールリファレンスガイドの[AWS 「リージョン](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html)」を参照してください。 *AWS SDKs *