Alat AWS untuk PowerShell Versi 5 (V5) dalam pratinjau. Untuk melihat konten V5, yang dapat berubah, dan mencoba versi baru, lihat panduan pengguna versi 5 (pratinjau). Untuk informasi spesifik tentang melanggar perubahan dan migrasi ke V5, lihat topik migrasi dalam panduan tersebut.

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 ketika Anda terhubung ke layanan. Sebagian besar properti yang mungkin dari parameter ini didefinisikan di Amazon.Runtime.ClientConfigkelas, yang diwarisi ke APIs untuk AWS layanan. Untuk contoh pewarisan sederhana, lihat Amazon.Keyspaces.AmazonKeyspacesConfigkelasnya. Selain itu, beberapa layanan mendefinisikan properti tambahan yang hanya sesuai untuk layanan itu. Untuk contoh properti tambahan yang telah didefinisikan, lihat Amazon.S3.AmazonS3Configkelas, khususnya ForcePathStyle properti.

Menggunakan ClientConfig parameter

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

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

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: