

• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Utilizzo di `RegisterTargetWithMaintenanceWindow` con una CLI
<a name="example_ssm_RegisterTargetWithMaintenanceWindow_section"></a>

Gli esempi di codice seguenti mostrano come utilizzare `RegisterTargetWithMaintenanceWindow`.

------
#### [ CLI ]

**AWS CLI**  
**Esempio 1: per registrare una singola destinazione con una finestra di manutenzione**  
L’esempio seguente `register-target-with-maintenance-window` registra un’istanza con una finestra di manutenzione.  

```
aws ssm register-target-with-maintenance-window \
    --window-id {{"mw-ab12cd34ef56gh78"}} \
    --target {{"Key=InstanceIds,Values=i-0000293ffd8c57862"}} \
    --owner-information {{"Single instance"}} \
    --resource-type {{"INSTANCE"}}
```
Output:  

```
{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}
```
**Esempio 2: come registrare più destinazioni con una finestra di manutenzione utilizzando gli ID di istanza**  
L’esempio seguente `register-target-with-maintenance-window` registra due istanze con una finestra di manutenzione specificandone gli ID di istanza.  

```
aws ssm register-target-with-maintenance-window \
    --window-id {{"mw-ab12cd34ef56gh78"}} \
    --target {{"Key=InstanceIds,Values=i-0000293ffd8c57862,i-0cb2b964d3e14fd9f"}} \
    --owner-information {{"Two instances in a list"}} \
    --resource-type {{"INSTANCE"}}
```
Output:  

```
{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}
```
**Esempio 3: come registrare le destinazioni in una finestra di manutenzione utilizzando i tag delle risorse**  
L’esempio seguente `register-target-with-maintenance-window` registra le istanze con una finestra di manutenzione specificando i tag di risorsa che sono stati applicati alle istanze.  

```
aws ssm register-target-with-maintenance-window \
    --window-id {{"mw-06cf17cbefcb4bf4f"}} \
    --targets {{"Key=tag:Environment,Values=Prod"}} {{"Key=Role,Values=Web"}} \
    --owner-information {{"Production Web Servers"}} \
    --resource-type {{"INSTANCE"}}
```
Output:  

```
{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}
```
**Esempio 4: come registrare le destinazioni utilizzando un gruppo di chiavi dei tag**  
L’esempio seguente `register-target-with-maintenance-window` registra tutte le istanze che hanno una o più chiavi dei tag assegnate, indipendentemente dai valori delle chiavi.  

```
aws ssm register-target-with-maintenance-window \
    --window-id {{"mw-0c50858d01EXAMPLE"}} \
    --resource-type {{"INSTANCE"}} \
    --target {{"Key=tag-key,Values=Name,Instance-Type,CostCenter"}}
```
Output:  

```
{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}
```
**Esempio 5: come registrare le destinazioni utilizzando un nome del gruppo di risorse**  
L’esempio seguente `register-target-with-maintenance-window` registra un gruppo di risorse specificato, indipendentemente dal tipo di risorse che contiene.  

```
aws ssm register-target-with-maintenance-window \
    --window-id {{"mw-0c50858d01EXAMPLE"}} \
    --resource-type {{"RESOURCE_GROUP"}} \
    --target {{"Key=resource-groups:Name,Values=MyResourceGroup"}}
```
Output:  

```
{
    "WindowTargetId":"1a2b3c4d-1a2b-1a2b-1a2b-1a2b3c4d-1a2"
}
```
Per ulteriori informazioni, vedere [Registrare un'istanza di destinazione con la finestra di manutenzione (AWS CLI)](https://docs.aws.amazon.com/systems-manager/latest/userguide/mw-cli-tutorial-targets.html) nella *AWS Systems Manager User* Guide.  
+  Per i dettagli sull'API, consulta [RegisterTargetWithMaintenanceWindow AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/register-target-with-maintenance-window.html)*Command Reference.* 

------
#### [ PowerShell ]

**Strumenti per PowerShell V4**  
**Esempio 1: questo esempio registra un’istanza con una finestra di manutenzione.**  

```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Output:**  

```
d8e47760-23ed-46a5-9f28-927337725398
```
**Esempio 2: questo esempio registra più istanze con una finestra di manutenzione.**  

```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Output:**  

```
6ab5c208-9fc4-4697-84b7-b02a6cc25f7d
```
**Esempio 3: questo esempio registra un’istanza con una finestra di manutenzione utilizzando i tag EC2.**  

```
$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"
```
**Output:**  

```
2994977e-aefb-4a71-beac-df620352f184
```
+  Per i dettagli sull'API, vedere [RegisterTargetWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v4/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V4). 

**Strumenti per V5 PowerShell **  
**Esempio 1: questo esempio registra un’istanza con una finestra di manutenzione.**  

```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Output:**  

```
d8e47760-23ed-46a5-9f28-927337725398
```
**Esempio 2: questo esempio registra più istanze con una finestra di manutenzione.**  

```
$option1 = @{Key="InstanceIds";Values=@("i-0000293ffd8c57862","i-0cb2b964d3e14fd9f")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Single instance" -ResourceType "INSTANCE"
```
**Output:**  

```
6ab5c208-9fc4-4697-84b7-b02a6cc25f7d
```
**Esempio 3: questo esempio registra un’istanza con una finestra di manutenzione utilizzando i tag EC2.**  

```
$option1 = @{Key="tag:Environment";Values=@("Production")}
Register-SSMTargetWithMaintenanceWindow -WindowId "mw-06cf17cbefcb4bf4f" -Target $option1 -OwnerInformation "Production Web Servers" -ResourceType "INSTANCE"
```
**Output:**  

```
2994977e-aefb-4a71-beac-df620352f184
```
+  Per i dettagli sull'API, vedere [RegisterTargetWithMaintenanceWindow](https://docs.aws.amazon.com/powershell/v5/reference)in *AWS Strumenti per PowerShell Cmdlet Reference (*V5). 

------

Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, vedere. [Utilizzo di questo servizio con un AWS SDK](sdk-general-information-section.md) Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell’SDK.