Menggunakan ClientConfig parameter dalam cmdlet - AWS Tools for PowerShell

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

ClientConfigParameter dapat digunakan untuk menentukan pengaturan konfigurasi tertentu saat Anda terhubung ke layanan. Sebagian besar properti yang mungkin dari parameter ini didefinisikan dalam Amazon.Runtime.ClientConfigkelas, yang diwariskan ke dalam API untukAWS layanan. Untuk contoh warisan sederhana, lihat Amazon.Keyspaces.AmazonKeyspacesConfigkelas. Selain itu, beberapa layanan mendefinisikan properti tambahan yang sesuai hanya untuk layanan itu. Untuk contoh properti tambahan yang telah didefinisikan, lihat Amazon.S3.AmazonS3Configkelas, khususnyaForcePathStyle properti.

MenggunakanClientConfig parameter

Untuk menggunakanClientConfig parameter, Anda dapat menentukannya pada baris perintah sebagaiClientConfig objek atau menggunakan PowerShell splatting untuk meneruskan kumpulan nilai parameter ke perintah sebagai satu unit. Metode ini ditunjukkan dalam contoh berikut. Contoh mengasumsikan bahwaAWS.Tools.S3 modul telah diinstal dan diimpor, dan bahwa Anda memiliki profil[default] kredenial dengan izin yang sesuai.

MendefinisikanClientConfig objek

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

MenambahkanClientConfig properti dengan menggunakan PowerShell splatting

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

Menggunakan properti yang tidak terdefinisi

Saat menggunakan PowerShell splatting, jika Anda menentukanClientConfig properti yang tidak ada,AWS Tools for PowerShell tidak mendeteksi kesalahan sampai 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 serupa dengan yang 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.

MenentukanWilayah AWS

Anda dapat menggunakanClientConfig parameterWilayah AWS untuk mengatur perintah. Wilayah diatur melaluiRegionEndpoint properti. AWS Tools for PowerShellMenghitung Wilayah untuk digunakan sesuai dengan prioritas berikut:

  1. -RegionParameternya

  2. Wilayah dilewatkan dalamClientConfig parameter

  3. PowerShell Sesi

  4. AWSconfigFile yang dibagikan

  5. Variabel lingkungan

  6. Metadata instans Amazon EC2, jika diaktifkan.