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 `StartAutomationExecution` con una CLI
<a name="example_ssm_StartAutomationExecution_section"></a>

I seguenti esempi di codice mostrano come usare `StartAutomationExecution`.

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

**AWS CLI**  
**Esempio 1: per eseguire un documento di automazione**  
L’esempio seguente `start-automation-execution` esegue un documento di automazione.  

```
aws ssm start-automation-execution \
    --document-name {{"AWS-UpdateLinuxAmi"}} \
    --parameters {{"AutomationAssumeRole=arn:aws:iam::123456789012:role/SSMAutomationRole,SourceAmiId=ami-EXAMPLE,IamInstanceProfileName=EC2InstanceRole"}}
```
Output:  

```
{
    "AutomationExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Per ulteriori informazioni, consulta [Esecuzione manuale di un flusso di lavoro di automazione](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing-manually.html) nella *Guida per l’utente di AWS Systems Manager*.  
**Esempio 2: come eseguire un documento di automazione condiviso**  
L’esempio seguente `start-automation-execution` esegue un documento di automazione condiviso.  

```
aws ssm start-automation-execution \
    --document-name {{"arn:aws:ssm:us-west-2:123456789012:document/ExampleDocument"}}
```
Output:  

```
{
    "AutomationExecutionId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}
```
Per ulteriori informazioni, consulta [Utilizzo di documenti condivisi SSM](https://docs.aws.amazon.com/systems-manager/latest/userguide/ssm-using-shared.html) nella *Guida per l'utente di AWS Systems Manager*.  
+  Per i dettagli sull'API, consulta [StartAutomationExecution](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/start-automation-execution.html) nel *AWS CLI Riferimento al comando*. 

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

**Strumenti per PowerShell V4**  
**Esempio 1: questo esempio esegue un documento che specifica un ruolo di automazione, un ID di origine AMI e un ruolo di istanza Amazon EC2.**  

```
Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}
```
**Output:**  

```
3a532a4f-0382-11e7-9df7-6f11185f6dd1
```
+  Per i dettagli sull'API, vedi [StartAutomationExecution](https://docs.aws.amazon.com/powershell/v4/reference) nel *AWS Strumenti per PowerShell Riferimento al cmdlet (V4)*. 

**Strumenti per PowerShell V5**  
**Esempio 1: questo esempio esegue un documento che specifica un ruolo di automazione, un ID di origine AMI e un ruolo di istanza Amazon EC2.**  

```
Start-SSMAutomationExecution -DocumentName AWS-UpdateLinuxAmi -Parameter @{'AutomationAssumeRole'='arn:aws:iam::123456789012:role/SSMAutomationRole';'SourceAmiId'='ami-f173cc91';'InstanceIamRole'='EC2InstanceRole'}
```
**Output:**  

```
3a532a4f-0382-11e7-9df7-6f11185f6dd1
```
+  Per i dettagli sull'API, vedi [StartAutomationExecution](https://docs.aws.amazon.com/powershell/v5/reference) nel *AWS Strumenti per PowerShell Riferimento al cmdlet (V5)*. 

------

Per un elenco completo di AWS Guide per sviluppatori SDK ed esempi di codice, consulta [L'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.