

D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# CloudWatch exemples utilisant Tools for PowerShell V4
<a name="powershell_4_cloudwatch_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants en utilisant le Outils AWS pour PowerShell V4 avec CloudWatch.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `Get-CWAlarm`
<a name="cloudwatch_DescribeAlarms_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-CWAlarm`.

**Outils pour PowerShell V4**  
**Exemple 1 : renvoie toutes les alarmes, y compris les alarmes composites et métriques de CloudWatch.**  

```
Get-CWAlarm -MaxRecords 1
```
**Sortie** :  

```
CompositeAlarms MetricAlarms         NextToken
--------------- ------------         ---------
                {MetricAlarms-01}    NextToken-01
                {MetricAlarms-02}    NextToken-02
                {MetricAlarms-03}    NextToken-03
```
**Exemple 2 : renvoie uniquement les données d'alarmes composites CloudWatch après avoir défini le AlarmType paramètre - sur CompositeAlarms.**  

```
Get-CWAlarm -AlarmType 'CompositeAlarms'
```
**Sortie** :  

```
CompositeAlarms        MetricAlarms NextToken
---------------        ------------ ---------
{CompositeAlarms-01}
{CompositeAlarms-02}
{CompositeAlarms-03}
```
+  Pour plus de détails sur l'API, reportez-vous [DescribeAlarms](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-CWDashboard`
<a name="cloudwatch_GetDashboard_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-CWDashboard`.

**Outils pour PowerShell V4**  
**Exemple 1 : renvoie l’ARN dans le corps du tableau de bord spécifié.**  

```
Get-CWDashboard -DashboardName Dashboard1
```
**Sortie** :  

```
DashboardArn                                          DashboardBody
------------                                          -------------
arn:aws:cloudwatch::123456789012:dashboard/Dashboard1 {...
```
+  Pour plus de détails sur l'API, reportez-vous [GetDashboard](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Get-CWDashboardList`
<a name="cloudwatch_ListDashboards_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Get-CWDashboardList`.

**Outils pour PowerShell V4**  
**Exemple 1 : renvoie la collection de tableaux de bord pour votre compte.**  

```
Get-CWDashboardList
```
**Sortie** :  

```
DashboardArn DashboardName LastModified        Size
------------ ------------- ------------        ----
arn:...      Dashboard1    7/6/2017 8:14:15 PM 252
```
**Exemple 2 : renvoie la collection de tableaux de bord de votre compte dont le nom commence par le préfixe « dev’.**  

```
Get-CWDashboardList -DashboardNamePrefix dev
```
+  Pour plus de détails sur l'API, reportez-vous [ListDashboards](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Remove-CWDashboard`
<a name="cloudwatch_DeleteDashboards_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Remove-CWDashboard`.

**Outils pour PowerShell V4**  
**Exemple 1 : supprime le tableau de bord spécifié, en le promouvant pour confirmation avant de continuer. Pour contourner la confirmation, ajoutez le commutateur -Force à la commande.**  

```
Remove-CWDashboard -DashboardName Dashboard1
```
+  Pour plus de détails sur l'API, reportez-vous [DeleteDashboards](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Write-CWDashboard`
<a name="cloudwatch_PutDashboard_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Write-CWDashboard`.

**Outils pour PowerShell V4**  
**Exemple 1 : crée ou met à jour le tableau de bord nommé « Dashboard1 » pour y inclure deux widgets de métriques placés côte à côte.**  

```
$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
```
**Exemple 2 : crée ou met à jour le tableau de bord en transmettant son contenu descriptif à l’applet de commande.**  

```
$dashBody = @"
{
...
}
"@
        
$dashBody | Write-CWDashboard -DashboardName Dashboard1
```
+  Pour plus de détails sur l'API, reportez-vous [PutDashboard](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 

### `Write-CWMetricData`
<a name="cloudwatch_PutMetricData_powershell_4_topic"></a>

L'exemple de code suivant montre comment utiliser`Write-CWMetricData`.

**Outils pour PowerShell V4**  
**Exemple 1 : crée un nouvel MetricDatum objet et l'écrit dans 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
```
+  Pour plus de détails sur l'API, reportez-vous [PutMetricData](https://docs.aws.amazon.com/powershell/v4/reference)à la section *Référence des Outils AWS pour PowerShell applets de commande (V4)*. 