のバージョン 5 (V5) AWS Tools for PowerShell がリリースされました。
重要な変更とアプリケーションの移行については、[「移行トピック](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)」を参照してください。
[https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html](https://docs.aws.amazon.com/powershell/v5/userguide/migrating-v5.html)
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Tools for PowerShell V5 を使用した CloudTrail の例
次のコード例は、CloudTrail で AWS Tools for PowerShell V5 を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。
**Topics**
+ [アクション](#actions)
## アクション
### `Find-CTEvent`
次のコード例は、`Find-CTEvent` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 過去 7 日間に発生したすべてのイベントを返します。コマンドレットはデフォルトで、すべてのイベントを配信するために複数の呼び出しを自動的に実行し、サービスがこれ以上データがないことを示した時点で終了します。**
```
Find-CTEvent
```
**例 2: 現在のシェルのデフォルト以外のリージョンを指定して、過去 7 日間に発生したすべてのイベントを返します。**
```
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 コマンドレットリファレンス (V5)* の「[LookupEvents](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。
### `Get-CTTrail`
次のコード例は、`Get-CTTrail` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: アカウントの現在のリージョンに関連付けられているすべての証跡の設定を返します。**
```
Get-CTTrail
```
**例 2: 指定された証跡の設定を返します。**
```
Get-CTTrail -TrailNameList trail1,trail2
```
**例 3: 現在のシェルのデフォルト (この場合はフランクフルト (eu-central-1) リージョン) 以外のリージョンで作成された、指定された証跡の設定を返します。**
```
Get-CTTrail -TrailNameList trailABC,trailDEF -Region eu-central-1
```
+ API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DescribeTrails](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。
### `Get-CTTrailStatus`
次のコード例は、`Get-CTTrailStatus` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 「myExampleTrail」という名前の証跡のステータス情報を返します。返されるデータには、配信エラー、Amazon SNS および Amazon S3 エラー、証跡のログ記録の開始時間と停止時間に関する情報が含まれます。この例では、証跡が現在のシェルのデフォルトリージョンと同じリージョンで作成されたことを前提としています。**
```
Get-CTTrailStatus -Name myExampleTrail
```
**例 2: 現在のシェルのデフォルト (この場合はフランクフルト (eu-central-1) リージョン) 以外のリージョンで作成された証跡のステータス情報を返します。**
```
Get-CTTrailStatus -Name myExampleTrail -Region eu-central-1
```
+ API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[GetTrailStatus](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。
### `New-CTTrail`
次のコード例は、`New-CTTrail` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 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」に通知が送信されます。この例では、スプラッティングを使用してパラメータ値をコマンドレットに指定します。**
```
$params = @{
Name="awscloudtrail-example"
S3BucketName="amzn-s3-demo-bucket"
S3KeyPrefix="mylogs"
SnsTopicName="mlog-deliverytopic"
}
New-CTTrail @params
```
+ API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[CreateTrail](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。
### `Remove-CTTrail`
次のコード例は、`Remove-CTTrail` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 指定された証跡を削除します。コマンドを実行する前に確認を求められます。-Force スイッチを追加すると、確認メッセージが表示されなくなります。**
```
Remove-CTTrail -Name "awscloudtrail-example"
```
+ API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[DeleteTrail](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。
### `Start-CTLogging`
次のコード例は、`Start-CTLogging` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: 'myExampleTrail' という名前の証跡の AWS API コールとログファイルの配信の記録を開始します。この例では、証跡が現在のシェルのデフォルトリージョンと同じリージョンで作成されたことを前提としています。**
```
Start-CTLogging -Name myExampleTrail
```
**例 2: 現在のシェルデフォルト (この場合は、フランクフルト (eu-central-1) リージョン) 以外のリージョンで作成された証跡の AWS API コールとログファイル配信の記録を開始します。**
```
Start-CTLogging -Name myExampleTrail -Region eu-central-1
```
+ API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[StartLogging](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。
### `Stop-CTLogging`
次のコード例は、`Stop-CTLogging` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 1: myExampleTrail」という名前の証跡の AWS API コールとログファイル配信の記録を停止します。この例では、証跡が現在のシェルのデフォルトリージョンと同じリージョンで作成されたことを前提としています。**
```
Stop-CTLogging -Name myExampleTrail
```
**例 2: 現在のシェルデフォルト (この場合は、フランクフルト (eu-central-1) リージョン) 以外のリージョンで作成された証跡の AWS API コールとログファイル配信の記録を停止します。**
```
Stop-CTLogging -Name myExampleTrail -Region eu-central-1
```
+ API の詳細については、*AWS Tools for PowerShell コマンドレットリファレンス (V5)* の「[StopLogging](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。
### `Update-CTTrail`
次のコード例は、`Update-CTTrail` を使用する方法を示しています。
**Tools for PowerShell V5**
**例 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 コマンドレットリファレンス (V5)* の「[UpdateTrail](https://docs.aws.amazon.com/powershell/v5/reference)」を参照してください。