Version 5 (V5) von AWS -Tools für PowerShell wurde veröffentlicht!
Informationen zum Einstieg in die neue Version der Tools finden Sie im AWS -Tools für PowerShell Benutzerhandbuch (V5), insbesondere im Thema Migration zu V5.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
CloudTrail Beispiele für die Verwendung von Tools für V4 PowerShell
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Aktionen ausführen und allgemeine Szenarien implementieren, indem Sie AWS -Tools für PowerShell V4 mit verwenden CloudTrail.
Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.
Themen
Aktionen
Das folgende Codebeispiel zeigt die Verwendung vonFind-CTEvent.
- Tools für PowerShell V4
-
Beispiel 1: Gibt alle Ereignisse zurück, die in den letzten sieben Tagen aufgetreten sind. Das Cmdlet führt standardmäßig automatisch mehrere Aufrufe aus, um alle Ereignisse bereitzustellen, und beendet die Ausführung, wenn der Service angibt, dass keine weiteren Daten verfügbar sind.
Find-CTEventBeispiel 2: Gibt alle Ereignisse zurück, die in den letzten sieben Tagen aufgetreten sind, und gibt dabei eine Region an, die nicht dem aktuellen Shell-Standard entspricht.
Find-CTEvent -Region eu-central-1Beispiel 3: Gibt alle Ereignisse zurück, die mit dem RunInstances API-Aufruf verknüpft sind.
Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }Beispiel 4: Gibt die ersten 5 verfügbaren Ereignisse zurück.
Find-CTEvent -MaxResult 5-
Einzelheiten zur API finden Sie unter LookupEvents AWS -Tools für PowerShellCmdlet-Referenz (V4).
-
Das folgende Codebeispiel zeigt die Verwendung. Get-CTTrail
- Tools für PowerShell V4
-
Beispiel 1: Gibt die Einstellungen aller Trails zurück, die der aktuellen Region Ihres Kontos zugeordnet sind.
Get-CTTrailBeispiel 2: Gibt die Einstellungen für die angegebenen Trails zurück.
Get-CTTrail -TrailNameList trail1,trail2Beispiel 3: Gibt die Einstellungen für die angegebenen Trails zurück, die in einer anderen Region als der aktuellen Shell-Standardregion (in diesem Fall der Region Frankfurt (eu-central-1)) erstellt wurden).
Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1-
Einzelheiten zur API finden Sie unter DescribeTrails AWS -Tools für PowerShellCmdlet-Referenz (V4).
-
Das folgende Codebeispiel zeigt die Verwendung. Get-CTTrailStatus
- Tools für PowerShell V4
-
Beispiel 1: Gibt Statusinformationen für den Trail mit dem Namen 'myExampleTrail' zurück. Die zurückgegebenen Daten umfassen Informationen zu Zustellungsfehlern, Amazon-SNS- und Amazon-S3-Fehlern sowie Start- und Endzeiten für die Protokollierung des Trails. In diesem Beispiel wird davon ausgegangen, dass der Trail in derselben Region erstellt wurde wie die aktuelle Shell-Standardregion.
Get-CTTrailStatus -Name myExampleTrailBeispiel 2: Gibt Statusinformationen für einen Trail zurück, der in einer anderen Region als der aktuellen Shell-Standardregion erstellt wurde (in diesem Fall in der Region Frankfurt (eu-central).
Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1-
Einzelheiten zur API finden Sie unter GetTrailStatus AWS -Tools für PowerShellCmdlet-Referenz (V4).
-
Das folgende Codebeispiel zeigt die Verwendung. New-CTTrail
- Tools für PowerShell V4
-
Beispiel 1: Erzeugt einen Trail, der den Bucket „amzn-s3-demo-bucket“ für die Speicherung von Protokolldateien verwendet.
New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"Beispiel 2: Erzeugt einen Trail, der den Bucket „amzn-s3-demo-bucket“ für die Speicherung von Protokolldateien verwendet. Die S3-Objekte, die die Protokolle darstellen, verfügen über das gemeinsame Schlüsselpräfix „mylogs“. Wenn neue Protokolle an den Bucket geliefert werden, wird eine Benachrichtigung an das SNS-Thema „mlog-deliverytopic” gesendet. In diesem Beispiel wird Splatting verwendet, um die Parameterwerte an das Cmdlet zu übergeben.
$params = @{ Name="awscloudtrail-example" S3BucketName="amzn-s3-demo-bucket" S3KeyPrefix="mylogs" SnsTopicName="mlog-deliverytopic" } New-CTTrail @params-
Einzelheiten zur API finden Sie unter CreateTrail AWS -Tools für PowerShellCmdlet-Referenz (V4).
-
Das folgende Codebeispiel zeigt die Verwendung. Remove-CTTrail
- Tools für PowerShell V4
-
Beispiel 1: Löscht den angegebenen Trail. Sie werden um eine Bestätigung gebeten, bevor der Befehl ausgeführt wird. Um die Bestätigung zu unterdrücken, fügen Sie den Schalterparameter -Force hinzu.
Remove-CTTrail -Name "awscloudtrail-example"-
Einzelheiten zur API finden Sie unter DeleteTrail AWS -Tools für PowerShellCmdlet-Referenz (V4).
-
Das folgende Codebeispiel zeigt die Verwendung. Start-CTLogging
- Tools für PowerShell V4
-
Beispiel 1: Startet die Aufzeichnung von AWS API-Aufrufen und die Bereitstellung von Protokolldateien für den Trail mit dem Namen 'myExampleTrail'. In diesem Beispiel wird davon ausgegangen, dass der Trail in derselben Region erstellt wurde wie die aktuelle Shell-Standardregion.
Start-CTLogging -Name myExampleTrailBeispiel 2: Startet die Aufzeichnung von AWS API-Aufrufen und die Bereitstellung von Protokolldateien für einen Trail, der in einer anderen Region als dem aktuellen Shell-Standard erstellt wurde (in diesem Fall der Region Frankfurt (eu-central-1)).
Start-CTLogging -Name myExampleTrail -Region eu-central-1-
Einzelheiten zur API finden Sie unter StartLogging AWS -Tools für PowerShellCmdlet-Referenz (V4).
-
Das folgende Codebeispiel zeigt die Verwendung. Stop-CTLogging
- Tools für PowerShell V4
-
Beispiel 1: Unterbricht die Aufzeichnung von AWS API-Aufrufen und die Bereitstellung von Protokolldateien für den Trail mit dem Namen 'myExampleTrail'. In diesem Beispiel wird davon ausgegangen, dass der Trail in derselben Region erstellt wurde wie die aktuelle Shell-Standardregion.
Stop-CTLogging -Name myExampleTrailBeispiel 2: Unterbricht die Aufzeichnung von AWS API-Aufrufen und die Bereitstellung von Protokolldateien für einen Trail, der in einer anderen Region als der aktuellen Shell-Standardregion erstellt wurde (in diesem Fall in der Region Frankfurt (eu-central-1)).
Stop-CTLogging -Name myExampleTrail -Region eu-central-1-
Einzelheiten zur API finden Sie unter AWS -Tools für PowerShell Cmdlet-Referenz (StopLoggingV4).
-
Das folgende Codebeispiel zeigt die Verwendung. Update-CTTrail
- Tools für PowerShell V4
-
Beispiel 1: Aktualisiert den angegebenen Trail, sodass globale Serviceereignisse (z. B. von IAM) aufgezeichnet werden, und ändert das gemeinsame Schlüsselpräfix der Protokolldateien künftig in „globallogs“.
Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"Beispiel 2: Aktualisiert den angegebenen Trail, sodass Benachrichtigungen über neue Protokollbereitstellungen an das angegebene SNS-Thema gesendet werden.
Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"Beispiel 3: Aktualisiert den angegebenen Trail, sodass Protokolle in einen anderen Bucket zugestellt werden.
Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"-
Einzelheiten zur API finden Sie unter UpdateTrail AWS -Tools für PowerShellCmdlet-Referenz (V4).
-