Amazon Tools for PowerShell V4 的支持已到期。
我们建议您迁移到 Amazon Tools for PowerShell V5 。有关如何迁移的更多详细信息和信息，请参阅我们的终止支持公告
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CloudWatch 使用适用于 PowerShell V4 的工具的示例
以下代码示例向您展示了如何使用带 CloudWatch的 Amazon Tools for PowerShell V4 来执行操作和实现常见场景。
操作是大型程序的代码摘录，必须在上下文中运行。您可以通过操作了解如何调用单个服务函数，还可以通过函数相关场景的上下文查看操作。
每个示例都包含一个指向完整源代码的链接，您可以从中找到有关如何在上下文中设置和运行代码的说明。
主题
操作
以下代码示例演示了如何使用 Get-CWAlarm。
- 适用于 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 参数设置为 CloudWatch 后的复合警报数据 CompositeAlarms。
Get-CWAlarm -AlarmType 'CompositeAlarms'输出：
CompositeAlarms MetricAlarms NextToken --------------- ------------ --------- {CompositeAlarms-01} {CompositeAlarms-02} {CompositeAlarms-03}-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DescribeAlarms中的。
-
以下代码示例演示了如何使用 Get-CWDashboard。
- 适用于 PowerShell V4 的工具
-
示例 1：返回指定控制面板的正文 arn。
Get-CWDashboard -DashboardName Dashboard1输出：
DashboardArn DashboardBody ------------ ------------- arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) GetDashboard中的。
-
以下代码示例演示了如何使用 Get-CWDashboardList。
- 适用于 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 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) ListDashboards中的。
-
以下代码示例演示了如何使用 Remove-CWDashboard。
- 适用于 PowerShell V4 的工具
-
示例 1：删除指定的控制面板，继续操作前提示确认。要绕过确认，请在命令中添加 -Force 开关。
Remove-CWDashboard -DashboardName Dashboard1-
有关 API 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) DeleteDashboards中的。
-
以下代码示例演示了如何使用 Write-CWDashboard。
- 适用于 PowerShell V4 的工具
-
示例 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 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) PutDashboard中的。
-
以下代码示例演示了如何使用 Write-CWMetricData。
- 适用于 PowerShell V4 的工具
-
示例 1：创建新 MetricDatum 对象并将其写入 Amazon Web Serv CloudWatch ices 指标。
### 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 的详细信息，请参阅 Amazon Tools for PowerShell Cmdlet 参考 (V 4) PutMetricData中的。
-