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.

# Menggunakan ClientConfig parameter dalam cmdlet
<a name="pstools-clientconfig"></a>

`ClientConfig`Parameter dapat digunakan untuk menentukan pengaturan konfigurasi tertentu ketika Anda terhubung ke layanan. Sebagian besar properti yang mungkin dari parameter ini didefinisikan di [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Runtime/TClientConfig.html)kelas, yang diwarisi ke APIs untuk AWS layanan. Untuk contoh pewarisan sederhana, lihat [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Keyspaces/TKeyspacesConfig.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/Keyspaces/TKeyspacesConfig.html)kelasnya. Selain itu, beberapa layanan mendefinisikan properti tambahan yang hanya sesuai untuk layanan itu. Untuk contoh properti tambahan yang telah didefinisikan, lihat [https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/S3/TS3Config.html)kelas, khususnya `ForcePathStyle` properti.

## Menggunakan `ClientConfig` parameter
<a name="clientconfig-operation"></a>

Untuk menggunakan `ClientConfig` parameter, Anda dapat menentukannya pada baris perintah sebagai `ClientConfig` objek atau menggunakan PowerShell percikan untuk meneruskan kumpulan nilai parameter ke perintah sebagai unit. Metode-metode ini ditunjukkan dalam contoh berikut. Contoh mengasumsikan bahwa `AWS.Tools.S3` modul telah diinstal dan diimpor, dan bahwa Anda memiliki profil `[default]` kredensional dengan izin yang sesuai.

******Mendefinisikan objek `ClientConfig`**

```
$s3Config = New-Object -TypeName Amazon.S3.AmazonS3Config
$s3Config.ForcePathStyle = $true
$s3Config.Timeout = [TimeSpan]::FromMilliseconds(150000)
Get-S3Object -BucketName <BUCKET_NAME> -ClientConfig $s3Config
```

**Menambahkan `ClientConfig` properti dengan menggunakan PowerShell percikan**

```
$params=@{
    ClientConfig=@{
        ForcePathStyle=$true
        Timeout=[TimeSpan]::FromMilliseconds(150000)
    }
    BucketName="<BUCKET_NAME>"
}

Get-S3Object @params
```

## Menggunakan properti yang tidak ditentukan
<a name="clientconfig-undefined"></a>

Saat menggunakan PowerShell percikan, jika Anda menentukan `ClientConfig` properti yang tidak ada, Alat AWS untuk PowerShell tidak mendeteksi kesalahan hingga runtime, pada saat itu ia mengembalikan pengecualian. Memodifikasi contoh dari atas:

```
$params=@{
    ClientConfig=@{
        ForcePathStyle=$true
        UndefinedProperty="Value"
        Timeout=[TimeSpan]::FromMilliseconds(150000)
    }
    BucketName="<BUCKET_NAME>"
}

Get-S3Object @params
```

Contoh ini menghasilkan pengecualian yang mirip dengan berikut ini:

```
Cannot bind parameter 'ClientConfig'. Cannot create object of type "Amazon.S3.AmazonS3Config". The UndefinedProperty property was not found for the Amazon.S3.AmazonS3Config object.
```

## Menentukan Wilayah AWS
<a name="clientconfig-region"></a>

Anda dapat menggunakan `ClientConfig` parameter Wilayah AWS untuk mengatur perintah. Wilayah diatur melalui `RegionEndpoint` properti. Alat AWS untuk PowerShell Menghitung Wilayah yang akan digunakan sesuai dengan prioritas berikut:

1. `-Region`Parameternya

1. Wilayah dilewatkan dalam `ClientConfig` parameter

1. Keadaan PowerShell sesi

1.  AWS `config`File yang dibagikan

1. Variabel lingkungan

1. Metadata EC2 instans Amazon, jika diaktifkan.