Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples.
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
L’esempio di codice seguente mostra come utilizzare Find-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 LookupEvents in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
L’esempio di codice seguente mostra come utilizzare Get-CTTrail.
- Strumenti per V5 PowerShell
-
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 DescribeTrails in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
L’esempio di codice seguente mostra come utilizzare Get-CTTrailStatus.
- Strumenti per V5 PowerShell
-
Esempio 1: restituisce le informazioni sullo stato del percorso con il nome 'my'ExampleTrail. 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 GetTrailStatus in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
L’esempio di codice seguente mostra come utilizzare New-CTTrail.
- Strumenti per V5 PowerShell
-
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 CreateTrail in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
L’esempio di codice seguente mostra come utilizzare Remove-CTTrail.
- Strumenti per V5 PowerShell
-
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 DeleteTrail in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
L’esempio di codice seguente mostra come utilizzare Start-CTLogging.
- Strumenti per V5 PowerShell
-
Esempio 1: avvia la registrazione delle chiamate AWS API e la consegna dei file di registro per il percorso denominato «my»ExampleTrail. 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 StartLogging in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
L’esempio di codice seguente mostra come utilizzare Stop-CTLogging.
- Strumenti per V5 PowerShell
-
Esempio 1: sospende la registrazione delle chiamate AWS API e la consegna dei file di registro per il percorso denominato «my»ExampleTrail. 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 della 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)).
Stop-CTLogging -Name myExampleTrail -Region eu-central-1-
Per i dettagli sull'API, vedere StopLogging in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-
L’esempio di codice seguente mostra come utilizzare Update-CTTrail.
- Strumenti per V5 PowerShell
-
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 UpdateTrail in AWS Strumenti per PowerShell Cmdlet Reference (V5).
-