Versi 5 (V5) Alat AWS untuk PowerShell telah dirilis!
Untuk informasi tentang mengubah perubahan dan memigrasikan aplikasi Anda, lihat topik https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html migrasi.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
CloudTrail contoh menggunakan Tools for PowerShell V5
Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan Alat AWS untuk PowerShell V5 dengan CloudTrail.
Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.
Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.
Topik
Tindakan
Contoh kode berikut menunjukkan cara menggunakanFind-CTEvent.
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan semua peristiwa yang telah terjadi selama tujuh hari terakhir. Cmdlet secara default secara otomatis membuat beberapa panggilan untuk mengirimkan semua peristiwa, keluar ketika layanan menunjukkan tidak ada data lebih lanjut yang tersedia.
Find-CTEventContoh 2: Mengembalikan semua peristiwa yang telah terjadi selama tujuh hari terakhir yang menentukan wilayah yang bukan default shell saat ini.
Find-CTEvent -Region eu-central-1Contoh 3: Mengembalikan semua peristiwa yang terkait dengan panggilan RunInstances API.
Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }Contoh 4: Mengembalikan 5 peristiwa pertama yang tersedia.
Find-CTEvent -MaxResult 5-
Untuk detail API, lihat LookupEvents di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-CTTrail.
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan pengaturan semua jalur yang terkait dengan wilayah saat ini untuk akun Anda.
Get-CTTrailContoh 2: Mengembalikan pengaturan untuk jalur yang ditentukan.
Get-CTTrail -TrailNameList trail1,trail2Contoh 3: Mengembalikan pengaturan untuk jalur tertentu yang dibuat di wilayah selain default shell saat ini (dalam hal ini wilayah Frankfurt (eu-central-1)).
Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1-
Untuk detail API, lihat DescribeTrails di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanGet-CTTrailStatus.
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan informasi status untuk jejak dengan nama 'say ExampleTrail a'. Data yang dikembalikan mencakup informasi tentang kesalahan pengiriman, kesalahan Amazon SNS dan Amazon S3, serta waktu pencatatan mulai dan berhenti untuk jejak. Contoh ini mengasumsikan jejak dibuat di wilayah yang sama dengan default shell saat ini.
Get-CTTrailStatus -Name myExampleTrailContoh 2: Mengembalikan informasi status untuk jejak yang dibuat di wilayah selain default shell saat ini (dalam hal ini, wilayah Frankfurt (eu-central-1)).
Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1-
Untuk detail API, lihat GetTrailStatus di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanNew-CTTrail.
- Alat untuk PowerShell V5
-
Contoh 1: Membuat jejak yang akan menggunakan bucket 'amzn-s3-demo-bucket' untuk penyimpanan file log.
New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"Contoh 2: Membuat jejak yang akan menggunakan bucket 'amzn-s3-demo-bucket' untuk penyimpanan file log. Objek S3 yang mewakili log akan memiliki awalan kunci umum 'mylogs'. Ketika log baru dikirim ke bucket, pemberitahuan akan dikirim ke topik SNS 'mlog-deliverytopic'. Contoh ini menggunakan splatting untuk memasok nilai parameter ke cmdlet.
$params = @{ Name="awscloudtrail-example" S3BucketName="amzn-s3-demo-bucket" S3KeyPrefix="mylogs" SnsTopicName="mlog-deliverytopic" } New-CTTrail @params-
Untuk detail API, lihat CreateTrail di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanRemove-CTTrail.
- Alat untuk PowerShell V5
-
Contoh 1: Menghapus jejak yang ditentukan. Anda akan diminta untuk konfirmasi sebelum perintah dijalankan. Untuk menekan konfirmasi, tambahkan parameter sakelar -Force.
Remove-CTTrail -Name "awscloudtrail-example"-
Untuk detail API, lihat DeleteTrail di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanStart-CTLogging.
- Alat untuk PowerShell V5
-
Contoh 1: Memulai perekaman panggilan AWS API dan pengiriman file log untuk jejak bernama 'my ExampleTrail '. Contoh ini mengasumsikan jejak dibuat di wilayah yang sama dengan default shell saat ini.
Start-CTLogging -Name myExampleTrailContoh 2: Memulai perekaman panggilan AWS API dan pengiriman file log untuk jejak yang dibuat di wilayah selain default shell saat ini (dalam hal ini, wilayah Frankfurt (eu-central-1)).
Start-CTLogging -Name myExampleTrail -Region eu-central-1-
Untuk detail API, lihat StartLogging di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanStop-CTLogging.
- Alat untuk PowerShell V5
-
Contoh 1: Menangguhkan perekaman panggilan AWS API dan pengiriman file log untuk jejak bernama 'saya'. ExampleTrail Contoh ini mengasumsikan jejak dibuat di wilayah yang sama dengan default shell saat ini.
Stop-CTLogging -Name myExampleTrailContoh 2: Menangguhkan perekaman panggilan AWS API dan pengiriman file log untuk jejak yang dibuat di wilayah selain default shell saat ini (dalam hal ini, wilayah Frankfurt (eu-central-1)).
Stop-CTLogging -Name myExampleTrail -Region eu-central-1-
Untuk detail API, lihat StopLogging di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-
Contoh kode berikut menunjukkan cara menggunakanUpdate-CTTrail.
- Alat untuk PowerShell V5
-
Contoh 1: Memperbarui jejak yang ditentukan sehingga peristiwa layanan global (seperti yang dari IAM) dicatat dan mengubah awalan kunci umum dari file log ke depan menjadi 'globallogs'.
Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"Contoh 2: Memperbarui jejak yang ditentukan sehingga pemberitahuan tentang pengiriman log baru dikirim ke topik SNS yang ditentukan.
Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"Contoh 3: Memperbarui jejak yang ditentukan sehingga log dikirim ke bucket yang berbeda.
Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"-
Untuk detail API, lihat UpdateTrail di Referensi Alat AWS untuk PowerShell Cmdlet (V5).
-