AWS Tools for PowerShell V4 telah memasuki mode pemeliharaan.

Kami menyarankan Anda bermigrasi ke AWS Tools for PowerShell V5. Untuk detail dan informasi tambahan tentang cara bermigrasi, silakan lihat pengumuman mode pemeliharaan 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

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, AWS Tools for 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 AWS Region

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