Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Tools for PowerShell V4를 사용한 CloudWatch 예제
다음 코드 예제에서는 CloudWatch와 함께 AWS Tools for PowerShell V4를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접적으로 호출하는 방법을 보여주며 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
## 작업
### `Get-CWAlarm`
다음 코드 예시는 `Get-CWAlarm`의 사용 방법을 보여줍니다.
**Tools for PowerShell V4**
**예제 1: CloudWatch에서 복합 및 지표 경보를 포함한 모든 경보를 반환합니다.**
```
Get-CWAlarm -MaxRecords 1
```
**출력:**
```
CompositeAlarms MetricAlarms NextToken
--------------- ------------ ---------
{MetricAlarms-01} NextToken-01
{MetricAlarms-02} NextToken-02
{MetricAlarms-03} NextToken-03
```
**예제 2: -AlarmType 파라미터를 CompositeAlarms로 설정한 후 CloudWatch에서 복합 경보 데이터만 반환합니다.**
```
Get-CWAlarm -AlarmType 'CompositeAlarms'
```
**출력:**
```
CompositeAlarms MetricAlarms NextToken
--------------- ------------ ---------
{CompositeAlarms-01}
{CompositeAlarms-02}
{CompositeAlarms-03}
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V4)*의 [DescribeAlarms](https://docs.aws.amazon.com/powershell/v4/reference)를 참조하세요.
### `Get-CWDashboard`
다음 코드 예시는 `Get-CWDashboard`의 사용 방법을 보여줍니다.
**Tools for PowerShell V4**
**예시 1: 지정된 대시보드의 arn 본문을 반환합니다.**
```
Get-CWDashboard -DashboardName Dashboard1
```
**출력:**
```
DashboardArn DashboardBody
------------ -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V4)*의 [GetDashboard](https://docs.aws.amazon.com/powershell/v4/reference)를 참조하세요.
### `Get-CWDashboardList`
다음 코드 예시는 `Get-CWDashboardList`의 사용 방법을 보여줍니다.
**Tools for PowerShell V4**
**예시 1: 계정의 대시보드 컬렉션을 반환합니다.**
```
Get-CWDashboardList
```
**출력:**
```
DashboardArn DashboardName LastModified Size
------------ ------------- ------------ ----
arn:... Dashboard1 7/6/2017 8:14:15 PM 252
```
**예시 2: 이름이 접두사 'dev'로 시작하는 계정의 대시보드 컬렉션을 반환합니다.**
```
Get-CWDashboardList -DashboardNamePrefix dev
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V4)*의 [ListDashboards](https://docs.aws.amazon.com/powershell/v4/reference)를 참조하세요.
### `Remove-CWDashboard`
다음 코드 예시는 `Remove-CWDashboard`의 사용 방법을 보여줍니다.
**Tools for PowerShell V4**
**예시 1: 지정된 대시보드를 삭제하고 계속하기 전에 확인을 위해 승격합니다. 확인을 우회하려면 명령에 -Force 스위치를 추가합니다.**
```
Remove-CWDashboard -DashboardName Dashboard1
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V4)*의 [DeleteDashboards](https://docs.aws.amazon.com/powershell/v4/reference)를 참조하세요.
### `Write-CWDashboard`
다음 코드 예시는 `Write-CWDashboard`의 사용 방법을 보여줍니다.
**Tools for PowerShell V4**
**예시 1: 지표 위젯 2개를 나란히 포함하도록 'Dashboard1'이라는 대시보드를 생성하거나 업데이트합니다.**
```
$dashBody = @"
{
"widgets":[
{
"type":"metric",
"x":0,
"y":0,
"width":12,
"height":6,
"properties":{
"metrics":[
[
"AWS/EC2",
"CPUUtilization",
"InstanceId",
"i-012345"
]
],
"period":300,
"stat":"Average",
"region":"us-east-1",
"title":"EC2 Instance CPU"
}
},
{
"type":"metric",
"x":12,
"y":0,
"width":12,
"height":6,
"properties":{
"metrics":[
[
"AWS/S3",
"BucketSizeBytes",
"BucketName",
"amzn-s3-demo-bucket"
]
],
"period":86400,
"stat":"Maximum",
"region":"us-east-1",
"title":"amzn-s3-demo-bucket bytes"
}
}
]
}
"@
Write-CWDashboard -DashboardName Dashboard1 -DashboardBody $dashBody
```
**예시 2: 대시보드를 생성하거나 업데이트하여 대시보드를 설명하는 콘텐츠를 cmdlet에 전달합니다.**
```
$dashBody = @"
{
...
}
"@
$dashBody | Write-CWDashboard -DashboardName Dashboard1
```
+ API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V4)*의 [PutDashboard](https://docs.aws.amazon.com/powershell/v4/reference)를 참조하세요.
### `Write-CWMetricData`
다음 코드 예시는 `Write-CWMetricData`의 사용 방법을 보여줍니다.
**Tools for PowerShell V4**
**예시 1: 새 MetricDatum 객체를 생성하고, Amazon Web Services CloudWatch 지표에 씁니다.**
```
### Create a MetricDatum .NET object
$Metric = New-Object -TypeName Amazon.CloudWatch.Model.MetricDatum
$Metric.Timestamp = [DateTime]::UtcNow
$Metric.MetricName = 'CPU'
$Metric.Value = 50
### Write the metric data to the CloudWatch service
Write-CWMetricData -Namespace instance1 -MetricData $Metric
```
+ API 세부 정보는 **AWS Tools for PowerShell Cmdlet 참조(V4)의 [PutMetricData](https://docs.aws.amazon.com/powershell/v4/reference)를 참조하세요.