

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à.

# Procedura dettagliata: aggiorna SSM Agent automaticamente con AWS CLI

La procedura seguente ti guiderà attraverso il processo di creazione di un'associazione di State Manager utilizzando AWS Command Line Interface. L'associazione aggiorna automaticamente l'SSM Agent in base a una pianificazione da te specificata. Per ulteriori informazioni su SSM Agent, consultare [Lavorare con Agente SSM](ssm-agent.md). Per personalizzare la pianificazione degli aggiornamenti per SSM Agent tramite la console, consulta [Aggiornamento automatico Agente SSM](ssm-agent-automatic-updates.md#ssm-agent-automatic-updates-console).

Per ricevere notifiche sugli aggiornamenti dell'SSM Agent, iscriviti alla pagina [Note di rilascio dell'SSM Agent](https://github.com/aws/amazon-ssm-agent/blob/master/RELEASENOTES.md) su GitHub.

**Prima di iniziare**  
Prima di completare la procedura seguente, verificare di disporre di almeno un'istanza Amazon Elastic Compute Cloud (Amazon EC2) in esecuzione per Linux, macOS o Windows Server configurata per Systems Manager. Per ulteriori informazioni, consulta [Configurazione dei nodi gestiti per AWS Systems Manager](systems-manager-setting-up-nodes.md). 

Se create un'associazione utilizzando AWS CLI o AWS Tools for Windows PowerShell, utilizzate il `--Targets` parametro per indirizzare le istanze, come illustrato nell'esempio seguente. Non utilizzare il parametro `--InstanceID`. Il parametro `--InstanceID` è un parametro legacy.

**Per creare un'associazione per aggiornare automaticamente l'SSM Agent**

1. Installa e configura AWS Command Line Interface (AWS CLI), se non l'hai già fatto.

   Per informazioni, consulta la pagina [Installazione o aggiornamento della versione più recente di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).

1. Esegui il comando seguente per creare un'associazione scegliendo come destinazione le istanze tramite i tag Amazon Elastic Compute Cloud (Amazon EC2). Sostituisci ogni {{example resource placeholder}} con le tue informazioni. Il parametro `Schedule` imposta una pianificazione per eseguire l'associazione ogni domenica mattina alle 2:00 (UTC).

   Le associazioni di State Manager non supportano tutte le espressioni Cron e della frequenza. Per ulteriori informazioni sulla creazione di espressioni Cron e della frequenza per le associazioni, consulta [Riferimento: espressioni Cron e della frequenza per Systems Manager](reference-cron-and-rate-expressions.md).

------
#### [ Linux & macOS ]

   ```bash
   aws ssm create-association \
   --targets Key=tag:{{tag_key}},Values={{tag_value}} \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)"
   ```

------
#### [ Windows ]

   ```bash
   aws ssm create-association ^
   --targets Key=tag:{{tag_key}},Values={{tag_value}} ^
   --name AWS-UpdateSSMAgent ^
   --schedule-expression "cron(0 2 ? * SUN *)"
   ```

------

   È inoltre possibile definire come target più istanze specificando gli ID delle istanze in un elenco separato da virgole.

------
#### [ Linux & macOS ]

   ```bash
   aws ssm create-association \
   --targets Key=instanceids,Values={{instance_ID,instance_ID,instance_ID}} \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)"
   ```

------
#### [ Windows ]

   ```bash
   aws ssm create-association ^
   --targets Key=instanceids,Values={{instance_ID,instance_ID,instance_ID}} ^
   --name AWS-UpdateSSMAgent ^
   --schedule-expression "cron(0 2 ? * SUN *)"
   ```

------

   È possibile specificare la versione dell'SSM Agent a cui desideri aggiornare.

------
#### [ Linux & macOS ]

   ```bash
   aws ssm create-association \
   --targets Key=instanceids,Values={{instance_ID,instance_ID,instance_ID}} \
   --name AWS-UpdateSSMAgent \
   --schedule-expression "cron(0 2 ? * SUN *)" \
   --parameters version={{ssm_agent_version_number}}
   ```

------
#### [ Windows ]

   ```bash
   aws ssm create-association ^
   --targets Key=instanceids,Values={{instance_ID,instance_ID,instance_ID}} ^
   --name AWS-UpdateSSMAgent ^
   --schedule-expression "cron(0 2 ? * SUN *)" ^
   --parameters version={{ssm_agent_version_number}}
   ```

------

   Il sistema restituisce informazioni simili alle seguenti.

   ```
   {
       "AssociationDescription": {
           "ScheduleExpression": "cron(0 2 ? * SUN *)",
           "Name": "AWS-UpdateSSMAgent",
           "Overview": {
               "Status": "Pending",
               "DetailedStatus": "Creating"
           },
           "AssociationId": "123..............",
           "DocumentVersion": "$DEFAULT",
           "LastUpdateAssociationDate": 1504034257.98,
           "Date": 1504034257.98,
           "AssociationVersion": "1",
           "Targets": [
               {
                   "Values": [
                       "{{TagValue}}"
                   ],
                   "Key": "tag:{{TagKey}}"
               }
           ]
       }
   }
   ```

   Il sistema tenta di creare l'associazione sulla/e istanza/e e applica lo stato dopo la creazione. L'associazione presenta lo stato `Pending`.

1. Eseguire il comando seguente per visualizzare uno stato aggiornato dell'associazione creata. 

   ```
   aws ssm list-associations
   ```

   Se le istanze *non* stanno eseguendo attualmente la versione più recente dell'SSM Agent, lo stato mostra `Failed`. Quando viene pubblicata una nuova versione dell'SSM Agent, l'associazione installa automaticamente il nuovo agente e lo stato mostra `Success`.