A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada\$1

Para obter informações sobre mudanças significativas e migrar seus aplicativos, consulte o [tópico de migração](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)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Esta seção mostra um exemplo de como usar as Ferramentas do Windows PowerShell para publicar dados métricos personalizados em CloudWatch.

Este exemplo pressupõe que você definiu credenciais padrão e uma região padrão para sua PowerShell sessão. 

## Publique uma métrica personalizada em seu CloudWatch painel
<a name="pstools-cw-custom-metric-publish"></a>

O PowerShell código a seguir inicializa um CloudWatch `MetricDatum` objeto e o publica no serviço. Você pode ver o resultado dessa operação navegando até o [CloudWatch console](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
```

Observe o seguinte:
+ As informações de data/hora usadas para inicializar `$dat.Timestamp` devem estar no Horário Universal (UTC).
+ O valor usado para inicializar `$dat.Value` pode ser de um valor de string entre aspas ou um valor numérico (sem aspas). O exemplo mostra um valor de string.

## Consulte também
<a name="see-also"></a>
+  [AWS Serviços de chamadas no Ferramentas da AWS para PowerShell](pstools-using.md) 
+  [AmazonCloudWatchClient. PutMetricData](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/CloudWatch/MCloudWatchPutMetricDataPutMetricDataRequest.html)(Referência do SDK.NET)
+  [MetricDatum](https://docs.aws.amazon.com/AmazonCloudWatch/latest/APIReference/API_MetricDatum.html)(Referência da API de serviço)
+  [ CloudWatch Console Amazon](https://console.aws.amazon.com/cloudwatch/home)