버전 5(V5) AWS Tools for PowerShell 가 릴리스되었습니다.
변경 사항 해제 및 애플리케이션 마이그레이션에 대한 자세한 내용은 [마이그레이션 주제를](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html) 참조하세요.
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 의 AWS 리전 지정 AWS Tools for PowerShell
AWS Tools for PowerShell 명령을 실행할 때 사용할 AWS 리전을 지정하는 방법에는 두 가지가 있습니다.
+ 개별 명령에서 `-Region` 공통 매개 변수를 사용합니다.
+ `Set-DefaultAWSRegion` 명령을 사용하여 모든 명령에 대한 기본 리전을 설정합니다.
Tools for Windows PowerShell에서 사용할 리전을 확인할 수 없는 경우 많은 AWS cmdlet이 실패합니다. 예외에는 Amazon [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
```
**참고**
이 설정은 현재 세션 동안만 지속됩니다. 이 설정을 모든 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 명령 프롬프트에서 다음 명령을 입력합니다. 샘플 출력의 세 번째 열은 현재 세션의 기본 값인 리전을 나타냅니다.
```
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` 파라미터를 추가하여 리전을 지정할 수 없는 경우, 대신에 다음 단원에서와 같이 사용자 지정 엔드포인트에서 리전을 지정해 보세요.
## 사용자 지정 또는 비표준 엔드포인트 지정
다음과 같은 샘플 형식으로 `-EndpointUrl` 일반 파라미터를 Tools for Windows PowerShell 명령에 추가하여 사용자 지정 엔드포인트를 URL로 지정합니다.
```
PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters
```
다음은 `Get-EC2Instance` cmdlet 사용을 보여주는 예입니다. 이 예에서는 사용자 지정 엔드포인트가 `us-west-2` 또는 미국 서부(오레곤)에 있지만, `Get-AWSRegion`을 통해 열거되지 않는 리전을 포함하여 지원되는 다른 AWS 리전을 모두 사용할 수 있습니다.
```
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 *