使用 Tools for PowerShell V4 的 CloudTrail 示例 - AWS Tools for PowerShell（版本 4）
操作

AWS Tools for PowerShell 版本 5（V5）已经发布！

要开始使用新版本的工具，请参阅《AWS Tools for PowerShell 用户指南（V5）》，特别是关于迁移到 V5 的主题。

使用 Tools for PowerShell V4 的 CloudTrail 示例

以下代码示例演示如何通过将 AWS Tools for PowerShell V4 与 CloudTrail 结合使用，来执行操作和实现常见场景。

操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。

每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。

主题

操作

以下代码示例演示了如何使用 Find-CTEvent。

Tools for PowerShell V4

示例 1：返回过去七天内发生的所有事件。默认情况下，cmdlet 会自动发出多个调用以传送所有事件，当服务指示没有更多数据可用时退出。

Find-CTEvent

示例 2：返回过去七天内发生的所有事件，且指定的区域不是当前 Shell 默认区域。

Find-CTEvent -Region eu-central-1

示例 3：返回与 RunInstances API 调用关联的所有事件。

Find-CTEvent -LookupAttribute @{ AttributeKey="EventName"; AttributeValue="RunInstances" }

示例 4：返回前 5 个可用事件。

Find-CTEvent -MaxResult 5

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 LookupEvents。

以下代码示例演示了如何使用 Get-CTTrail。

Tools for PowerShell V4

示例 1：返回与您账户的当前区域关联的所有跟踪的设置。

Get-CTTrail

示例 2：返回指定跟踪的设置。

Get-CTTrail -TrailNameList trail1,trail2

示例 3：返回在当前 Shell 默认区域以外的区域 [在本例中为法兰克福（eu-central-1）区域] 中创建的指定跟踪的设置。

Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 DescribeTrails。

以下代码示例演示了如何使用 Get-CTTrailStatus。

Tools for PowerShell V4

示例 1：返回名为“myExampleTrail”的跟踪的状态信息。返回的数据包括有关传输错误、Amazon SNS 和 Amazon S3 错误以及跟踪的开始和停止日志记录时间的信息。此示例假设跟踪是在与当前 Shell 默认区域相同的区域中创建的。

Get-CTTrailStatus -Name myExampleTrail

示例 2：返回在当前 Shell 默认区域以外的区域 [在本例中为法兰克福（eu-central-1）区域] 中创建的跟踪的状态信息。

Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 GetTrailStatus。

以下代码示例演示了如何使用 New-CTTrail。

Tools for PowerShell V4

示例 1：创建将使用存储桶“amzn-s3-demo-bucket”来存储日志文件的跟踪。

New-CTTrail -Name "awscloudtrail-example" -S3BucketName "amzn-s3-demo-bucket"

示例 2：创建将使用存储桶“amzn-s3-demo-bucket”来存储日志文件的跟踪。表示日志的 S3 对象的通用键前缀为“mylogs”。当新日志传送到存储桶时，系统将向 SNS 主题“mlog-deliverytopic”发送通知。此示例使用 splatting 向 cmdlet 提供参数值。

$params = @{
    Name="awscloudtrail-example"
    S3BucketName="amzn-s3-demo-bucket"
    S3KeyPrefix="mylogs"
    SnsTopicName="mlog-deliverytopic"
}      
New-CTTrail @params

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 CreateTrail。

以下代码示例演示了如何使用 Remove-CTTrail。

Tools for PowerShell V4

示例 1：删除指定的跟踪。在运行此命令之前，系统会提示您进行确认。要禁止确认，请添加 -Force 开关参数。

Remove-CTTrail -Name "awscloudtrail-example"

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 DeleteTrail。

以下代码示例演示了如何使用 Start-CTLogging。

Tools for PowerShell V4

示例 1：开始为名为“myExampleTrail”的跟踪记录 AWS API 调用和日志文件传输。此示例假设跟踪是在与当前 Shell 默认区域相同的区域中创建的。

Start-CTLogging -Name myExampleTrail

示例 2：开始为在当前 Shell 默认区域以外的区域 [在本例中为法兰克福（eu-central-1）区域] 中创建的跟踪记录 AWS API 调用和日志文件传输。

Start-CTLogging -Name myExampleTrail -Region eu-central-1

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 StartLogging。

以下代码示例演示了如何使用 Stop-CTLogging。

Tools for PowerShell V4

示例 1：暂停为名为“myExampleTrail”的跟踪记录 AWS API 调用和日志文件传输。此示例假设跟踪是在与当前 Shell 默认区域相同的区域中创建的。

Stop-CTLogging -Name myExampleTrail

示例 2：暂停为在当前 Shell 默认区域以外的区域 [在本例中为法兰克福（eu-central-1）区域] 中创建的跟踪记录 AWS API 调用和日志文件传输。

Stop-CTLogging -Name myExampleTrail -Region eu-central-1

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 StopLogging。

以下代码示例演示了如何使用 Update-CTTrail。

Tools for PowerShell V4

示例 1：更新指定的跟踪，以便记录全局服务事件（例如来自 IAM 的服务事件），并将后续日志文件的通用键前缀更改为“globallogs”。

Update-CTTrail -Name "awscloudtrail-example" -IncludeGlobalServiceEvents $true -S3KeyPrefix "globallogs"

示例 2：更新指定的跟踪，以便将有关新日志传输的通知发送到指定的 SNS 主题。

Update-CTTrail -Name "awscloudtrail-example" -SnsTopicName "mlog-deliverytopic2"

示例 3：更新指定的跟踪，以便将日志传送到其它存储桶。

Update-CTTrail -Name "awscloudtrail-example" -S3BucketName "otherlogs"

  • 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考（V4）》中的 UpdateTrail。