第 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 的 CloudWatch 範例
下列程式碼範例示範如何使用 AWS Tools for PowerShell V5 搭配 CloudWatch 來執行動作和實作常見案例。
*Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。
每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。
**Topics**
+ [動作](#actions)
## 動作
### `Get-CWDashboard`
以下程式碼範例顯示如何使用 `Get-CWDashboard`。
**Tools for PowerShell V5**
**範例 1：傳回指定儀表板內文的 arn。**
```
Get-CWDashboard -DashboardName Dashboard1
```
**輸出：**
```
DashboardArn DashboardBody
------------ -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》**中的 [GetDashboard](https://docs.aws.amazon.com/powershell/v5/reference)。
### `Get-CWDashboardList`
以下程式碼範例顯示如何使用 `Get-CWDashboardList`。
**Tools for PowerShell V5**
**範例 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 參考 (V5)》**中的 [ListDashboards](https://docs.aws.amazon.com/powershell/v5/reference)。
### `Remove-CWDashboard`
以下程式碼範例顯示如何使用 `Remove-CWDashboard`。
**Tools for PowerShell V5**
**範例 1：刪除指定儀表板，並在執行前要求確認。若要略過確認，請將 -Force 切換變數新增至命令。**
```
Remove-CWDashboard -DashboardName Dashboard1
```
+ 如需 API 詳細資訊，請參閱《AWS Tools for PowerShell Cmdlet 參考 (V5)》**中的 [DeleteDashboards](https://docs.aws.amazon.com/powershell/v5/reference)。
### `Write-CWDashboard`
以下程式碼範例顯示如何使用 `Write-CWDashboard`。
**Tools for PowerShell V5**
**範例 1：建立或更新名為 '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 參考 (V5)》**中的 [PutDashboard](https://docs.aws.amazon.com/powershell/v5/reference)。
### `Write-CWMetricData`
以下程式碼範例顯示如何使用 `Write-CWMetricData`。
**Tools for PowerShell V5**
**範例 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 參考 (V5)》**中的 [PutMetricData](https://docs.aws.amazon.com/powershell/v5/reference)。