

的版本 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)

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# CloudWatch 来自 AWS Tools for Windows PowerShell
<a name="pstools-cw"></a>

本节演示如何使用适用于 Windows 的工具将自定义指标数据发布 PowerShell 到的示例 CloudWatch。

此示例假设您已为 PowerShell会话设置了默认凭证和默认区域。

## 将自定义指标发布到您的 CloudWatch 控制面板
<a name="pstools-cw-custom-metric-publish"></a>

以下 PowerShell 代码初始化 CloudWatch `MetricDatum`对象并将其发布到服务。您可以通过导航到[CloudWatch 控制台](https://console.aws.amazon.com/cloudwatch/home)来查看此操作的结果。

```
$dat = New-Object Amazon.CloudWatch.Model.MetricDatum
$dat.Timestamp = (Get-Date).ToUniversalTime()
$dat.MetricName = "New Posts"
$dat.Unit = "Count"
$dat.Value = ".50"
Write-CWMetricData -Namespace "Usage Metrics" -MetricData $dat
```

注意以下几点：
+ 用于初始化 `$dat.Timestamp` 的日期时间信息必须用世界时 (UTC) 表示。
+ 用于初始化 `$dat.Value` 的值可以是括在引号中的字符串值或数字值（无引号）。该示例显示了一个字符串值。

## 另请参阅
<a name="see-also"></a>
+  [在中呼叫 AWS 服务 AWS Tools for PowerShell](pstools-using.md) 
+  [AmazonCloudWatchClient。 PutMetricData](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudWatch/MCloudWatchPutMetricDataPutMetricDataRequest.html)（.NET 开发工具包参考）
+  [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html)（服务 API 参考）
+  [亚马逊 CloudWatch 控制台](https://console.aws.amazon.com/cloudwatch/home) 