AWS Tools for PowerShell V4 已进入维护模式。

我们建议您迁移到 [AWS Tools for PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/)。有关如何迁移的更多详细信息和信息，请参阅我们的[维护模式公告](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/)。

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

# 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)