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

# Greengrass CLI
<a name="greengrass-cli-component"></a>

Il componente Greengrass CLI (`aws.greengrass.Cli`) fornisce un'interfaccia a riga di comando locale che è possibile utilizzare sui dispositivi principali per sviluppare ed eseguire il debug dei componenti localmente. La CLI Greengrass consente, ad esempio, di creare distribuzioni locali e riavviare i componenti sul dispositivo principale.

È possibile installare questo componente quando si installa il software Core. AWS IoT Greengrass Per ulteriori informazioni, consulta [Tutorial: Guida introduttiva a AWS IoT Greengrass V2](getting-started.md).

**Importante**  
 <a name="local-dev-tools-production-environment-warning"></a>Si consiglia di utilizzare questo componente solo in ambienti di sviluppo, non in ambienti di produzione. Questo componente fornisce l'accesso a informazioni e operazioni che in genere non sono necessarie in un ambiente di produzione. Segui il principio del privilegio minimo distribuendo questo componente solo sui dispositivi principali dove ne hai bisogno. 

Dopo aver installato questo componente, esegui il comando seguente per visualizzarne la documentazione di aiuto. Quando questo componente viene installato, aggiunge un collegamento simbolico alla `greengrass-cli` `/greengrass/v2/bin` cartella. È possibile eseguire la CLI Greengrass da questo percorso o aggiungerla alla variabile di `PATH` ambiente per eseguirla `greengrass-cli` senza il percorso assoluto.

------
#### [ Linux or Unix ]

```
/greengrass/v2/bin/greengrass-cli help
```

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

```
C:\greengrass\v2\bin\greengrass-cli help
```

------

Il comando seguente riavvia un componente denominato`com.example.HelloWorld`, ad esempio.

------
#### [ Linux or Unix ]

```
sudo /greengrass/v2/bin/greengrass-cli component restart --names "com.example.HelloWorld"
```

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

```
C:\greengrass\v2\bin\greengrass-cli component restart --names "com.example.HelloWorld"
```

------

Per ulteriori informazioni, consulta [Interfaccia a riga di comando Greengrass](gg-cli.md).

