È stata rilasciata la versione 5 (V5) di! AWS Strumenti per PowerShell
Per informazioni sulle modifiche introduttive e sulla migrazione delle applicazioni, consulta l'argomento sulla migrazione.
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
CloudTrail esempi di utilizzo di Tools for V5 PowerShell
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Strumenti per PowerShell V5 con. CloudTrail
Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
Argomenti
Azioni
Il seguente esempio di codice mostra come utilizzareFind-CTEvent.
- Strumenti per PowerShell V5
-
Esempio 1: restituisce tutti gli eventi che si sono verificati negli ultimi sette giorni. Per impostazione predefinita, il cmdlet effettua automaticamente più chiamate per distribuire tutti gli eventi, uscendo dal processo quando il servizio indica che non sono disponibili altri dati.
Find-CTEventEsempio 2: restituisce tutti gli eventi che si sono verificati negli ultimi sette giorni specificando una Regione diversa dall’impostazione predefinita della shell corrente.
Find-CTEvent -Region eu-central-1Esempio 3: restituisce tutti gli eventi associati alla chiamata RunInstances API.
Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }Esempio 4: restituisce i primi 5 eventi disponibili.
Find-CTEvent -MaxResult 5-
Per i dettagli sull'API, vedere LookupEventsin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Get-CTTrail
- Strumenti per PowerShell V5
-
Esempio 1: restituisce le impostazioni di tutti i trail associati alla Regione corrente per l’account in uso.
Get-CTTrailEsempio 2: restituisce le impostazioni dei trail specificati.
Get-CTTrail -TrailNameList trail1,trail2Esempio 3: restituisce le impostazioni dei trail specificati creati in una Regione diversa dall’attuale impostazione predefinita della shell (in questo caso la Regione Francoforte (eu-central)).
Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1-
Per i dettagli sull'API, vedere DescribeTrailsin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Get-CTTrailStatus
- Strumenti per PowerShell V5
-
Esempio 1: restituisce le informazioni sullo stato del percorso con il nome 'myExampleTrail'. I dati restituiti includono informazioni su errori di distribuzione, errori di Amazon SNS e Amazon S3 e tempi di avvio e arresto della registrazione per il trail. Questo esempio presuppone che il trail sia stato creato nella stessa Regione della shell predefinita corrente.
Get-CTTrailStatus -Name myExampleTrailEsempio 2: restituisce le impostazioni sullo stato di un trail creato in una Regione diversa dall’attuale impostazione predefinita della shell (in questo caso la Regione Francoforte (eu-central)).
Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1-
Per i dettagli sull'API, vedere GetTrailStatusin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. New-CTTrail
- Strumenti per PowerShell V5
-
Esempio 1: crea un trail che utilizzerà il bucket “amzn-s3-demo-bucket” per l’archiviazione dei file di log.
New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"Esempio 2: crea un trail che utilizzerà il bucket “amzn-s3-demo-bucket” per l’archiviazione dei file di log. Gli oggetti S3 che rappresentano i log saranno tutti associati al prefisso di chiave comune “mylogs”. Quando vengono distribuiti nuovi log al bucket, verrà inviata una notifica all’argomento SNS “mlog-deliverytopic”. In questo esempio viene utilizzato lo splatting per fornire i valori dei parametri al cmdlet.
$params = @{ Name="awscloudtrail-example" S3BucketName="amzn-s3-demo-bucket" S3KeyPrefix="mylogs" SnsTopicName="mlog-deliverytopic" } New-CTTrail @params-
Per i dettagli sull'API, vedere CreateTrailin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Remove-CTTrail
- Strumenti per PowerShell V5
-
Esempio 1: elimina il trail specificato. Prima di eseguire il comando, verrà richiesta una conferma. Per disattivare la conferma, aggiungi il parametro -Force.
Remove-CTTrail -Name "awscloudtrail-example"-
Per i dettagli sull'API, vedere DeleteTrailin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Start-CTLogging
- Strumenti per PowerShell V5
-
Esempio 1: avvia la registrazione delle chiamate AWS API e la consegna dei file di registro per il percorso denominato 'myExampleTrail'. Questo esempio presuppone che il trail sia stato creato nella stessa Regione della shell predefinita corrente.
Start-CTLogging -Name myExampleTrailEsempio 2: avvia la registrazione delle chiamate AWS API e la consegna dei file di registro per un percorso creato in una regione diversa dall'attuale impostazione predefinita della shell (in questo caso, la regione di Francoforte (eu-central-1)).
Start-CTLogging -Name myExampleTrail -Region eu-central-1-
Per i dettagli sull'API, vedere StartLoggingin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Stop-CTLogging
- Strumenti per PowerShell V5
-
Esempio 1: sospende la registrazione delle chiamate AWS API e la consegna dei file di registro per il percorso denominato ''. myExampleTrail Questo esempio presuppone che il trail sia stato creato nella stessa Regione della shell predefinita corrente.
Stop-CTLogging -Name myExampleTrailEsempio 2: sospende la registrazione delle chiamate AWS API e la consegna dei file di registro per un trail creato in una regione diversa dall'attuale impostazione predefinita della shell (in questo caso, la regione di Francoforte (eu-central-1)).
Stop-CTLogging -Name myExampleTrail -Region eu-central-1-
Per i dettagli sull'API, vedere StopLoggingin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
Il seguente esempio di codice mostra come utilizzare. Update-CTTrail
- Strumenti per PowerShell V5
-
Esempio 1: aggiorna il trail specificato in modo che gli eventi del servizio globale, ad esempio quelli di IAM, vengano registrati e modifica il prefisso di chiave comune per i successivi file di log in “globallogs”.
Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"Esempio 2: aggiorna il trail specificato in modo che le notifiche relative alle nuove distribuzioni di log vengano inviate all’argomento SNS specificato.
Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"Esempio 3: aggiorna il trail specificato in modo che i log vengano distribuiti a un bucket diverso.
Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"-
Per i dettagli sull'API, vedere UpdateTrailin AWS Strumenti per PowerShell Cmdlet Reference (V5).
-