Alat AWS untuk PowerShell V4 telah memasuki mode pemeliharaan.

Kami menyarankan Anda bermigrasi ke [Alat AWS untuk PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/). Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat [pengumuman mode pemeliharaan](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/) kami.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Tentukan AWS Wilayah
<a name="pstools-installing-specifying-region"></a>

Ada dua cara untuk menentukan AWS Wilayah yang akan digunakan saat menjalankan Alat AWS untuk PowerShell perintah:
+ Menggunakan parameter umum `-Region` pada perintah individu.
+ Menggunakan perintah `Set-DefaultAWSRegion` untuk mengatur Wilayah default untuk semua perintah.

Banyak AWS cmdlet gagal jika Alat untuk Windows tidak PowerShell dapat mengetahui Wilayah apa yang akan digunakan. Pengecualian termasuk cmdlet untuk Amazon S3[, Amazon](pstools-s3.md) SES, AWS Identity and Access Management dan, yang secara otomatis default ke titik akhir global.

 **Untuk menentukan wilayah untuk satu AWS perintah** 

Tambahkan parameter `-Region` ke perintah Anda, seperti ini.

```
PS > Get-EC2Image -Region us-west-2
```

 **Untuk mengatur wilayah default untuk semua perintah AWS CLI di sesi saat ini** 

Dari PowerShell command prompt, ketik perintah berikut.

```
PS > Set-DefaultAWSRegion -Region us-west-2
```

**catatan**  
Pengaturan ini tetap berlanjut hanya untuk sesi saat ini. Untuk menerapkan pengaturan ke semua PowerShell sesi Anda, tambahkan perintah ini ke PowerShell profil Anda seperti yang Anda lakukan untuk `Import-Module` perintah.

 **Untuk melihat wilayah default saat ini untuk semua perintah AWS CLI** 

Dari PowerShell command prompt, ketik perintah berikut.

```
PS > Get-DefaultAWSRegion

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

 **Untuk menghapus Wilayah default saat ini untuk semua perintah AWS CLI** 

Dari PowerShell command prompt, ketik perintah berikut.

```
PS > Clear-DefaultAWSRegion
```

 **Untuk melihat daftar semua AWS Wilayah yang tersedia** 

Dari PowerShell command prompt, ketik perintah berikut. Kolom ketiga dalam output sampel mengidentifikasi Wilayah mana yang merupakan default untuk sesi Anda saat ini.

```
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
...
```

**catatan**  
Beberapa Wilayah mungkin didukung tetapi tidak termasuk dalam output dari cmdlet `Get-AWSRegion`. Misalnya, hal ini terkadang berlaku untuk Wilayah yang belum global. Jika Anda tidak dapat menentukan Wilayah dengan menambahkan parameter `-Region` ke perintah, coba sebutkan Wilayah di titik akhir kustom sebagai gantinya, seperti yang ditunjukkan di bagian berikut.

## Mencantumkan Titik Akhir Kustom atau Tidak Standar
<a name="specifying-a-custom-or-nonstandard-endpoint"></a>

Tentukan titik akhir kustom sebagai URL dengan menambahkan parameter `-EndpointUrl` umum ke PowerShell perintah Tools for Windows Anda, dalam format contoh berikut.

```
PS > Some-AWS-PowerShellCmdlet -EndpointUrl "custom endpoint URL" -Other -Parameters
```

Berikut ini adalah sebuah contoh menggunakan cmdlet `Get-EC2Instance`. Titik akhir kustom ada di `us-west-2`, atau Wilayah US West (Oregon) dalam contoh ini, tetapi Anda dapat menggunakan Wilayah AWS yang didukung lainnya, termasuk wilayah yang tidak disebutkan oleh `Get-AWSRegion`.

```
PS > Get-EC2Instance -EndpointUrl "https://service-custom-url.us-west-2.amazonaws.com" -InstanceID "i-0555a30a2000000e1"
```

## Informasi tambahan
<a name="region-additional-info"></a>

Untuk informasi tambahan tentang AWS Wilayah, lihat [AWS Wilayah](https://docs.aws.amazon.com/sdkref/latest/guide/feature-region.html) di *Panduan Referensi AWS SDKs dan Alat*.