**Topics**
+ [Versioni](#greengrass-cli-component-versions)
+ [Tipo](#greengrass-cli-component-type)
+ [Sistema operativo](#greengrass-cli-component-os-support)
+ [Requisiti](#greengrass-cli-component-requirements)
+ [Dipendenze](#greengrass-cli-component-dependencies)
+ [Configurazione](#greengrass-cli-component-configuration)
+ [File di registro locale](#greengrass-cli-component-log-file)
+ [Changelog](#greengrass-cli-component-changelog)

## Versioni
<a name="greengrass-cli-component-versions"></a>

Questo componente ha le seguenti versioni:
+ 2.16.x
+ 2.15x
+ 2.14x
+ 2.13x
+ 2.12x
+ 2.11. x
+ 2.10.x
+ 2.9.x
+ 2.8.x
+ 2.7.x
+ 2.6.x
+ 2,5. x
+ 2.4.x
+ 2.3.x
+ 2.2.x
+ 2.1.x
+ 2.0.x

## Tipo
<a name="greengrass-cli-component-type"></a>

<a name="public-component-type-plugin-para1"></a>Questo componente è un componente del plugin ()`aws.greengrass.plugin`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue questo componente nella stessa Java Virtual Machine (JVM) del nucleo. Il nucleo si riavvia quando si modifica la versione di questo componente sul dispositivo principale.

<a name="public-component-type-plugin-para2"></a>Questo componente utilizza lo stesso file di registro del nucleo Greengrass. Per ulteriori informazioni, consulta [Monitora AWS IoT Greengrass i registri](monitor-logs.md).

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="greengrass-cli-component-os-support"></a>

Questo componente può essere installato su dispositivi principali che eseguono i seguenti sistemi operativi:
+ Linux
+ Windows

## Requisiti
<a name="greengrass-cli-component-requirements"></a>

Questo componente presenta i seguenti requisiti:
+ <a name="greengrass-cli-authorization-requirement"></a>È necessario essere autorizzati a utilizzare la CLI Greengrass per interagire con il software Core. AWS IoT Greengrass Effettuate una delle seguenti operazioni per utilizzare la Greengrass CLI:
  + Utilizzate l'utente di sistema che esegue il software AWS IoT Greengrass Core.
  + Usa un utente con autorizzazioni root o amministrative. Sui dispositivi principali di Linux, puoi utilizzarlo per ottenere i permessi `sudo` di root.
  + Usa un utente di sistema che fa parte di un gruppo specificato nei parametri di `AuthorizedWindowsGroups` configurazione `AuthorizedPosixGroups` o quando distribuisci il componente. Per ulteriori informazioni, consulta Configurazione dei componenti della [CLI di Greengrass](#greengrass-cli-component-configuration).
+ Il componente Greengrass CLI è supportato per l'esecuzione in un VPC.

## Dipendenze
<a name="greengrass-cli-component-dependencies"></a>

Quando si distribuisce un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#greengrass-cli-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

------
#### [ 2.16.0 ]

La tabella seguente elenca le dipendenze per la versione 2.16.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.17.0 | Flessibili | 

------
#### [ 2.15.1 ]

La tabella seguente elenca le dipendenze per la versione 2.15.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Flessibili | 

------
#### [ 2.15.0 ]

La tabella seguente elenca le dipendenze per la versione 2.15.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.16.0 | Flessibili | 

------
#### [ 2.14.0 – 2.14.3 ]

La tabella seguente elenca le dipendenze per le versioni 2.14.0 e 2.14.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.15.0 | Flessibili | 

------
#### [ 2.13.0 ]

La tabella seguente elenca le dipendenze per la versione 2.13.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.14.0 | Flessibili | 

------
#### [ 2.12.0 – 2.12.6 ]

La tabella seguente elenca le dipendenze per le versioni da 2.12.0 a 2.12.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.12.0 <2.13.0 | Flessibili | 

------
#### [ 2.11.0 – 2.11.3 ]

La tabella seguente elenca le dipendenze per le versioni da 2.11.0 a 2.11.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.11.0 <2.12.0 | Flessibili | 

------
#### [ 2.10.0 – 2.10.3 ]

La tabella seguente elenca le dipendenze per le versioni da 2.10.0 a 2.10.3 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.11.0 | Flessibili | 

------
#### [ 2.9.0 – 2.9.6 ]

La tabella seguente elenca le dipendenze per le versioni da 2.9.0 a 2.9.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.10.0 | Flessibili | 

------
#### [ 2.8.0 – 2.8.1 ]

La tabella seguente elenca le dipendenze per le versioni 2.8.0 e 2.8.1 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.9.0 | Flessibili | 

------
#### [ 2.7.0 ]

La tabella seguente elenca le dipendenze per la versione 2.7.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.8.0 | Flessibili | 

------
#### [ 2.6.0 ]

La tabella seguente elenca le dipendenze per la versione 2.6.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.7.0 | Flessibili | 

------
#### [ 2.5.0 – 2.5.6 ]

La tabella seguente elenca le dipendenze per le versioni da 2.5.0 a 2.5.6 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.5.0 <2.6.0 | Flessibili | 

------
#### [ 2.4.0 ]

La tabella seguente elenca le dipendenze per la versione 2.4.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.5.0 | Flessibili | 

------
#### [ 2.3.0 ]

La tabella seguente elenca le dipendenze per la versione 2.3.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.4.0 | Flessibili | 

------
#### [ 2.2.0 ]

La tabella seguente elenca le dipendenze per la versione 2.2.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.3.0 | Flessibili | 

------
#### [ 2.1.0 ]

La tabella seguente elenca le dipendenze per la versione 2.1.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.1.0 <2.2.0 | Flessibili | 

------
#### [ 2.0.x ]

La tabella seguente elenca le dipendenze per la versione 2.0.x di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Nucleo Greengrass](greengrass-nucleus-component.md) | >=2.0.0 <2.1.0 | Flessibili | 

**Nota**  
La versione minima compatibile del nucleo Greengrass corrisponde alla versione patch del componente Greengrass CLI. 

------

[Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="greengrass-cli-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

------
#### [ 2.5.x - 2.14.x ]

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. Autorizzi questi gruppi di sistema a utilizzare la CLI Greengrass per interagire con AWS IoT Greengrass il software Core. È possibile specificare nomi o gruppi di gruppi. IDs Ad esempio, `group1,1002,group3` autorizza tre gruppi di sistema (`group1``1002`, e`group3`) a utilizzare la CLI Greengrass.  
Se non specifichi alcun gruppo da autorizzare, puoi utilizzare la CLI Greengrass come `sudo` utente root () o come utente di sistema che AWS IoT Greengrass esegue il software Core.

`AuthorizedWindowsGroups`  <a name="greengrass-cli-component-configuration-authorizedwindowsgroups"></a>
(Facoltativo) Una stringa che contiene un elenco separato da virgole di gruppi di sistema. Autorizzi questi gruppi di sistema a utilizzare la CLI Greengrass per interagire con AWS IoT Greengrass il software Core. È possibile specificare nomi o gruppi di gruppi. IDs Ad esempio, `group1,1002,group3` autorizza tre gruppi di sistema (`group1``1002`, e`group3`) a utilizzare la CLI Greengrass.  
Se non specifichi alcun gruppo da autorizzare, puoi utilizzare la CLI Greengrass come amministratore o come utente di sistema che AWS IoT Greengrass esegue il software Core.

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di autorizzare tre gruppi di sistema POSIX (`group1``1002`, e`group3`) e due gruppi di utenti Windows (`Device Operators`and`QA Engineers`) a utilizzare la Greengrass CLI.  

```
{
  "AuthorizedPosixGroups": "group1,1002,group3",
  "AuthorizedWindowsGroups": "Device Operators,QA Engineers"
}
```

------
#### [ 2.4.x - 2.0.x ]

`AuthorizedPosixGroups`  <a name="greengrass-cli-component-configuration-authorizedposixgroups"></a>
(Facoltativo) Una stringa che contiene un elenco di gruppi di sistema separati da virgole. Autorizzi questi gruppi di sistema a utilizzare la CLI Greengrass per interagire con AWS IoT Greengrass il software Core. È possibile specificare nomi o gruppi di gruppi. IDs Ad esempio, `group1,1002,group3` autorizza tre gruppi di sistema (`group1``1002`, e`group3`) a utilizzare la CLI Greengrass.  
Se non specifichi alcun gruppo da autorizzare, puoi utilizzare la CLI Greengrass come `sudo` utente root () o come utente di sistema che AWS IoT Greengrass esegue il software Core.

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica di autorizzare tre gruppi di sistema (`group1``1002`, e`group3`) a utilizzare la Greengrass CLI.  

```
{
  "AuthorizedPosixGroups": "group1,1002,group3"
}
```

------

## File di registro locale
<a name="greengrass-cli-component-log-file"></a>

Questo componente utilizza lo stesso file di registro del componente [Greengrass nucleus](greengrass-nucleus-component.md).

------
#### [ Linux ]

```
/greengrass/v2/logs/greengrass.log
```

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

```
C:\greengrass\v2\logs\greengrass.log
```

------

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` o *C:\$1greengrass\$1v2* con il percorso della cartella AWS IoT Greengrass principale.

------
#### [ Linux ]

  ```
  sudo tail -f /greengrass/v2/logs/greengrass.log
  ```

------
#### [ Windows (PowerShell) ]

  ```
  Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait
  ```

------

## Changelog
<a name="greengrass-cli-component-changelog"></a>

La tabella seguente descrive le modifiche in ogni versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  2.16.1  |  Versione aggiornata per la versione 2.16.1 di Greengrass nucleus.  | 
|  2.16.0  |  Versione aggiornata per la versione 2.16.0 di Greengrass nucleus.  | 
|  2.15.1  |  Versione aggiornata per la versione 2.15.1 di Greengrass nucleus.  | 
|  2.15.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.14.3  |  Versione aggiornata per la versione 2.14.3 di Greengrass nucleus.  | 
|  2.14.2  |  Versione aggiornata per la versione 2.14.2 di Greengrass nucleus.  | 
|  2.14.1  |  Versione aggiornata per la versione 2.14.1 di Greengrass nucleus.  | 
|  2.14.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.13.0  |  Versione aggiornata per la versione 2.13.0 di Greengrass nucleus.  | 
|  2.12.6  |  Versione aggiornata per la versione 2.12.6 di Greengrass nucleus.  | 
|  2.12.5  |  Versione aggiornata per la versione 2.12.5 di Greengrass nucleus.  | 
|  2.12.4  |  Versione aggiornata per la versione 2.12.4 di Greengrass nucleus.  | 
|  2.12.3  |   Questa versione non è più disponibile. I miglioramenti di questa versione sono disponibili nelle versioni successive di questo componente.  Versione aggiornata per la versione 2.12.3 di Greengrass nucleus.  | 
|  2.12.2  |  Versione aggiornata per la versione 2.12.2 di Greengrass nucleus.  | 
|  2.12.1  |  Versione aggiornata per la versione 2.12.1 di Greengrass nucleus.  | 
|  2.12.0  |  Versione aggiornata per la versione 2.12.0 di Greengrass nucleus.  | 
|  2.11.3  |  Versione aggiornata per la versione 2.11.3 di Greengrass nucleus.  | 
|  2.11.2  |  Versione aggiornata per la versione 2.11.2 di Greengrass nucleus.  | 
|  2.11.1  |  Versione aggiornata per la versione 2.11.1 di Greengrass nucleus.  | 
|  2.11.0  |  <a name="changelog-cli-2.11.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.10.3  |  Versione aggiornata per la versione 2.10.3 di Greengrass nucleus.  | 
|  2.10.2  |  Versione aggiornata per la versione 2.10.2 di Greengrass nucleus.  | 
|  2.10.1  |  Versione aggiornata per la versione 2.10.1 di Greengrass nucleus.  | 
|  2.10.0  |  Versione aggiornata per la versione 2.10.0 di Greengrass nucleus.  | 
|  2.9.6  |  Versione aggiornata per la versione 2.9.6 di Greengrass nucleus.  | 
|  2.9.5  |  Versione aggiornata per la versione 2.9.5 di Greengrass nucleus.  | 
|  2.9.4  |  Versione aggiornata per la versione 2.9.4 di Greengrass nucleus.  | 
|  2.9.3  |  Versione aggiornata per la versione 2.9.3 di Greengrass nucleus.  | 
|  2.9.2  |  Versione aggiornata per la versione 2.9.2 di Greengrass nucleus.  | 
|  2.9.1  |  Versione aggiornata per la versione 2.9.1 di Greengrass nucleus.  | 
|  2.9.0  | Versione aggiornata per la versione 2.9.0 di Greengrass nucleus. | 
|  2.8.1  |  Versione aggiornata per la versione 2.8.1 di Greengrass nucleus.  | 
|  2.8.0  | Versione aggiornata per la versione 2.8.0 di Greengrass nucleus. | 
|  2.7.0  |  Versione aggiornata per la versione 2.7.0 di Greengrass nucleus.  | 
|  2.6.0  |  <a name="changelog-greengrass-cli-2.6.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.5.6  |  Versione aggiornata per la versione 2.5.6 di Greengrass nucleus.  | 
|  2.5.5  |  Versione aggiornata per la versione 2.5.5 di Greengrass nucleus.  | 
|  2.5.4  |  Versione aggiornata per la versione 2.5.4 di Greengrass nucleus.  | 
|  2.5.3  |  Versione aggiornata per la versione 2.5.3 di Greengrass nucleus.  | 
|  2.5.2  |  Versione aggiornata per la versione 2.5.2 di Greengrass nucleus.  | 
|  2.5.1  |  Versione aggiornata per la versione 2.5.1 di Greengrass nucleus.  | 
|  2.5.0  |  <a name="changelog-greengrass-cli-2.5.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.4.0  |  <a name="changelog-greengrass-cli-2.4.0"></a>[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/greengrass-cli-component.html)  | 
|  2.3.0  |  Versione aggiornata per la versione 2.3.0 di Greengrass nucleus.  | 
|  2.2.0  |  Versione aggiornata per la versione 2.2.0 di Greengrass nucleus.  | 
|  2.1.0  |  Versione aggiornata per la versione 2.1.0 di Greengrass nucleus.  | 
|  2.0.5  | Versione aggiornata per la versione 2.0.5 di Greengrass nucleus. | 
|  2.0.4  | Versione aggiornata per la versione 2.0.4 di Greengrass nucleus. | 
|  2.0.3  |  Versione iniziale.  |