Ferramentas da AWS para PowerShell O V4 entrou no modo de manutenção.

Recomendamos que você migre para a [Ferramentas da AWS para PowerShell V5](https://docs.aws.amazon.com/powershell/v5/userguide/). Para obter detalhes e informações adicionais sobre como migrar, consulte nosso [anúncio do modo de manutenção](https://aws.amazon.com/blogs/developer/aws-tools-for-powershell-v4-maintenance-mode-announcement/).

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>
+  [Trabalhe com AWS serviços 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)