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

# Documentazione di riferimento del plugin per i documenti di comando
<a name="documents-command-ssm-plugin-reference"></a>

Questo riferimento descrive i plugin che è possibile specificare in un documento di tipo Command AWS Systems Manager (SSM). Questi plugin non possono essere utilizzati nei runbook Automation SSM che usano operazioni di Automation. Per informazioni sulle azioni di AWS Systems Manager automazione, vedere. [Riferimento alle operazioni del servizio di automazione di Systems Manager](automation-actions.md)

Systems Manager determina le operazioni da eseguire su un'istanza gestita mediante la lettura dei contenuti di un documento SSM. Ogni documento include una sezione di esecuzione di codice. A seconda della versione dello schema del documento, questa sezione di esecuzione di codice può includere uno o più plugin o fasi. Ai fini di questo argomento della Guida, i plugin e le fasi sono chiamati *plugin*. Questa sezione include informazioni su ciascun plugin di Systems Manager. Per ulteriori informazioni sui documenti, incluse informazioni sulla creazione di documenti e sulle differenze tra le versioni dello schema, consulta [Documenti di AWS Systems Manager](documents.md).

Per i plugin che accettano parametri String, come `aws:runShellScript` e `aws:runPowerShellScript`, il parametro `interpolationType` è utilizzabile per migliorare la sicurezza trattando gli input dei parametri come stringhe letterali, invece di comandi potenzialmente eseguibili. Esempio:

```
{
    "schemaVersion": "2.2",
    "description": "runShellScript with command strings stored as Parameter Store parameter",
    "parameters": {
      "commands": {
        "type": "StringList",
        "description": "(Required) The commands to run on the instance.",
        "default": ["{{ ssm:myShellCommands }}"],
        "interpolationType" : "ENV_VAR"
      }
    },
    //truncated
 }
```

**Nota**  
Alcuni dei plugin illustrati in questa sezione possono essere eseguiti soltanto su istanze Windows Server o Linux. Sono riportate le dipendenze della piattaforma per ogni plugin.   
I seguenti plugin di documenti sono supportati nelle istanze di Amazon Elastic Compute Cloud (Amazon EC2) per macOS:  
`aws:refreshAssociation`
`aws:runShellScript`
`aws:runPowerShellScript`
`aws:softwareInventory`
`aws:updateSsmAgent`

