Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# CloudWatch ejemplos de uso de Tools for V4 PowerShell
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso de la Herramientas de AWS para PowerShell V4 con CloudWatch.
Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
**Topics**
+ [Acciones](#actions)
## Acciones
### `Get-CWAlarm`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CWAlarm`.
**Herramientas para la PowerShell V4**
**Ejemplo 1: Devuelve todas las alarmas, incluidas las alarmas compuestas y métricas, de CloudWatch.**
```
Get-CWAlarm -MaxRecords 1
```
**Salida:**
```
CompositeAlarms MetricAlarms NextToken
--------------- ------------ ---------
{MetricAlarms-01} NextToken-01
{MetricAlarms-02} NextToken-02
{MetricAlarms-03} NextToken-03
```
**Ejemplo 2: devuelve solo los datos de las alarmas compuestas de una CloudWatch vez configuradas: del AlarmType parámetro a CompositeAlarms.**
```
Get-CWAlarm -AlarmType 'CompositeAlarms'
```
**Salida:**
```
CompositeAlarms MetricAlarms NextToken
--------------- ------------ ---------
{CompositeAlarms-01}
{CompositeAlarms-02}
{CompositeAlarms-03}
```
+ Para obtener más información sobre la API, consulte [DescribeAlarms Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Get-CWDashboard`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CWDashboard`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: devuelve el arn al cuerpo del panel especificado.**
```
Get-CWDashboard -DashboardName Dashboard1
```
**Salida:**
```
DashboardArn DashboardBody
------------ -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...
```
+ Para obtener más información sobre la API, consulte [GetDashboard Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Get-CWDashboardList`
En el siguiente ejemplo de código, se muestra cómo utilizar `Get-CWDashboardList`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: devuelve el conjunto de paneles de su cuenta.**
```
Get-CWDashboardList
```
**Salida:**
```
DashboardArn DashboardName LastModified Size
------------ ------------- ------------ ----
arn:... Dashboard1 7/6/2017 8:14:15 PM 252
```
**Ejemplo 2: devuelve el conjunto de paneles de su cuenta cuyos nombres comienzan con el prefijo “dev”.**
```
Get-CWDashboardList -DashboardNamePrefix dev
```
+ Para obtener más información sobre la API, consulte [ListDashboards Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Remove-CWDashboard`
En el siguiente ejemplo de código, se muestra cómo utilizar `Remove-CWDashboard`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: elimina el panel especificado y lo confirma antes de continuar. Para omitir la confirmación, agregue el modificador -Force al comando.**
```
Remove-CWDashboard -DashboardName Dashboard1
```
+ Para obtener más información sobre la API, consulte [DeleteDashboards Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Write-CWDashboard`
En el siguiente ejemplo de código, se muestra cómo utilizar `Write-CWDashboard`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: crea o actualiza el panel denominado “Dashboard1” para incluir dos widgets de métricas uno al lado del otro.**
```
$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
```
**Ejemplo 2: crea o actualiza el panel y canaliza el contenido que describe el panel al cmdlet.**
```
$dashBody = @"
{
...
}
"@
$dashBody | Write-CWDashboard -DashboardName Dashboard1
```
+ Para obtener más información sobre la API, consulte [PutDashboard Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/v4/reference)*Cmdlet Reference (V4)*.
### `Write-CWMetricData`
En el siguiente ejemplo de código, se muestra cómo utilizar `Write-CWMetricData`.
**Herramientas para la versión 4 PowerShell **
**Ejemplo 1: crea un MetricDatum objeto nuevo y lo escribe en Amazon Web Services CloudWatch Metrics.**
```
### 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
```
+ Para obtener más información sobre la API, consulte [PutMetricData](https://docs.aws.amazon.com/powershell/v4/reference)la *referencia de Herramientas de AWS para PowerShell cmdlets (V4)*.