D'autres exemples de AWS SDK sont disponibles dans le référentiel AWS Doc SDK Examples
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
CloudTrail exemples d'utilisation de Tools for PowerShell V4
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CloudTrail.
Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.
Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliserFind-CTEvent
.
- Outils pour PowerShell V4
-
Exemple 1 : renvoie tous les événements survenus au cours des sept derniers jours. Par défaut, l'applet de commande effectue automatiquement plusieurs appels pour transmettre tous les événements, puis s'arrête lorsque le service indique qu'aucune autre donnée n'est disponible.
Find-CTEvent
Exemple 2 : renvoie tous les événements survenus au cours des sept derniers jours en spécifiant une région qui n'est pas la valeur par défaut du shell actuel.
Find-CTEvent -Region eu-central-1
Exemple 3 : renvoie tous les événements associés à l'appel RunInstances d'API.
Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }
Exemple 4 : renvoie les 5 premiers événements disponibles.
Find-CTEvent -MaxResult 5
-
Pour plus de détails sur l'API, reportez-vous LookupEventsà la section Référence des Outils AWS pour PowerShell applets de commande (V4).
-
L'exemple de code suivant montre comment utiliserGet-CTTrail
.
- Outils pour PowerShell V4
-
Exemple 1 : renvoie les paramètres de tous les sentiers associés à la région actuelle pour votre compte.
Get-CTTrail
Exemple 2 : renvoie les paramètres pour les pistes spécifiées.
Get-CTTrail -TrailNameList trail1,trail2
Exemple 3 : renvoie les paramètres pour les sentiers spécifiés qui ont été créés dans une région autre que la région par défaut du shell actuel (dans ce cas, la région de Francfort (eu-central-1)).
Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1
-
Pour plus de détails sur l'API, reportez-vous DescribeTrailsà la section Référence des Outils AWS pour PowerShell applets de commande (V4).
-
L'exemple de code suivant montre comment utiliserGet-CTTrailStatus
.
- Outils pour PowerShell V4
-
Exemple 1 : renvoie les informations d'état du parcours portant le nom « myExampleTrail ». Les données renvoyées incluent des informations sur les erreurs de livraison, les erreurs Amazon SNS et Amazon S3, ainsi que les heures de début et de fin de journalisation du parcours. Cet exemple suppose que le sentier a été créé dans la même région que le shell par défaut actuel.
Get-CTTrailStatus -Name myExampleTrail
Exemple 2 : renvoie les informations d'état d'un parcours créé dans une région autre que la région par défaut du shell actuel (dans ce cas, la région de Francfort (eu-central-1)).
Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1
-
Pour plus de détails sur l'API, reportez-vous GetTrailStatusà la section Référence des Outils AWS pour PowerShell applets de commande (V4).
-
L'exemple de code suivant montre comment utiliserNew-CTTrail
.
- Outils pour PowerShell V4
-
Exemple 1 : crée un journal qui utilisera le bucket « mycloudtrailbucket » pour le stockage des fichiers journaux.
New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"
Exemple 2 : crée un journal qui utilisera le bucket « mycloudtrailbucket » pour le stockage des fichiers journaux. Les objets S3 représentant les journaux auront un préfixe de clé commun « mylogs ». Lorsque de nouveaux journaux sont envoyés au bucket, une notification est envoyée à la rubrique SNS « mlog-deliverytopic ». Cet exemple utilise le splatting pour fournir les valeurs des paramètres à l'applet de commande.
$params = @{ Name="awscloudtrail-example" S3BucketName="amzn-s3-demo-bucket" S3KeyPrefix="mylogs" SnsTopicName="mlog-deliverytopic" } New-CTTrail @params
-
Pour plus de détails sur l'API, reportez-vous CreateTrailà la section Référence des Outils AWS pour PowerShell applets de commande (V4).
-
L'exemple de code suivant montre comment utiliserRemove-CTTrail
.
- Outils pour PowerShell V4
-
Exemple 1 : Supprime le parcours spécifié. Vous serez invité à confirmer avant que la commande ne soit exécutée. Pour supprimer la confirmation, ajoutez le paramètre de commutation -Force.
Remove-CTTrail -Name "awscloudtrail-example"
-
Pour plus de détails sur l'API, reportez-vous DeleteTrailà la section Référence des Outils AWS pour PowerShell applets de commande (V4).
-
L'exemple de code suivant montre comment utiliserStart-CTLogging
.
- Outils pour PowerShell V4
-
Exemple 1 : Démarre l'enregistrement des appels d' AWS API et la livraison du fichier journal pour le journal nommé « myExampleTrail ». Cet exemple suppose que le sentier a été créé dans la même région que le shell par défaut actuel.
Start-CTLogging -Name myExampleTrail
Exemple 2 : Démarre l'enregistrement des appels d' AWS API et la livraison du fichier journal pour un journal créé dans une région autre que la région par défaut du shell actuel (dans ce cas, la région de Francfort (eu-central-1)).
Start-CTLogging -Name myExampleTrail -Region eu-central-1
-
Pour plus de détails sur l'API, reportez-vous StartLoggingà la section Référence des Outils AWS pour PowerShell applets de commande (V4).
-
L'exemple de code suivant montre comment utiliserStop-CTLogging
.
- Outils pour PowerShell V4
-
Exemple 1 : Suspend l'enregistrement des appels d' AWS API et la livraison du fichier journal pour le journal nommé « myExampleTrail ». Cet exemple suppose que le sentier a été créé dans la même région que le shell par défaut actuel.
Stop-CTLogging -Name myExampleTrail
Exemple 2 : Suspend l'enregistrement des appels d' AWS API et la livraison du fichier journal pour un journal créé dans une région autre que la région par défaut du shell actuel (dans ce cas, la région de Francfort (eu-central-1)).
Stop-CTLogging -Name myExampleTrail -Region eu-central-1
-
Pour plus de détails sur l'API, reportez-vous StopLoggingà la section Référence des Outils AWS pour PowerShell applets de commande (V4).
-
L'exemple de code suivant montre comment utiliserUpdate-CTTrail
.
- Outils pour PowerShell V4
-
Exemple 1 : met à jour le journal spécifié afin que les événements de service globaux (tels que ceux provenant d'IAM) soient enregistrés et change le préfixe de clé commun des fichiers journaux à venir en « globallogs ».
Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"
Exemple 2 : met à jour le journal spécifié afin que les notifications concernant les nouvelles livraisons de journaux soient envoyées à la rubrique SNS spécifiée.
Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"
Exemple 3 : met à jour le journal spécifié afin que les journaux soient envoyés dans un autre compartiment.
Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"
-
Pour plus de détails sur l'API, reportez-vous UpdateTrailà la section Référence des Outils AWS pour PowerShell applets de commande (V4).
-