**Topics**
+ [Input condivisi](#shared-inputs)
+ [`aws:applications`](#aws-applications)
+ [`aws:cloudWatch`](#aws-cloudWatch)
+ [`aws:configureDocker`](#aws-configuredocker)
+ [`aws:configurePackage`](#aws-configurepackage)
+ [`aws:domainJoin`](#aws-domainJoin)
+ [`aws:downloadContent`](#aws-downloadContent)
+ [`aws:psModule`](#aws-psModule)
+ [`aws:refreshAssociation`](#aws-refreshassociation)
+ [`aws:runDockerAction`](#aws-rundockeraction)
+ [`aws:runDocument`](#aws-rundocument)
+ [`aws:runPowerShellScript`](#aws-runPowerShellScript)
+ [`aws:runShellScript`](#aws-runShellScript)
+ [`aws:softwareInventory`](#aws-softwareinventory)
+ [`aws:updateAgent`](#aws-updateagent)
+ [`aws:updateSsmAgent`](#aws-updatessmagent)

## Input condivisi
<a name="shared-inputs"></a>

Solo con la versione 3.0.502 e successive di SSM Agent tutti i plugin possono utilizzare i seguenti input:

**finallyStep**  
L'ultimo passaggio è l'esecuzione del documento. Se questo input è definito per un passaggio, ha la precedenza su un valore `exit` specificato negli input `onFailure` o `onSuccess`. Affinché un passaggio con questo input sia eseguito come previsto, il passaggio deve essere l'ultimo definito nel `mainSteps` del documento.  
Tipo: Booleano  
Valori validi: `true` \| `false`  
Obbligatorio: no

**onFailure**  
Se si specifica questo input per un plugin con il valore `exit` e il passaggio non riesce, lo stato del passaggio riflette l'errore e il documento non esegue i passaggi rimanenti a meno che non sia stato definito un `finallyStep`. Se si specifica questo input per un plugin con il valore `successAndExit` e il passaggio non riesce, lo stato del passaggio riflette l'errore e il documento non esegue i passaggi rimanenti a meno che non sia stato definito un `finallyStep`.  
Tipo: String  
Valori validi: `exit` \| `successAndExit`  
Obbligatorio: no

**onSuccess**  
Se si specifica questo input per un plugin e il passaggio viene eseguito correttamente, il documento non esegue i passaggi rimanenti a meno che non sia stato definito un `finallyStep`.  
Tipo: String  
Valori validi: `exit`  
Campo obbligatorio: no

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: Shared inputs example
parameters:
  customDocumentParameter:
    type: String
    description: Example parameter for a custom Command-type document.
mainSteps:
- action: aws:runDocument
  name: runCustomConfiguration
  inputs:
    documentType: SSMDocument
    documentPath: "{{yourCustomDocument}}"
    documentParameters: '"documentParameter":{{customDocumentParameter}}'
    onSuccess: exit
- action: aws:runDocument
  name: ifConfigurationFailure
  inputs:
    documentType: SSMDocument
    documentPath: "{{yourCustomRepairDocument}}"
    onFailure: exit
- action: aws:runDocument
  name: finalConfiguration
  inputs:
    documentType: SSMDocument
    documentPath: "{{yourCustomFinalDocument}}"
    finallyStep: true
```

------
#### [ JSON ]

```
{
   "schemaVersion": "2.2",
   "description": "Shared inputs example",
   "parameters": {
      "customDocumentParameter": {
         "type": "String",
         "description": "Example parameter for a custom Command-type document."
      }
   },
   "mainSteps":[
      {
         "action": "aws:runDocument",
         "name": "runCustomConfiguration",
         "inputs": {
            "documentType": "SSMDocument",
            "documentPath": "{{yourCustomDocument}}",
            "documentParameters": "\"documentParameter\":{{customDocumentParameter}}",
            "onSuccess": "exit"
         }
      },
      {
         "action": "aws:runDocument",
         "name": "ifConfigurationFailure",
         "inputs": {
            "documentType": "SSMDocument",
            "documentPath": "{{yourCustomRepairDocument}}",
            "onFailure": "exit"
         }
      },
      {
         "action": "aws:runDocument",
         "name":"finalConfiguration",
         "inputs": {
            "documentType": "SSMDocument",
            "documentPath": "{{yourCustomFinalDocument}}",
            "finallyStep": true
         }
      }
   ]
}
```

------

## `aws:applications`
<a name="aws-applications"></a>

Installa, ripara o disinstalla applicazioni su un'istanza EC2. Questo plugin può essere eseguito solo su sistemi operativi Windows Server.

### Sintassi
<a name="applications-syntax"></a>

#### Schema 2.2
<a name="applications-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:applications plugin
parameters:
  source:
    description: "(Required) Source of msi."
    type: String
mainSteps:
- action: aws:applications
  name: example
  inputs:
    action: Install
    source: "{{ source }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion":"2.2",
  "description":"aws:applications",
  "parameters":{
    "source":{
    "description":"(Required) Source of msi.",
    "type":"String"
    }
  },
  "mainSteps":[
    {
      "action":"aws:applications",
      "name":"example",
      "inputs":{
        "action":"Install",
        "source":"{{ source }}"
      }
    }
  ]
}
```

------

#### Schema 1.2
<a name="applications-syntax-1.2"></a>

------
#### [ YAML ]

```
---
runtimeConfig:
  aws:applications:
    properties:
    - id: 0.aws:applications
      action: "{{ action }}"
      parameters: "{{ parameters }}"
      source: "{{ source }}"
      sourceHash: "{{ sourceHash }}"
```

------
#### [ JSON ]

```
{
   "runtimeConfig":{
      "aws:applications":{
         "properties":[
            {
               "id":"0.aws:applications",
               "action":"{{ action }}",
               "parameters":"{{ parameters }}",
               "source":"{{ source }}",
               "sourceHash":"{{ sourceHash }}"
            }
         ]
      }
   }
}
```

------

### Properties
<a name="applications-properties"></a>

**operazione**  
L'operazione da eseguire.  
Tipo: Enum  
Valori validi: `Install` \| `Repair` \| `Uninstall`  
Obbligatorio: sì

**parametri**  
I parametri per il programma di installazione.  
Tipo: stringa  
Obbligatorio: no

**origine**  
L'URL del file `.msi` per l'applicazione.  
Tipo: stringa  
Obbligatorio: sì

**sourceHash**  
L'hash SHA256 del file `.msi`.  
▬Tipo: stringa  
Obbligatorio: no

## `aws:cloudWatch`
<a name="aws-cloudWatch"></a>

Esporta i dati Windows Server da Amazon CloudWatch o Amazon CloudWatch Logs e monitora i dati utilizzando le CloudWatch metriche. Questo plugin può essere eseguito solo su sistemi operativi Windows Server. *Per ulteriori informazioni sulla configurazione CloudWatch dell'integrazione con Amazon Elastic Compute Cloud (Amazon EC2)[, consulta Collecting metrics, logs and trace with CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) the agent nella Amazon User Guide. CloudWatch *

**Importante**  
L' CloudWatch agente unificato è stato sostituito SSM Agent come strumento per l'invio dei dati di log ad Amazon CloudWatch Logs. Il plugin aws:cloudWatch SSM Agent non è supportato. Ti consigliamo di utilizzare solo l' CloudWatch agente unificato per i processi di raccolta dei log. Per ulteriori informazioni, consulta i seguenti argomenti:  
[Invio dei log dei nodi a CloudWatch registri unificati (agente) CloudWatch](monitoring-cloudwatch-agent.md)
[Esegui la migrazione della raccolta di log dei nodi di Windows Server all'agente CloudWatch](monitoring-cloudwatch-agent.md#monitoring-cloudwatch-agent-migrate)
[Raccolta di metriche, log e tracce con l' CloudWatch agente](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) nella *Amazon CloudWatch User* Guide.

Puoi esportare e monitorare i seguenti tipi di dati:

**ApplicationEventLog**  
Invia i dati del registro degli eventi dell'applicazione a CloudWatch Logs.

**CustomLogs**  
Invia qualsiasi file di registro basato su testo ad Amazon CloudWatch Logs. Il CloudWatch plugin crea un'impronta digitale per i file di registro. Quindi, il sistema associa un offset dei dati con ciascun ID digitale. Il plugin carica i file quando sono presenti modifiche, registra l'offset e lo associa a un ID digitale. Questo metodo viene utilizzato per evitare una situazione in cui un utente attiva il plugin, associa il servizio a una directory che contiene un numero elevato di file e il sistema carica tutti i file.  
Se l'applicazione tronca o tenta di eliminare i log durante il polling, qualsiasi log specificato per `LogDirectoryPath` può perdere voci. Se, ad esempio, desideri limitare le dimensioni del file di log, devi creare un nuovo file di log quando viene raggiunto il limite, quindi devi continuare a scrivere i dati sul nuovo file.

**ETW**  
Invia i dati di Event Tracing for Windows (ETW) ai registri. CloudWatch 

**IIS**  
Invia i dati di registro IIS ai registri. CloudWatch 

**PerformanceCounter**  
Invia i contatori delle prestazioni di Windows a. CloudWatch Puoi selezionare diverse categorie in cui caricare i dati CloudWatch come metriche. Per ogni contatore delle prestazioni che desideri caricare, crea una **PerformanceCounter**sezione con un ID univoco (ad esempio, "PerformanceCounter2"," PerformanceCounter 3" e così via) e configurane le proprietà.  
Se il plug-in AWS Systems Manager SSM Agent o il CloudWatch plug-in sono interrotti, i dati del contatore delle prestazioni non vengono registrati. CloudWatch Questo comportamento è diverso rispetto ai log personalizzati o ai log di eventi di Windows. I registri personalizzati e i registri degli eventi di Windows conservano i dati del contatore delle prestazioni e li caricano su after, CloudWatch SSM Agent altrimenti il CloudWatch plug-in sarà disponibile.

**SecurityEventLog**  
Invia i dati del registro degli eventi di sicurezza ai CloudWatch registri.

**SystemEventLog**  
Invia i dati del registro degli eventi di sistema ai CloudWatch registri.

Puoi definire le seguenti destinazioni per i dati:

**CloudWatch**  
La destinazione in cui vengono inviati i dati dei parametri del contatore delle prestazioni. È possibile aggiungere altre sezioni con ID univoci (ad esempio, "CloudWatch2", CloudWatch 3" e così via) e specificare una regione diversa per ogni nuovo ID per inviare gli stessi dati a posizioni diverse.

**CloudWatchLogs**  
La destinazione in cui vengono inviati i dati di log. Puoi aggiungere altre sezioni con ID univoci (ad esempio "CloudWatchLogs2«, CloudWatchLogs3 «e così via) e specificare una regione diversa per ogni nuovo ID per inviare gli stessi dati a posizioni diverse.

### Sintassi
<a name="cloudWatch-syntax"></a>

```
"runtimeConfig":{
        "aws:cloudWatch":{
            "settings":{
                "startType":"{{ status }}"
            },
            "properties":"{{ properties }}"
        }
    }
```

### Impostazioni e proprietà
<a name="cloudWatch-properties"></a>

**AccessKey**  
L'ID chiave di accesso . Questa proprietà è obbligatoria, a meno che l'utente non abbia avviato l'istanza usando un ruolo IAM. Questa proprietà non può essere utilizzata con SSM.  
▬Tipo: stringa  
Obbligatorio: no

**CategoryName**  
La categoria del contatore delle prestazioni da Performance Monitor.  
Tipo: stringa  
Obbligatorio: sì

**CounterName**  
Il nome del contatore delle prestazioni da Performance Monitor.  
Tipo: stringa  
Obbligatorio: sì

**CultureName**  
L'impostazione locale in cui viene registrato il timestamp. Se **CultureName**è vuoto, il valore predefinito è lo stesso locale usato dall'istanza. Windows Server  
Tipo: String  
Valori validi: per un elenco dei valori supportati, consulta [National Language Support (NLS)](https://msdn.microsoft.com/en-us/library/cc233982.aspx) sul sito Web Microsoft. I valori **div**, **div-MV**, **hu** e **hu-HU** non sono supportati.  
Obbligatorio: no

**DimensionName**  
Una dimensione per la tua CloudWatch metrica Amazon. Se specifichi `DimensionName`, devi specificare `DimensionValue`. Questi parametri forniscono un'altra vista al momento della creazione di elenchi di parametri. Puoi utilizzare la stessa dimensione per più parametri per poter visualizzare tutti i parametri appartenenti a una dimensione specifica.  
▬Tipo: stringa  
Obbligatorio: no

**DimensionValue**  
Un valore dimensionale per la tua CloudWatch metrica Amazon.  
▬Tipo: stringa  
Obbligatorio: no

**Encoding**  
La codifica del file da utilizzare (ad esempio, UTF-8). Utilizza il nome di codifica, non il nome di visualizzazione.  
Tipo: String  
Valori validi: per un elenco dei valori supportati, consulta l'argomento relativo alla [classe di codifica](https://learn.microsoft.com/en-us/dotnet/api/system.text.encoding?view=net-7.0) nella libreria di Microsoft Learn.  
Obbligatorio: sì

**Filtro**  
Il prefisso dei nomi di log. Lascia questo parametro bianco per monitorare tutti i file.  
Tipo: String  
Valori validi: per un elenco dei valori supportati, consulta la [FileSystemWatcherFilter proprietà](http://msdn.microsoft.com/en-us/library/system.io.filesystemwatcher.filter.aspx) nella libreria MSDN.  
Obbligatorio: no

**Flussi**  
Ogni tipo di dati da caricare, insieme alla destinazione dei dati (CloudWatch o dei CloudWatch registri). Ad esempio, per inviare un contatore delle prestazioni definito in `"Id": "PerformanceCounter"` alla CloudWatch destinazione definita in`"Id": "CloudWatch"`, inserisci **CloudWatch"PerformanceCounter,»**. Analogamente, per inviare il registro personalizzato, il registro ETW e il registro di sistema alla destinazione dei CloudWatch registri definita in`"Id": "ETW"`, immettete **«(ETW)**,". CloudWatchLogs Inoltre, puoi inviare lo stesso contatore delle prestazioni o file di log a più destinazioni. Ad esempio, per inviare il registro dell'applicazione a due diverse destinazioni definite in `"Id": "CloudWatchLogs"` e`"Id": "CloudWatchLogs2"`, immettete **", (ApplicationEventLogCloudWatchLogs, CloudWatchLogs2)**».  
Tipo: String  
Valori validi (origine): `ApplicationEventLog` \| `CustomLogs` \| `ETW` \| `PerformanceCounter` \| `SystemEventLog` \| `SecurityEventLog`   
Valori validi (destinazione): `CloudWatch` \| `CloudWatchLogs` \| `CloudWatch` {{n}} \| `CloudWatchLogs` {{n}}   
Obbligatorio: sì

**FullName**  
Il nome completo del componente.  
Tipo: stringa  
Obbligatorio: sì

**Id**  
Identifica l'origine o la destinazione dei dati. Questo identificatore deve essere univoco all'interno del file di configurazione.  
Tipo: stringa  
Obbligatorio: sì

**InstanceName**  
Il nome dell'istanza del contatore delle prestazioni. Non utilizzare un asterisco (\*) per indicare tutte le istanze perché ciascun componente del contatore delle prestazioni supporta solo un parametro. Tuttavia, puoi utilizzare **\_Total**.  
Tipo: stringa  
Obbligatorio: sì

**Levels**  
I tipi di messaggi da inviare ad Amazon CloudWatch.  
Tipo: String  
Valori validi:   
+ **1**: solo i messaggi di errore caricati.
+ **2**: solo i messaggi di avviso caricati.
+ **4**: solo i messaggi informativi caricati.
È possibile aggiungere valori per includere più di un tipo di messaggio. Ad esempio, **3** indica che i messaggi di errore (**1**) e i messaggi di avviso (**2**) sono inclusi. Un valore pari a **7** indica che i messaggi di errore (**1**), i messaggi di avviso (**2**) e i messaggi informativi (**4**) sono inclusi.  
Obbligatorio: sì  
I log di sicurezza di Windows dovrebbero impostare livelli fino a 7.

**LineCount**  
Il numero di righe dell'intestazione per identificare il file di log. Ad esempio, i file di log IIS dispongono di intestazioni praticamente identiche. Puoi inserire **3**, che può leggere le prime tre righe dell'intestazione del file di log per identificarlo. Nei file di log IIS, la terza riga è costituita dalla data e dal timestamp, che è diverso tra i file di log.  
Tipo: Integer  
Obbligatorio: no

**LogDirectoryPath**  
Per CustomLogs, il percorso in cui vengono archiviati i log sulla tua istanza EC2. Per i registri IIS, la cartella in cui sono archiviati i registri IIS per un singolo sito (ad esempio, **C:\\\\ inetpub\\\\ logs\\\\\\\\ W3SVC**). LogFiles {{n}} Per i log di IIS, è supportato solo il formato di log W3C. I formati IIS, NCSA e quelli personalizzati non sono supportati.   
Tipo: stringa  
Obbligatorio: sì

**LogGroup**  
Nome del gruppo di log. Questo nome viene visualizzato sulla schermata **Log Groups (Gruppi di log)** nella console CloudWatch.  
Tipo: stringa  
Obbligatorio: sì

**LogName**  
Nome del file di log.  

1. Per individuare il nome del log, in Visualizzatore eventi, nel riquadro di navigazione, scegli **Log di applicazioni e servizi**.

1. Nell'elenco dei registri, fai clic con il pulsante destro del mouse sul log che desideri caricare (ad esempio, `Microsoft` > `Windows` > `Backup` > `Operational`), quindi seleziona **Crea visualizzazione personalizzata**.

1. Nella finestra di dialogo **Crea visualizzazione personalizzata**, scegli la scheda **XML**. **LogName**Si trova nel tag <Select Path=> (ad esempio,). `Microsoft-Windows-Backup` Copia questo testo nel parametro. **LogName**
Tipo: String  
Valori validi: `Application`\| `Security`\| `System`\| `Microsoft-Windows-WinINet/Analytic`  
Obbligatorio: sì

**LogStream**  
Il flusso di log di destinazione. Se utilizzi **{instance\_id}**, il valore predefinito, l'ID di questa istanza viene utilizzato come nome del flusso di log.  
Tipo: String  
Valori validi: `{instance_id}` \| `{hostname}` \| `{ip_address}` {{<log\_stream\_name>}}  
Se inserisci un nome di log stream che non esiste già, CloudWatch Logs lo crea automaticamente per te. Puoi utilizzare una stringa letterale o variabili predefinite (**{instance\_id}**, **{hostname}**, **{ip\_address}**) o una combinazione di tutte e tre per definire un nome di flusso di log.  
Il nome del flusso di log specificato in questo parametro viene visualizzato nella {{<YourLogStream>}} schermata **Log Groups > Streams for** della CloudWatch console.  
Obbligatorio: sì

**MetricName**  
La CloudWatch metrica in cui desideri includere i dati sulle prestazioni.  
Non utilizzare caratteri speciali nel nome. In caso contrario, il parametro e gli allarmi associati potrebbero non funzionare.
Tipo: stringa  
Obbligatorio: sì

**NameSpace**  
Il namespace parametro in cui desideri che vengano scritti i dati dei contatori delle prestazioni.  
Tipo: stringa  
Obbligatorio: sì

**PollInterval**  
Il numero di secondi che devono trascorrere prima che un nuovo contatore delle prestazioni e i dati di log vengano caricati.  
Tipo: numero intero  
Valori validi: imposta questo valore su 5 o più secondi. Quindici secondi (00:00:15) è il valore consigliato.  
Obbligatorio: sì

**Region**  
Il Regione AWS luogo in cui desideri inviare i dati di registro. Sebbene possa inviare contatori delle prestazioni a una regione diversa rispetto a quella a cui invii i dati di log, è consigliabile impostare questo parametro sulla stessa regione in cui l'istanza è in esecuzione.  
Tipo: String  
Valori validi: ID delle regioni Regioni AWS supportati da Systems Manager e CloudWatch Logs, ad esempio `us-east-2``eu-west-1`, e`ap-southeast-1`. Per gli elenchi degli endpoint del servizio Regioni AWS supportati da ciascun servizio, consulta [Amazon CloudWatch Logs Service Endpoints](https://docs.aws.amazon.com/general/latest/gr/cwl_region.html#cwl_region) and [Systems Manager](https://docs.aws.amazon.com/general/latest/gr/ssm.html#ssm_region) nel. *Riferimenti generali di Amazon Web Services*   
Obbligatorio: sì

**SecretKey**  
La chiave di accesso segreta . Questa proprietà è obbligatoria, a meno che l'utente non abbia avviato l'istanza usando un ruolo IAM.  
▬Tipo: stringa  
Obbligatorio: no

**startType**  
Attiva o disattiva l'istanza CloudWatch .  
Tipo: String  
Valori validi: `Enabled` \| `Disabled`  
Obbligatorio: sì

**TimestampFormat**  
Il formato del timestamp che desideri utilizzare. Per un elenco dei valori supportati, consulta l'argomento [Stringhe di formato di data e ora personalizzato](http://msdn.microsoft.com/en-us/library/8kb3ddd4.aspx) nella libreria MSDN.  
Tipo: stringa  
Obbligatorio: sì

**TimeZoneKind**  
Fornisce le informazioni sul fuso orario se non sono incluse nel timestamp del log. Se questo parametro viene lasciato vuoto e se il timestamp non include informazioni sul fuso orario, CloudWatch Logs utilizza per impostazione predefinita il fuso orario locale. Questo parametro viene ignorato se il timestamp contiene già informazioni sul fuso orario.  
Tipo: String  
Valori validi: `Local` \| `UTC`  
Obbligatorio: no

**Unità**  
L'unità di misura appropriata per il parametro.  
Tipo: String  
Valori validi: secondi \| Microsecondi \| Millisecondi \| Byte \| Kilobyte \| Megabyte \| Gigabyte \| Terabyte \| Bit \| Kilobit \| Megabit \| Gigabit \| Terabit \| Percentuale Bytes/Second \| Numero Kilobytes/Second Megabytes/Second \| Gigabytes/Second \| Terabytes/Second \| \| Bits/Second \| Kilobits/Second \| Megabits/Second \| Gigabits/Second \| Terabits/Second \| Count/Second \| Nessuno  
Obbligatorio: sì

## `aws:configureDocker`
<a name="aws-configuredocker"></a>

(Versione dello schema 2.0 o successiva) Configura un'istanza da utilizzare con contenitori e Docker. Questo plug-in è supportato su gran parte delle versioni di Linux e sui sistemi operativi Windows Server.

### Sintassi
<a name="configuredocker-syntax"></a>

#### Schema 2.2
<a name="configuredocker-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:configureDocker
parameters:
  action:
    description: "(Required) The type of action to perform."
    type: String
    default: Install
    allowedValues:
    - Install
    - Uninstall
mainSteps:
- action: aws:configureDocker
  name: configureDocker
  inputs:
    action: "{{ action }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:configureDocker plugin",
  "parameters": {
    "action": {
      "description": "(Required) The type of action to perform.",
      "type": "String",
      "default": "Install",
      "allowedValues": [
        "Install",
        "Uninstall"
      ]
    }
  },
  "mainSteps": [
    {
      "action": "aws:configureDocker",
      "name": "configureDocker",
      "inputs": {
        "action": "{{ action }}"
      }
    }
  ]
}
```

------

### Input
<a name="configuredocker-properties"></a>

**operazione**  
Il tipo di operazione da eseguire.  
Tipo: Enum  
Valori validi: `Install` \| `Uninstall`  
Obbligatorio: sì

## `aws:configurePackage`
<a name="aws-configurepackage"></a>

(Schema AWS Systems Manager Distributor versione 2.0 o successiva) Installa o disinstalla un pacchetto. Puoi installare la versione più recente, la versione predefinita o una versione del pacchetto specificata. Sono supportati anche AWS i pacchetti forniti da. Questo plugin viene eseguito sui sistemi operativi Windows Server e Linux, ma non tutti i pacchetti disponibili sono supportati sui sistemi operativi Linux.

 AWS I pacchetti disponibili Windows Server includono quanto segue: `AWSPVDriver``AWSNVMe`,`AwsEnaNetworkDriver`,`AwsVssComponents`,`AmazonCloudWatchAgent`,`CodeDeployAgent`, e `AWSSupport-EC2Rescue.`

 AWS I pacchetti disponibili per i sistemi operativi Linux includono quanto segue:`AmazonCloudWatchAgent`,`CodeDeployAgent`, e`AWSSupport-EC2Rescue`.

### Sintassi
<a name="configurepackage-syntax"></a>

#### Schema 2.2
<a name="configurepackage-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:configurePackage
parameters:
  name:
    description: "(Required) The name of the AWS package to install or uninstall."
    type: String
  action:
    description: "(Required) The type of action to perform."
    type: String
    default: Install
    allowedValues:
    - Install
    - Uninstall
  ssmParameter:
    description: "(Required) Argument stored in Parameter Store."
    type: String
    default: "{{ ssm:{{parameter_store_arg}} }}"
mainSteps:
- action: aws:configurePackage
  name: configurePackage
  inputs:
    name: "{{ name }}"
    action: "{{ action }}"
    additionalArguments: 
      "{\"SSM_parameter_store_arg\": \"{{ ssmParameter }}\", \"SSM_custom_arg\": \"{{myValue}}\"}"
```

------
#### [ JSON ]

```
{
   "schemaVersion": "2.2",
   "description": "aws:configurePackage",
   "parameters": {
      "name": {
         "description": "(Required) The name of the AWS package to install or uninstall.",
         "type": "String"
      },
      "action": {
         "description": "(Required) The type of action to perform.",
         "type": "String",
         "default": "Install",
         "allowedValues": [
            "Install",
            "Uninstall"
         ]
      },
      "ssmParameter": {
         "description": "(Required) Argument stored in Parameter Store.",
         "type": "String",
         "default": "{{ ssm:{{parameter_store_arg}} }}"
      }
   },
   "mainSteps": [
      {
         "action": "aws:configurePackage",
         "name": "configurePackage",
         "inputs": {
            "name": "{{ name }}",
            "action": "{{ action }}",
            "additionalArguments": "{\"SSM_parameter_store_arg\": \"{{ ssmParameter }}\", \"SSM_custom_arg\": \"{{myValue}}\"}"
         }
      }
   ]
}
```

------

### Input
<a name="configurepackage-properties"></a>

**nome**  
Il nome del AWS pacchetto da installare o disinstallare. I pacchetti disponibili includono: `AWSPVDriver`, `AwsEnaNetworkDriver`, `AwsVssComponents` e `AmazonCloudWatchAgent`.   
Tipo: stringa  
Obbligatorio: sì

**operazione**  
Installa o disinstalla un pacchetto.  
Tipo: Enum  
Valori validi: `Install` \| `Uninstall`  
Obbligatorio: sì

**Tipo di installazione**  
Il tipo di installazione da eseguire. Se si specifica `Uninstall and reinstall`, il pacchetto viene completamente disinstallato e quindi reinstallato. L'applicazione non è disponibile fino al completamento della reinstallazione. Se si specifica `In-place update`, solo i file nuovi o modificati vengono aggiunti all'installazione esistente in base alle istruzioni fornite in uno script di aggiornamento. L'applicazione rimane disponibile durante tutto il processo di aggiornamento. L'`In-place update`opzione non è supportata per i pacchetti AWS-published. `Uninstall and reinstall`è il valore predefinito.  
Tipo: Enum  
Valori validi: `Uninstall and reinstall` \| `In-place update`  
Obbligatorio: no

**additionalArguments**  
Una stringa JSON di parametri aggiuntivi da fornire agli script di installazione, disinstallazione o aggiornamento. Ogni parametro deve essere preceduto da `SSM_`. È possibile fare riferimento a un parametro Parameter Store negli argomenti aggiuntivi utilizzando la convenzione `{{ssm:{{parameter-name}}}}`. Per utilizzare il parametro aggiuntivo nello script di installazione, disinstallazione o aggiornamento, è necessario fare riferimento al parametro come variabile di ambiente utilizzando la sintassi appropriata per il sistema operativo. Ad esempio, in PowerShell, si fa riferimento all'`SSM_arg`argomento come`$Env:SSM_arg`. Non vi è alcun limite al numero di argomenti definiti, ma l'input dell'argomento aggiuntivo ha un limite di 4096 caratteri. Questo limite include tutte le chiavi e i valori definiti.  
Tipo: StringMap  
Obbligatorio: no

**version**  
Una versione specifica del pacchetto da installare o disinstallare. In caso di installazione, il sistema installa per impostazione predefinita l'ultima versione pubblicata. In caso di disinstallazione, il sistema disinstalla per impostazione predefinita la versione attualmente installata. Se non viene trovata nessuna versione installata, viene scaricata l'ultima versione pubblicata e viene eseguita l'operazione di disinstallazione.  
▬Tipo: stringa  
Obbligatorio: no

## `aws:domainJoin`
<a name="aws-domainJoin"></a>

Aggiungi un'istanza EC2 a un dominio. Questo plugin funziona su Linux e sistemi operativi Windows Server. Questo plugin modifica il nome host per le istanze Linux nel formato EC2AMAZ-. {{XXXXXXX}} *Per ulteriori informazioni sull'aggiunta di istanze EC2, consulta [Join an EC2 Instance to Your Managed AWS Microsoft AD Directory nella Administration](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ms_ad_join_instance.html) Guide.AWS Directory Service *

### Sintassi
<a name="domainJoin-syntax"></a>

#### Schema 2.2
<a name="domainJoin-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:domainJoin
parameters:
  directoryId:
    description: "(Required) The ID of the directory."
    type: String
  directoryName:
    description: "(Required) The name of the domain."
    type: String
  directoryOU:
    description: "(Optional) The organizational unit to assign the computer object to."
    type: String
  dnsIpAddresses:
    description: "(Required) The IP addresses of the DNS servers for your directory."
    type: StringList
  hostname:
    description: "(Optional) The hostname you want to assign to the node."
    type: String
mainSteps:
- action: aws:domainJoin
  name: domainJoin
  inputs:
    directoryId: "{{ directoryId }}"
    directoryName: "{{ directoryName }}"
    directoryOU: "{{ directoryOU }}"
    dnsIpAddresses: "{{ dnsIpAddresses }}"
    hostname: "{{ hostname }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:domainJoin",
  "parameters": {
    "directoryId": {
      "description": "(Required) The ID of the directory.",
      "type": "String"
    },
    "directoryName": {
      "description": "(Required) The name of the domain.",
      "type": "String"
    },
    "directoryOU": {
        "description": "(Optional) The organizational unit to assign the computer object to.",
        "type": "String"
      },
    "dnsIpAddresses": {
      "description": "(Required) The IP addresses of the DNS servers for your directory.",
      "type": "StringList"
    },
    "hostname": {
        "description": "(Optional) The hostname you want to assign to the node.",
        "type": "String"
      }
  },
  "mainSteps": [
    {
      "action": "aws:domainJoin",
      "name": "domainJoin",
      "inputs": {
        "directoryId": "{{ directoryId }}",
        "directoryName": "{{ directoryName }}",
        "directoryOU":"{{ directoryOU }}",
        "dnsIpAddresses":"{{ dnsIpAddresses }}",
        "hostname":"{{ hostname }}"
      }
    }
  ]
}
```

------

#### Schema 1.2
<a name="domainJoin-syntax-1.2"></a>

------
#### [ YAML ]

```
---
runtimeConfig:
  aws:domainJoin:
    properties:
      directoryId: "{{ directoryId }}"
      directoryName: "{{ directoryName }}"
      directoryOU: "{{ directoryOU }}"
      dnsIpAddresses: "{{ dnsIpAddresses }}"
```

------
#### [ JSON ]

```
{
   "runtimeConfig":{
      "aws:domainJoin":{
         "properties":{
            "directoryId":"{{ directoryId }}",
            "directoryName":"{{ directoryName }}",
            "directoryOU":"{{ directoryOU }}",
            "dnsIpAddresses":"{{ dnsIpAddresses }}"
         }
      }
   }
}
```

------

### Properties
<a name="domainJoin-properties"></a>

**directoryId**  
L'ID della directory.  
Tipo: stringa  
Obbligatorio: sì  
Esempio: "directoryId": "d-1234567890"

**directoryName**  
Il nome del dominio.  
Tipo: stringa  
Obbligatorio: sì  
Esempio: "directoryName": "example.com"

**directoryOU**  
L'unità organizzativa (UO).  
▬Tipo: stringa  
Obbligatorio: no  
Esempio: "directoryOU": "OU=test,DC=example,DC=com"

**dns IpAddresses**  
Gli indirizzi IP dei server DNS.  
Tipo: StringList  
Obbligatorio: sì  
Esempio: «dns IpAddresses «: [" 198.51.100.1", "198.51.100.2"]

**hostname**  
Il nome host che si desidera assegnare al nodo. Se non viene fornito, non viene effettuata alcuna modifica del nome per le istanze Windows Server, mentre le istanze Linux utilizzeranno lo schema di denominazione predefinito. Se fornito, le istanze Windows Server utilizzeranno l'esatto valore fornito, mentre per le istanze Linux fungerà da prefisso (a meno che non `keepHostName` sia impostato su "true").  
▬Tipo: stringa  
Obbligatorio: no

**mantenere HostName**  
Determina se il nome host viene modificato per le istanze Linux quando vengono aggiunte al dominio. Questo è un Linux-only parametro. Per impostazione predefinita (senza input e con `keepHostName` «false»), gli host Linux verranno rinominati secondo lo schema. `hostname` `hostnameNumAppendDigits` EC2AMAZ-XXXXXX Se impostato su "true", mantiene il nome host originale e ignora gli input verso `hostname` e `hostnameNumAppendDigits`.  
Tipo: Booleano  
Obbligatorio: no

**nome host NumAppendDigits**  
Definisce il numero di cifre numeriche casuali da aggiungere dopo il valore del nome host. Questo è un Linux-only parametro e viene utilizzato insieme al `hostname` parametro. Se `hostname` non viene fornito, viene ignorato.  
Tipo: String  
Valori validi: da 1 a 5  
Obbligatorio: no

### Esempi
<a name="domainJoin-examples"></a>

Per alcuni esempi, consulta la sezione [Unire un'istanza Amazon EC2 a AWS Managed Microsoft AD](https://docs.aws.amazon.com/directoryservice/latest/admin-guide/ec2-join-aws-domain.html) nella *AWS Directory Service Guida per gli amministratori di *.

## `aws:downloadContent`
<a name="aws-downloadContent"></a>

(Versione dello schema 2.0 o successiva) Scaricare documenti e script SSM da posizioni remote. I repository di GitHub Enterprise non sono supportati. Questo plugin è supportato su Linux e dai sistemi operativi Windows Server.

### Sintassi
<a name="downloadContent-syntax"></a>

#### Schema 2.2
<a name="downloadContent-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:downloadContent
parameters:
  sourceType:
    description: "(Required) The download source."
    type: String
  sourceInfo:
    description: "(Required) The information required to retrieve the content from
      the required source."
    type: StringMap
mainSteps:
- action: aws:downloadContent
  name: downloadContent
  inputs:
    sourceType: "{{ sourceType }}"
    sourceInfo: "{{ sourceInfo }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:downloadContent",
  "parameters": {
    "sourceType": {
    "description": "(Required) The download source.",
    "type": "String"
  },
  "sourceInfo": {
    "description": "(Required) The information required to retrieve the content from the required source.",
    "type": "StringMap"
    }
  },
  "mainSteps": [
    {
      "action": "aws:downloadContent",
      "name": "downloadContent",
      "inputs": {
        "sourceType":"{{ sourceType }}",
        "sourceInfo":"{{ sourceInfo }}"
      }
    }
  ]
}
```

------

### Input
<a name="downloadContent-inputs"></a>

**sourceType**  
Origine del download Systems Manager supporta i seguenti tipi di origine per il download di script e di documenti SSM: `GitHub`, `Git`, `HTTP`, `S3` e `SSMDocument`.  
Tipo: stringa  
Obbligatorio: sì

**sourceInfo**  
Le informazioni necessarie per recuperare il contenuto dall'origine richiesta.  
Tipo: StringMap  
Obbligatorio: sì  
 **Per sourceType `GitHub,`, specificare quanto segue:**   
+ owner: il proprietario del repository.
+ repository: il nome del repository.
+ path: il percorso del file o della directory che desideri scaricare.
+ getOptions: opzioni aggiuntive per recuperare il contenuto da un ramo diverso dal master o da un commit specifico nel repository. getOptions può essere omesso se si utilizza l'ultimo commit nel ramo master. Se il repository è stato creato dopo il 1° ottobre 2020, il ramo predefinito potrebbe essere denominato main anziché master. In questo caso, si dovranno specificare i valori per il parametro getOptions.

  Questo parametro utilizza il seguente formato:
  + ramo:refs/heads/{{branch\_name}}

    Il valore predefinito è `master`.

    Per specificare un ramo non predefinito, utilizza il formato seguente:

    filiale:refs/heads/{{branch\_name}}
  + CommitID: {{commitID}}

    Il valore predefinito è `head`.

    Per utilizzare la versione del documento SSM in un commit diverso da quello più recente, specificare l'ID di commit completo. Esempio:

    ```
    "getOptions": "commitID:bbc1ddb94...b76d3bEXAMPLE",
    ```
+ TokenInfo: il parametro Systems Manager ( SecureStringun parametro) in cui vengono GitHub memorizzate le informazioni sul token di accesso, nel formato. `{{ssm-secure:{{secure-string-token-name}}}}`
**Nota**  
Questo `tokenInfo` campo è l'unico campo del plug-in di documenti SSM che supporta un parametro. SecureString SecureString i parametri non sono supportati per nessun altro campo, né per nessun altro plugin di documenti SSM.

```
{
    "owner":"TestUser",
    "repository":"{{GitHubTest}}",
    "path":"{{scripts/python/test-script}}",
    "getOptions":"branch:master",
    "tokenInfo":"{{ssm-secure:{{secure-string-token}}}}"
}
```
 **Per sourceType `Git`, si deve specificare quanto segue:**   
+ repository

  L'URL del repository Git relativo al file o alla directory che si desidera scaricare.

  Tipo: String
Inoltre, è possibile specificare i seguenti parametri facoltativi:  
+ getOptions

  Opzioni aggiuntive per recuperare il contenuto da un ramo diverso dal master o da un commit specifico nel repository. getOptions può essere omesso se si utilizza l'ultimo commit nel ramo master.

  Tipo: String

  Questo parametro utilizza il seguente formato:
  + ramo:/refs/heads{{branch\_name}}

    Il valore predefinito è `master`.

    `"branch"` è necessario solo se il documento SSM è memorizzato in un ramo diverso da `master`. Esempio:

    ```
    "getOptions": "branch:refs/heads/main"
    ```
  + CommitID: {{commitID}}

    Il valore predefinito è `head`.

    Per utilizzare la versione del documento SSM in un commit diverso da quello più recente, specificare l'ID di commit completo. Ad esempio:

    ```
    "getOptions": "commitID:bbc1ddb94...b76d3bEXAMPLE",
    ```
+ PrivateShkey

  La chiave SSH da usare durante la connessione al `repository` specificato. È possibile utilizzare il formato seguente per riferirsi a un parametro `SecureString` per il valore della chiave SSH: `{{ssm-secure:{{your-secure-string-parameter}}}}`.

  Tipo: String
+ saltare HostKeyChecking

  Determina il valore dell' StrictHostKeyCheckingopzione quando ci si `repository` connette all'indirizzo specificato. Il valore predefinito è `false`.

  Tipo: Booleano
+ username

  Il nome utente da usare durante la connessione al `repository`specificato utilizzando HTTP. È possibile utilizzare il formato seguente per riferirsi a un parametro `SecureString` per il valore del nome utente: `{{ssm-secure:{{your-secure-string-parameter}}}}`.

  Tipo: String
+ password

  La password da usare durante la connessione al `repository`specificato utilizzando HTTP. È possibile utilizzare il formato seguente per riferirsi a un parametro `SecureString` per il valore della password: `{{ssm-secure:{{your-secure-string-parameter}}}}`.

  Tipo: String
 **Per sourceType `HTTP`, si deve specificare quanto segue:**   
+ url

  L'URL del file o della directory che si desidera scaricare.

  Tipo: String
Inoltre, è possibile specificare i seguenti parametri facoltativi:  
+ consentire InsecureDownload

  Determina se è possibile eseguire un download tramite una connessione non crittografata con Secure Socket Layer (SSL) o Transport Layer Security (TLS). Il valore predefinito è `false`. Si sconsiglia l'esecuzione di download senza crittografia. Se si sceglie di farlo, si assumono tutti i relativi rischi. La sicurezza è una responsabilità condivisa tra te AWS e te. Questo è descritto come il modello di responsabilità condivisa. Per ulteriori informazioni, consulta il [modello di responsabilità condivisa](https://aws.amazon.com/compliance/shared-responsibility-model/).

  Tipo: Booleano
+ authMethod

  Determina se un nome utente e una password vengono utilizzati per l'autenticazione durante la connessione all'`url` specificato. Se si specifica `Basic` o `Digest`, è necessario fornire valori per i parametri `username` e `password`. Per utilizzare il metodo `Digest`, deve essere installata nell'istanza la versione di SSM Agent 3.0.1181.0 o successiva. Il metodo `Digest` supporta la crittografia MD5 e SHA256.

  Tipo: String

  Valori validi: `None` \| `Basic` \| `Digest`
+ username

  Il nome utente da usare durante la connessione all'`url` specificato utilizzando l'autenticazione `Basic`. È possibile utilizzare il formato seguente per riferirsi a un parametro `SecureString` per il valore del nome utente: `{{ssm-secure:{{your-secure-string-parameter}}}}`.

  Tipo: String
+ password

  La password da usare durante la connessione all'`url` specificato utilizzando l'autenticazione `Basic`. È possibile utilizzare il formato seguente per riferirsi a un parametro `SecureString` per il valore della password: `{{ssm-secure:{{your-secure-string-parameter}}}}`.

  Tipo: String
 **Per sourceType `S3`, specificare quanto segue:**   
+ path: l'URL del file o della directory che si desidera scaricare da Amazon S3.
Quando si scarica un file da un bucket S3, i file.etag vengono generati nella directory di download.

```
{
    "path": "https://s3.amazonaws.com/{{amzn-s3-demo-bucket}}/powershell/helloPowershell.ps1" 
}
```
 **Per sourceType `SSMDocument`, specificare *uno* dei seguenti valori:**   
+ name: il nome e la versione del documento nel formato seguente: `name:version`. La versione è facoltativa. 

  ```
  {
      "name": "Example-RunPowerShellScript:3" 
  }
  ```
+ name: l'ARN del documento nel seguente formato: `arn:aws:ssm:{{region}}:{{account_id}}:document/{{document_name}}`

  ```
  {
     "name":"arn:aws:ssm:us-east-2:3344556677:document/MySharedDoc"
  }
  ```

**destinationPath**  
Un percorso locale facoltativo nell'istanza in cui desideri scaricare il file. Se non specifichi un percorso, i contenuti vengono scaricati in un percorso relativo al tuo ID comando.  
▬Tipo: stringa  
Obbligatorio: no

## `aws:psModule`
<a name="aws-psModule"></a>

Installa PowerShell i moduli su un'istanza Amazon EC2. Questo plugin può essere eseguito solo su sistemi operativi Windows Server.

### Sintassi
<a name="psModule-syntax"></a>

#### Schema 2.2
<a name="psModule-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:psModule
parameters:
  source:
    description: "(Required) The URL or local path on the instance to the application
      .zip file."
    type: String
mainSteps:
- action: aws:psModule
  name: psModule
  inputs:
    source: "{{ source }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:psModule",
  "parameters": {
    "source": {
      "description": "(Required) The URL or local path on the instance to the application .zip file.",
      "type": "String"
    }
  },
  "mainSteps": [
    {
      "action": "aws:psModule",
      "name": "psModule",
      "inputs": {
        "source": "{{ source }}"
      }
    }
  ]
}
```

------

#### Schema 1.2
<a name="domainJoin-syntax-1.2"></a>

------
#### [ YAML ]

```
---
runtimeConfig:
  aws:psModule:
    properties:
    - runCommand: "{{ commands }}"
      source: "{{ source }}"
      sourceHash: "{{ sourceHash }}"
      workingDirectory: "{{ workingDirectory }}"
      timeoutSeconds: "{{ executionTimeout }}"
```

------
#### [ JSON ]

```
{
   "runtimeConfig":{
      "aws:psModule":{
         "properties":[
            {
               "runCommand":"{{ commands }}",
               "source":"{{ source }}",
               "sourceHash":"{{ sourceHash }}",
               "workingDirectory":"{{ workingDirectory }}",
               "timeoutSeconds":"{{ executionTimeout }}"
            }
         ]
      }
   }
}
```

------

### Properties
<a name="psModule-properties"></a>

**runCommand**  
Il PowerShell comando da eseguire dopo l'installazione del modulo.  
Tipo: StringList  
Obbligatorio: no

**origine**  
L'URL o il percorso locale nell'istanza al file `.zip` dell'applicazione.  
Tipo: stringa  
Obbligatorio: sì

**sourceHash**  
L'hash SHA256 del file `.zip`.  
▬Tipo: stringa  
Obbligatorio: no

**timeoutSeconds**  
Il tempo in secondi entro cui un comando deve essere portato a termine prima di essere considerato non riuscito.  
▬Tipo: stringa  
Obbligatorio: no

**workingDirectory**  
Il percorso alla directory di lavoro nell'istanza.  
▬Tipo: stringa  
Obbligatorio: no

## `aws:refreshAssociation`
<a name="aws-refreshassociation"></a>

(Versione dello schema 2.0 o successiva) Aggiorna (applicazione di forza) un'associazione on demand. Questa operazione modificherà lo stato del sistema in base a quanto definito nell'associazione selezionata o in tutte le associazioni dei target. Questo plugin funziona su sistemi operativi Linux e Microsoft Windows Server.

### Sintassi
<a name="refreshassociation-syntax"></a>

#### Schema 2.2
<a name="refreshassociation-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:refreshAssociation
parameters:
  associationIds:
    description: "(Optional) List of association IDs. If empty, all associations bound
      to the specified target are applied."
    type: StringList
mainSteps:
- action: aws:refreshAssociation
  name: refreshAssociation
  inputs:
    associationIds:
    - "{{ associationIds }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:refreshAssociation",
  "parameters": {
    "associationIds": {
      "description": "(Optional) List of association IDs. If empty, all associations bound to the specified target are applied.",
      "type": "StringList"
    }
  },
  "mainSteps": [
    {
      "action": "aws:refreshAssociation",
      "name": "refreshAssociation",
      "inputs": {
        "associationIds": [
          "{{ associationIds }}"
        ]
      }
    }
  ]
}
```

------

### Input
<a name="refreshassociation-properties"></a>

**associationIds**  
Elenco di ID di associazione. Se vuoto, vengono applicate tutte le associazioni ai target specificati.  
Tipo: StringList  
Obbligatorio: no

## `aws:runDockerAction`
<a name="aws-rundockeraction"></a>

(Versione dello schema 2.0 o successiva) Esegui operazioni Docker sui contenitori. Questo plugin funziona su sistemi operativi Linux e Microsoft Windows Server.

### Sintassi
<a name="rundockeraction-syntax"></a>

#### Schema 2.2
<a name="rundockeraction-syntax-2.2"></a>

------
#### [ YAML ]

```
---
mainSteps:
- action: aws:runDockerAction
  name: RunDockerAction
  inputs:
    action: "{{ action }}"
    container: "{{ container }}"
    image: "{{ image }}"
    memory: "{{ memory }}"
    cpuShares: "{{ cpuShares }}"
    volume: "{{ volume }}"
    cmd: "{{ cmd }}"
    env: "{{ env }}"
    user: "{{ user }}"
    publish: "{{ publish }}"
    workingDirectory: "{{ workingDirectory }}"
    timeoutSeconds: "{{ timeoutSeconds }}"
```

------
#### [ JSON ]

```
{
   "mainSteps":[
      {
         "action":"aws:runDockerAction",
         "name":"RunDockerAction",
         "inputs":{
            "action":"{{ action }}",
            "container":"{{ container }}",
            "image":"{{ image }}",
            "memory":"{{ memory }}",
            "cpuShares":"{{ cpuShares }}",
            "volume":"{{ volume }}",
            "cmd":"{{ cmd }}",
            "env":"{{ env }}",
            "user":"{{ user }}",
            "publish":"{{ publish }}",
            "workingDirectory": "{{ workingDirectory }}",
            "timeoutSeconds": "{{ timeoutSeconds }}"
         }
      }
   ]
}
```

------

### Input
<a name="rundockeraction-properties"></a>

**operazione**  
Il tipo di operazione da eseguire.  
Tipo: stringa  
Obbligatorio: sì

**container**  
L'ID del container Docker.  
▬Tipo: stringa  
Obbligatorio: no

**image**  
Il nome dell'immagine Docker.  
▬Tipo: stringa  
Obbligatorio: no

**cmd**  
Il comando del container.  
▬Tipo: stringa  
Obbligatorio: no

**memory**  
Il limite di memoria del container.  
▬Tipo: stringa  
Obbligatorio: no

**cpuShares**  
Le condivisioni di CPU del container (peso relativo).  
▬Tipo: stringa  
Obbligatorio: no

**volume**  
I montaggi dei volumi del container.  
Tipo: StringList  
Obbligatorio: no

**env**  
Le variabili di ambiente del container.  
▬Tipo: stringa  
Obbligatorio: no

**user**  
Il nome dell'utente del container.  
▬Tipo: stringa  
Obbligatorio: no

**pubblicazione**  
Le porte pubblicate del container.  
▬Tipo: stringa  
Obbligatorio: no

**workingDirectory**  
Il percorso verso la directory di lavoro nel nodo gestito dall'utente.  
▬Tipo: stringa  
Obbligatorio: no

**timeoutSeconds**  
Il tempo in secondi entro cui un comando deve essere portato a termine prima di essere considerato non riuscito.  
▬Tipo: stringa  
Obbligatorio: no

## `aws:runDocument`
<a name="aws-rundocument"></a>

(Versione dello schema 2.0 o successiva) Esegue documenti SSM archiviati in Systems Manager o in una condivisione locale. È possibile utilizzare questo plugin con il plugin [`aws:downloadContent`](#aws-downloadContent) per scaricare un documento SSM da una posizione remota a una condivisione locale, quindi eseguirlo. Questo plugin è supportato su Linux e dai sistemi operativi Windows Server. Questo plug-in non supporta l'esecuzione del documento `AWS-UpdateSSMAgent` o qualsiasi documento che utilizza il plugin `aws:updateSsmAgent`.

### Sintassi
<a name="rundocument-syntax"></a>

#### Schema 2.2
<a name="aws-rundocument-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:runDocument
parameters:
  documentType:
    description: "(Required) The document type to run."
    type: String
    allowedValues:
    - LocalPath
    - SSMDocument
mainSteps:
- action: aws:runDocument
  name: runDocument
  inputs:
    documentType: "{{ documentType }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:runDocument",
  "parameters": {
    "documentType": {
      "description": "(Required) The document type to run.",
      "type": "String",
      "allowedValues": [
        "LocalPath",
        "SSMDocument"
      ]
    }
  },
  "mainSteps": [
    {
      "action": "aws:runDocument",
      "name": "runDocument",
      "inputs": {
        "documentType": "{{ documentType }}"
      }
    }
  ]
}
```

------

### Input
<a name="rundocument-properties"></a>

**documentType**  
Il tipo di documento da eseguire. È possibile eseguire documenti locali (`LocalPath`) o documenti archiviati in Systems Manager (`SSMDocument`).  
Tipo: stringa  
Obbligatorio: sì

**documentPath**  
Il percorso del documento. Se `documentType` è `LocalPath`, specifica il percorso al documento nella condivisione locale. Se `documentType` è `SSMDocument`, specifica il nome del documento.  
▬Tipo: stringa  
Obbligatorio: no

**documentParameters**  
I parametri per il documento.  
Tipo: StringMap  
Obbligatorio: no

## `aws:runPowerShellScript`
<a name="aws-runPowerShellScript"></a>

Esegui PowerShell script o specifica il percorso di uno script da eseguire. Questo plugin può essere eseguito su sistemi operativi Microsoft Windows Server e Linux.

### Sintassi
<a name="runPowerShellScript-syntax"></a>

#### Schema 2.2
<a name="runPowerShellScript-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:runPowerShellScript
parameters:
  commands:
    type: String
    description: "(Required) The commands to run or the path to an existing script
      on the instance."
    default: Write-Host "Hello World"
mainSteps:
- action: aws:runPowerShellScript
  name: runPowerShellScript
  inputs:
    timeoutSeconds: '60'
    runCommand:
    - "{{ commands }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:runPowerShellScript",
  "parameters": {
    "commands": {
      "type": "String",
      "description": "(Required) The commands to run or the path to an existing script on the instance.",
      "default": "Write-Host \"Hello World\""
    }
  },
  "mainSteps": [
    {
      "action": "aws:runPowerShellScript",
      "name": "runPowerShellScript",
      "inputs": {
        "timeoutSeconds": "60",
        "runCommand": [
          "{{ commands }}"
        ]
      }
    }
  ]
}
```

------

#### Schema 1.2
<a name="runPowerShellScript-syntax-1.2"></a>

------
#### [ YAML ]

```
---
runtimeConfig:
  aws:runPowerShellScript:
    properties:
    - id: 0.aws:runPowerShellScript
      runCommand: "{{ commands }}"
      workingDirectory: "{{ workingDirectory }}"
      timeoutSeconds: "{{ executionTimeout }}"
```

------
#### [ JSON ]

```
{
   "runtimeConfig":{
      "aws:runPowerShellScript":{
         "properties":[
            {
               "id":"0.aws:runPowerShellScript",
               "runCommand":"{{ commands }}",
               "workingDirectory":"{{ workingDirectory }}",
               "timeoutSeconds":"{{ executionTimeout }}"
            }
         ]
      }
   }
}
```

------

### Properties
<a name="runPowerShellScript-properties"></a>

**runCommand**  
Specifica i comandi da eseguire o il percorso a uno script esistente nell'istanza.  
Tipo: StringList  
Obbligatorio: sì

**timeoutSeconds**  
Il tempo in secondi entro cui un comando deve essere portato a termine prima di essere considerato non riuscito. Quando viene raggiunto il timeout, Systems Manager interrompe l'esecuzione del comando.  
▬Tipo: stringa  
Obbligatorio: no

**workingDirectory**  
Il percorso alla directory di lavoro nell'istanza.  
▬Tipo: stringa  
Obbligatorio: no

## `aws:runShellScript`
<a name="aws-runShellScript"></a>

Esegui script di shell Linux o specifica il percorso a uno script da eseguire. Questo plugin può essere eseguito solo su sistemi operativi Linux.

### Sintassi
<a name="runShellScript-syntax"></a>

#### Schema 2.2
<a name="runShellScript-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:runShellScript
parameters:
  commands:
    type: String
    description: "(Required) The commands to run or the path to an existing script
      on the instance."
    default: echo Hello World
mainSteps:
- action: aws:runShellScript
  name: runShellScript
  inputs:
    timeoutSeconds: '60'
    runCommand:
    - "{{ commands }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:runShellScript",
  "parameters": {
    "commands": {
      "type": "String",
      "description": "(Required) The commands to run or the path to an existing script on the instance.",
      "default": "echo Hello World"
    }
  },
  "mainSteps": [
    {
      "action": "aws:runShellScript",
      "name": "runShellScript",
      "inputs": {
        "timeoutSeconds": "60",
        "runCommand": [
          "{{ commands }}"
        ]
      }
    }
  ]
}
```

------

#### Schema 1.2
<a name="runShellScript-syntax-1.2"></a>

------
#### [ YAML ]

```
---
runtimeConfig:
  aws:runShellScript:
    properties:
    - runCommand: "{{ commands }}"
      workingDirectory: "{{ workingDirectory }}"
      timeoutSeconds: "{{ executionTimeout }}"
```

------
#### [ JSON ]

```
{
   "runtimeConfig":{
      "aws:runShellScript":{
         "properties":[
            {
               "runCommand":"{{ commands }}",
               "workingDirectory":"{{ workingDirectory }}",
               "timeoutSeconds":"{{ executionTimeout }}"
            }
         ]
      }
   }
}
```

------

### Properties
<a name="runShellScript-properties"></a>

**runCommand**  
Specifica i comandi da eseguire o il percorso a uno script esistente nell'istanza.  
Tipo: StringList  
Obbligatorio: sì

**timeoutSeconds**  
Il tempo in secondi entro cui un comando deve essere portato a termine prima di essere considerato non riuscito. Quando viene raggiunto il timeout, Systems Manager interrompe l'esecuzione del comando.  
▬Tipo: stringa  
Obbligatorio: no

**workingDirectory**  
Il percorso alla directory di lavoro nell'istanza.  
▬Tipo: stringa  
Obbligatorio: no

## `aws:softwareInventory`
<a name="aws-softwareinventory"></a>

(Versione dello schema 2.0 o successiva) è possibile ottenere i metadati su applicazioni, file e configurazioni sulle istanze gestite. Questo plugin funziona su sistemi operativi Linux e Microsoft Windows Server. Quando si configura la raccolta dell'inventario, si inizia con la creazione di un' AWS Systems Manager State Managerassociazione. Systems Manager raccoglie i dati dell'inventario quando viene eseguita l'associazione. Se non si crea prima l'associazione e si tenta di richiamare il plugin `aws:softwareInventory`, il sistema restituisce il seguente errore:

```
The aws:softwareInventory plugin can only be invoked via ssm-associate.
```

Un'istanza può avere una sola associazione di Inventory configurata alla volta. Se configuri un'istanza con due o più associazioni, l'associazione di Inventory non viene eseguita e non viene raccolto alcun dato dell'inventario. Per ulteriori informazioni sulla raccolta dell'inventario, consulta [AWS Systems Manager Inventory](systems-manager-inventory.md).

### Sintassi
<a name="softwareinventory-syntax"></a>

#### Schema 2.2
<a name="softwareinventory-syntax-2.2"></a>

------
#### [ YAML ]

```
---
mainSteps:
- action: aws:softwareInventory
  name: collectSoftwareInventoryItems
  inputs:
    applications: "{{ applications }}"
    awsComponents: "{{ awsComponents }}"
    networkConfig: "{{ networkConfig }}"
    files: "{{ files }}"
    services: "{{ services }}"
    windowsRoles: "{{ windowsRoles }}"
    windowsRegistry: "{{ windowsRegistry}}"
    windowsUpdates: "{{ windowsUpdates }}"
    instanceDetailedInformation: "{{ instanceDetailedInformation }}"
    customInventory: "{{ customInventory }}"
```

------
#### [ JSON ]

```
{
   "mainSteps":[
      {
         "action":"aws:softwareInventory",
         "name":"collectSoftwareInventoryItems",
         "inputs":{
            "applications":"{{ applications }}",
            "awsComponents":"{{ awsComponents }}",
            "networkConfig":"{{ networkConfig }}",
            "files":"{{ files }}",
            "services":"{{ services }}",
            "windowsRoles":"{{ windowsRoles }}",
            "windowsRegistry":"{{ windowsRegistry}}",
            "windowsUpdates":"{{ windowsUpdates }}",
            "instanceDetailedInformation":"{{ instanceDetailedInformation }}",
            "customInventory":"{{ customInventory }}"
         }
      }
   ]
}
```

------

### Inputs
<a name="softwareinventory-properties"></a>

**applications**  
(Facoltativo) Consente di raccogliere i metadati per le applicazioni installate.  
▬Tipo: stringa  
Obbligatorio: no

**awsComponents**  
(Facoltativo) Raccogli i metadati per AWS componenti come amazon-ssm-agent.  
▬Tipo: stringa  
Obbligatorio: no

**files**  
(Facoltativo, richiede la versione di SSM Agent 2.2.64.0 o successiva) Consente di raccogliere i metadati dei file, tra cui nomi, data e ora di creazione, data e ora dell'ultimo accesso e aggiornamento, e dimensioni, per citarne alcuni. Per ulteriori informazioni sulla raccolta dell'inventario dei file, consulta [Utilizzo dell'inventario dei file e del registro di sistema di Windows](inventory-file-and-registry.md).  
▬Tipo: stringa  
Obbligatorio: no

**networkConfig**  
(Facoltativo) Consente di raccogliere i metadati relativi alle configurazioni di rete.  
▬Tipo: stringa  
Obbligatorio: no

**billingInfo**  
(Facoltativo) Raccogli i metadati per i dettagli della piattaforma associati al codice di fatturazione di AMI.  
▬Tipo: stringa  
Obbligatorio: no

**windowsUpdates**  
(Facoltativo) Consente di raccogliere i metadati per tutti gli aggiornamenti di Windows.  
▬Tipo: stringa  
Obbligatorio: no

**istanza DetailedInformation**  
(Facoltativo) Consente di raccogliere ulteriori informazioni sulle istanze rispetto a quelle fornite dal plugin dell'inventario predefinito (`aws:instanceInformation`), tra cui ad esempio il modello della CPU, la velocità e il numero di core.  
▬Tipo: stringa  
Obbligatorio: no

**services**  
(Facoltativo, solo sistema operativo Windows, richiede SSM Agent versione 2.2.64.0 o successiva) Consente di raccogliere i metadati per le configurazioni dei servizi.  
▬Tipo: stringa  
Obbligatorio: no

**windowsRegistry**  
(Facoltativo, solo sistema operativo Windows, richiede SSM Agent versione 2.2.64.0 o successiva) Consente di raccogliere chiavi e valori del registro di Windows. È possibile scegliere un percorso chiave e raccogliere tutte le chiavi e i valori in modo ricorsivo. È possibile inoltre raccogliere una determinata chiave di registro e il relativo valore per un percorso specifico. Inventory raccoglie il percorso, il nome, il tipo e il valore delle chiave. Per ulteriori informazioni sulla raccolta dell'inventario del Registro di sistema di Windows, consulta [Utilizzo dell'inventario dei file e del registro di sistema di Windows](inventory-file-and-registry.md).  
▬Tipo: stringa  
Obbligatorio: no

**windowsRoles**  
(Facoltativo, solo sistema operativo Windows, richiede SSM Agent versione 2.2.64.0 o successiva) Consente di raccogliere i metadati per le configurazioni dei ruoli Microsoft Windows.  
▬Tipo: stringa  
Obbligatorio: no

**customInventory**  
(Facoltativo) Consente di raccogliere i dati dell'inventario personalizzato. Per ulteriori informazioni sull'inventario personalizzato, consulta [Utilizzo di inventari personalizzati](inventory-custom.md)  
▬Tipo: stringa  
Obbligatorio: no

**personalizzato InventoryDirectory**  
(Facoltativo) Raccogli dati di inventario personalizzati dalla directory specificata. Per ulteriori informazioni sull'inventario personalizzato, consulta [Utilizzo di inventari personalizzati](inventory-custom.md)  
▬Tipo: stringa  
Obbligatorio: no

## `aws:updateAgent`
<a name="aws-updateagent"></a>

Aggiorna il servizio EC2Config alla versione più recente o specifica una versione precedente. Questo plugin funziona solo sui sistemi operativi Microsoft Windows Server. Per ulteriori informazioni sul servizio EC2Config, consulta la sezione [Configurazione di un'istanza Windows utilizzando il servizio EC2Config (legacy)](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2config-service.html) nella *Guida per l'utente di Amazon EC2*.

### Sintassi
<a name="updateagent-syntax"></a>

#### Schema 2.2
<a name="updateagent-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:updateAgent
mainSteps:
- action: aws:updateAgent
  name: updateAgent
  inputs:
    agentName: Ec2Config
    source: https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:updateAgent",
  "mainSteps": [
    {
      "action": "aws:updateAgent",
      "name": "updateAgent",
      "inputs": {
        "agentName": "Ec2Config",
        "source": "https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json"
      }
    }
  ]
}
```

------

#### Schema 1.2
<a name="updateagent-syntax-1.2"></a>

------
#### [ YAML ]

```
---
runtimeConfig:
  aws:updateAgent:
    properties:
      agentName: Ec2Config
      source: https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json
      allowDowngrade: "{{ allowDowngrade }}"
      targetVersion: "{{ version }}"
```

------
#### [ JSON ]

```
{
   "runtimeConfig":{
      "aws:updateAgent":{
         "properties":{
            "agentName":"Ec2Config",
            "source":"https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json",
            "allowDowngrade":"{{ allowDowngrade }}",
            "targetVersion":"{{ version }}"
         }
      }
   }
}
```

------

### Properties
<a name="updateagent-properties"></a>

**agentName**  
EC2Config. Questo è il nome dell'agente che esegue il servizio EC2Config.  
Tipo: stringa  
Obbligatorio: sì

**allowDowngrade**  
Consenti il downgrade del servizio EC2Config a una versione precedente. Se impostato su "false", il servizio può essere aggiornato solo a versioni più recenti (impostazione predefinita). Se impostato su "true", specifica la versione precedente.   
Tipo: Booleano  
Obbligatorio: no

**origine**  
La posizione in cui Systems Manager copia la versione di EC2Config da installare. Non puoi modificare questa posizione.  
Tipo: stringa  
Obbligatorio: sì

**targetVersion**  
Una versione specifica del servizio EC2Config da installare. Se non è specificata, il servizio verrà aggiornato alla versione più recente.  
▬Tipo: stringa  
Obbligatorio: no

## `aws:updateSsmAgent`
<a name="aws-updatessmagent"></a>

Aggiorna SSM Agent alla versione più recente o specifica una versione precedente. Questo plugin funziona su Linux e sistemi operativi Windows Server. Per ulteriori informazioni, consulta [Utilizzo di SSM Agent](ssm-agent.md). 

### Sintassi
<a name="updateSSMagent-syntax"></a>

#### Schema 2.2
<a name="updateaSSMgent-syntax-2.2"></a>

------
#### [ YAML ]

```
---
schemaVersion: '2.2'
description: aws:updateSsmAgent
parameters:
  allowDowngrade:
    default: 'false'
    description: "(Optional) Allow the Amazon SSM Agent service to be downgraded to
      an earlier version. If set to false, the service can be upgraded to newer versions
      only (default). If set to true, specify the earlier version."
    type: String
    allowedValues:
    - 'true'
    - 'false'
mainSteps:
- action: aws:updateSsmAgent
  name: updateSSMAgent
  inputs:
    agentName: amazon-ssm-agent
    source: https://s3.{Region}.amazonaws.com/amazon-ssm-{Region}/ssm-agent-manifest.json
    allowDowngrade: "{{ allowDowngrade }}"
```

------
#### [ JSON ]

```
{
  "schemaVersion": "2.2",
  "description": "aws:updateSsmAgent",
  "parameters": {
    "allowDowngrade": {
      "default": "false",
      "description": "(Required) Allow the Amazon SSM Agent service to be downgraded to an earlier version. If set to false, the service can be upgraded to newer versions only (default). If set to true, specify the earlier version.",
      "type": "String",
      "allowedValues": [
        "true",
        "false"
      ]
    }
  },
  "mainSteps": [
    {
      "action": "aws:updateSsmAgent",
      "name": "awsupdateSsmAgent",
      "inputs": {
        "agentName": "amazon-ssm-agent",
        "source": "https://s3.{Region}.amazonaws.com/amazon-ssm-{Region}/ssm-agent-manifest.json",
        "allowDowngrade": "{{ allowDowngrade }}"
      }
    }
  ]
}
```

------

#### Schema 1.2
<a name="updateaSSMgent-syntax-1.2"></a>

------
#### [ YAML ]

```
---
runtimeConfig:
  aws:updateSsmAgent:
    properties:
    - agentName: amazon-ssm-agent
      source: https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json
      allowDowngrade: "{{ allowDowngrade }}"
```

------
#### [ JSON ]

```
{
   "runtimeConfig":{
      "aws:updateSsmAgent":{
         "properties":[
            {
               "agentName":"amazon-ssm-agent",
               "source":"https://s3.{Region}.amazonaws.com/aws-ssm-{Region}/manifest.json",
               "allowDowngrade":"{{ allowDowngrade }}"
            }
         ]
      }
   }
}
```

------

### Properties
<a name="updateSSMagent-properties"></a>

**agentName**  
amazon-ssm-agent. Questo è il nome dell'agente Systems Manager che elabora le richieste ed esegue i comandi nell'istanza.  
Tipo: stringa  
Obbligatorio: sì

**allowDowngrade**  
Consenti il downgrade di SSM Agent a una versione precedente. Se impostato su "false", l'agente può essere aggiornato solo a versioni più recenti (impostazione predefinita). Se impostato su "true", specifica la versione precedente.   
Tipo: Booleano  
Obbligatorio: sì

**origine**  
La posizione in cui Systems Manager copia la versione di SSM Agent da installare. Non puoi modificare questa posizione.  
Tipo: stringa  
Obbligatorio: sì

**targetVersion**  
Una versione specifica di SSM Agent da installare. Se non è specificata, l'agente verrà aggiornato alla versione più recente.  
▬Tipo: stringa  
Obbligatorio: no