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 예제

다음 코드 예제에서는 CloudTrail과 함께 AWS Tools for PowerShell V4를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 관련 시나리오의 컨텍스트에 따라 표시되며, 개별 서비스 함수를 직접적으로 호출하는 방법을 보여줍니다.

각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

주제

작업

다음 코드 예시는 Find-CTEvent의 사용 방법을 보여 줍니다.

Tools for PowerShell V4

예제 1: 지난 7일 동안 발생한 모든 이벤트를 반환합니다. 기본적으로 cmdlet은 모든 이벤트를 전달하기 위해 자동으로 여러 번의 직접 호출을 사용하며, 서비스에서 추가 데이터를 사용할 수 없다고 표시되면 종료됩니다.

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 Cmdlet 참조(V4)의 LookupEvents를 참조하세요.

다음 코드 예시는 Get-CTTrail의 사용 방법을 보여 줍니다.

Tools for PowerShell V4

예제 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 Cmdlet 참조(V4)의 DescribeTrails을 참조하세요.

다음 코드 예시는 Get-CTTrailStatus의 사용 방법을 보여 줍니다.

Tools for PowerShell V4

예제 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 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'으로 전송됩니다. 이 예제에서는 스플래팅을 사용하여 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 직접 호출 및 로그 파일 전송 기록을 시작합니다. 이 예제에서는 추적이 현재 쉘 기본값과 동일한 리전에서 생성되었다고 가정합니다.

Start-CTLogging -Name myExampleTrail

예제 2: 현재 쉘 기본값이 아닌 리전(이 경우 프랑크푸르트(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 직접 호출 및 로그 파일 전송 기록을 일시 중지합니다. 이 예제에서는 추적이 현재 쉘 기본값과 동일한 리전에서 생성되었다고 가정합니다.

Stop-CTLogging -Name myExampleTrail

예제 2: 현재 쉘 기본값이 아닌 리전(이 경우 프랑크푸르트(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을 참조하세요.