device, devdevice, dev

Gestisce i dispositivi di Azure Sphere.Manages Azure Sphere devices.

OperazioneOperation DescrizioneDescription
appapp Modifica lo stato delle applicazioni in un dispositivo.Changes the status of applications on a device.
capability, capcapability, cap Gestisce le funzionalità del dispositivo.Manages device capabilities.
certificate, certcertificate, cert Gestisce l'archivio certificati del dispositivo.Manages device certificate store.
claimclaim Attesta un dispositivo precedentemente non recuperato al tenant Azure Sphere.Claims a previously unclaimed device to the Azure Sphere tenant.
enable-cloud-test, ectenable-cloud-test, ect Configura un dispositivo per disabilitare il debug e ricevere gli aggiornamenti.Sets up a device to disable debugging and receive updates.
enable-development, edvenable-development, edv Configura un dispositivo per il debug locale.Sets up a device for local debugging.
image, imgimage, img Gestisce le immagini per un dispositivo.Manages images for a device.
listlist Visualizza tutti i dispositivi nel tenant.Displays all devices in the tenant.
list-attachedlist-attached Elenca i dispositivi collegati.Lists the attached devices.
manufacturing-state, mfgmanufacturing-state, mfg Gestisce lo stato di produzione del dispositivo collegato.Manages the manufacturing state of the attached device.
retenetwork Fornisce informazioni sullo stato delle interfacce di rete nel dispositivo.Provides information about the status of network interfaces on the device.
recoverrecover Usa la modalità di ripristino speciale per caricare nuovo firmware nel dispositivo.Uses special recovery mode to load new firmware onto the device.
ripetizione dell'analisi: collegata, rarescan-attached, ra Analizza nuovamente i dispositivi collegati come supporto per la risoluzione dei problemi (solo Windows).Rescans attached devices as a troubleshooting aid (Windows only).
restartrestart Riavvia il dispositivo collegato.Restarts the attached device.
showshow Visualizza i dettagli sulla configurazione di aggiornamento del dispositivo.Displays details about the update configuration of the device.
show-attachedshow-attached Visualizza i dettagli sul dispositivo collegato dal dispositivo stesso.Displays details about the attached device from the device itself.
show-countshow-count Mostra il numero totale di dispositivi in un tenant.Shows the total number of devices in a tenant.
show-deployment-statusshow-deployment-status Visualizza lo stato dell'aggiornamento più recente della distribuzione.Displays the status of the most recent deployment update.
show-os-versionshow-os-version Visualizza la versione del sistema operativo del dispositivo locale.Displays the local device operating system version.
sideload, slsideload, sl Carica un'immagine sul dispositivo collegato.Loads an image onto the attached device.
updateupdate Aggiorna un dispositivo inserendolo in un gruppo di dispositivi specifico.Updates a device by placing it in a specific device group.
wifiwifi Gestisce la configurazione Wi-Fi per il dispositivo.Manages the Wi-Fi configuration for the device.

appapp

Gestisce le applicazioni nel dispositivoManages applications on the device

Molte delle opzioni dell'app richiedono la funzionalità appDevelopment , che può essere acquisita usando il dispositivo azsphere Enable-Development.Many of the app options require the appDevelopment capability, which can be acquired by using azsphere device enable-development. Per avviare, arrestare o eseguire il debug di un'applicazione con firma SDK o di produzione, il dispositivo deve essere dotato della funzionalità appDevelopment.To start, stop, or debug an SDK-signed application or a production-signed application, the device must have the appDevelopment capability.

È possibile usare azsphere Device app stop e azsphere Device app start per riavviare un'applicazione in esecuzione in tempo reale in grado di determinare il core in tempo reale in cui è in esecuzione.You can use azsphere device app stop and azsphere device app start to restart a running real-time capable application to determine which real-time core it is running on.

OperazioneOperation DescrizioneDescription
show-quotashow-quota Visualizza la quantità di spazio di archiviazione usato dall'applicazione corrente nel dispositivo.Displays the amount of storage used by the current application on the device.
show-statusshow-status Restituisce lo stato dell'applicazione corrente nel dispositivo.Returns the status of the current application on the device.
startstart Avvia l'applicazione caricata nel dispositivo.Starts the application that is loaded on the device.
stopstop Arresta l'applicazione in esecuzione nel dispositivo.Stops the application that is running on the device.

app show-quotaapp show-quota

Visualizza la quantità di spazio di archiviazione modificabile allocato e in uso nel dispositivo connesso.Displays the amount of mutable storage allocated and in use on the attached device.

È possibile impostare la quota di archiviazione modificabile nel manifesto dell'applicazionee il sistema operativo Azure Sphere impone le quote quando alloca i settori per il file.You set the mutable storage quota in the application manifest, and the Azure Sphere OS enforces quotas when it allocates sectors for the file. Di conseguenza, se si riduce il valore di MutableStorage, la quantità di spazio di archiviazione in uso non cambia, ma il valore segnalato per l'allocazione sarà diverso.As a result, if you decrease the MutableStorage value, the amount of storage in use will not change, but the allocated value reported will be different. Se ad esempio l'applicazione ha già usato 16 KB e il valore di MutableStorage viene impostato su 8, il comando segnala che l'applicazione usa 16 KB degli 8 KB allocati.For example, if the application has already used 16 KB and you change the MutableStorage value to 8, the command reports that the application uses 16 KB of 8 KB allocated. I dati rimangono nel dispositivo.The data remains on the device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ComponentID-i, --componentid GUIDGUID Specifica l'ID del componente per visualizzare lo stato.Specifies the ID of the component for which to display status. Se omesso, mostra lo stato di tutti i componenti.If omitted, shows status of all components. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--Component-ID-i, --component-id GUIDGUID Specifica l'ID del componente per visualizzare lo stato.Specifies the ID of the component for which to display status. Se omesso, mostra lo stato di tutti i componenti.If omitted, shows status of all components. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device app show-quota
ae4714aa-03aa-492b-9663-962f966a9cc3: 0KB out of 8KB of mutable storage used.

app show-statusapp show-status

Restituisce lo stato corrente delle applicazioni nel dispositivo.Displays the current status of the applications on the device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ComponentID-i, --componentid GUIDGUID Specifica l'ID del componente per visualizzare lo stato.Specifies the ID of the component for which to display status. Se omesso, mostra lo stato di tutti i componenti.If omitted, shows status of all components. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--Component-ID-i, --component-id GUIDGUID Specifica l'ID del componente per visualizzare lo stato.Specifies the ID of the component for which to display status. Se omesso, mostra lo stato di tutti i componenti.If omitted, shows status of all components. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device app show-status
9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
App state: running

app startapp start

Avvia le applicazioni nel dispositivo.Starts applications on the device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-d, --debug-d, --debug - Avvia l'applicazione per eseguire il debug.Starts the application for debugging. --componentidÈ necessario fornire il.The --componentid must be provided. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--ComponentID-i, --componentid GUIDGUID Specifica l'ID del componente da avviare.Specifies the ID of the component to start. Se omesso, avvia tutte le applicazioni.If omitted, starts all applications. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
--debug-mode--debug-mode - Avvia l'applicazione per eseguire il debug.Starts the application for debugging. È necessario specificare '--Component-ID '.The '--component-id' must be provided. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-i,--Component-ID-i, --component-id GUIDGUID Specifica l'ID del componente da avviare.Specifies the ID of the component to start. Se omesso, avvia tutte le applicazioni.If omitted, starts all applications. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device app start
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: running
Core     : High-level

app stopapp stop

Arresta le applicazioni nel dispositivo.Stops the applications on the device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ComponentID-i, --componentid GUIDGUID Specifica l'ID del componente da arrestare.Specifies the ID of the component to stop. Se omesso, arresta tutte le applicazioni.If omitted, stops all applications. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--Component-ID-i, --component-id GUIDGUID Specifica l'ID del componente da arrestare.Specifies the ID of the component to stop. Se omesso, arresta tutte le applicazioni.If omitted, stops all applications. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device app stop
836cbcf1-0b4d-45ab-963a-eadcd5017b6a
App state: stopped

capability, capcapability, cap

Gestisce le funzionalità del dispositivo.Manages device capabilities. Le funzionalità di dispositivo determinano le operazioni che possono essere eseguite in un singolo dispositivo Azure Sphere.Device capabilities determine the operations that can be performed on an individual Azure Sphere device.

Le funzionalità del dispositivo vengono scaricate come file dal servizio di sicurezza Azure Sphere usando il comando di download della funzionalità del dispositivo azsphere , la configurazione della funzionalità del dispositivo può essere applicata al dispositivo Azure Sphere collegato usando il comando di aggiornamento della funzionalità del dispositivo azsphere ed è possibile creare una sessione di manutenzione usando il comando di selezione della funzionalità del dispositivo azsphere .The device capabilities are downloaded as a file from the Azure Sphere Security Service using the azsphere device capability download command, device capability configuration can be applied to the attached Azure Sphere device using the azsphere device capability update command, and a servicing session can be created using the azsphere device capability select command. Per altre informazioni sulle funzionalità del dispositivo, vedere funzionalità e comunicazione del dispositivo.For more information on device capabilities, see Device capabilities and communication.

OperazioneOperation DescrizioneDescription
downloaddownload Scarica una configurazione della funzionalità del dispositivo dal servizio di sicurezza Azure Sphere.Downloads a device capability configuration from the Azure Sphere Security Service.
selectselect Seleziona un file di capacità scaricato da usare per una sessione di manutenzione.Selects a downloaded capability file to use for a servicing session.
show-attachedshow-attached Visualizza la configurazione delle funzionalità per il dispositivo collegato.Displays the capability configuration for the attached device.
updateupdate Applica una configurazione delle funzionalità al dispositivo collegato.Applies a device capability configuration to the attached device.

Download di funzionalitàcapability download

Scarica una funzionalità di dispositivo dal servizio di sicurezza di Azure Sphere.Downloads a device capability from the Azure Sphere Security Service.

La funzionalità appDevelopment consente di sideload applicazioni con firma SDK e di avviare, arrestare, eseguire il debug o eliminare qualsiasi applicazione nel dispositivo.The appDevelopment capability lets you sideload SDK-signed applications and start, stop, debug, or delete any application on the device. Senza la funzionalità appDevelopment è possibile caricare solo le applicazioni caricate sul cloud, mentre l'avvio, l'arresto, l'esecuzione del debug e l'eliminazione non sono consentiti.Without the appDevelopment capability, only cloud-loaded applications can be loaded and start, stop, debug, and delete are prohibited. La funzionalità appDevelopment viene applicata come parte del comando Enable-Development del dispositivo azsphere .The appDevelopment capability is applied as part of the azsphere device enable-development command.

Il download della funzionalità fieldServicing genera un file contenente la funzionalità per un singolo dispositivo Azure Sphere.Downloading the fieldServicing capability results in a file containing the capability for a single Azure Sphere device. Il file della funzionalità fieldServicing viene scaricato nel computer locale e può essere usato in combinazione con il comando di selezione della funzionalità del dispositivo azsphere .The fieldServicing capability file is downloaded to your local computer and can be used in conjunction with the azsphere device capability select command.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
--tipo--type Tipo di funzionalitàCapability-type Specifica il tipo di funzionalità del dispositivo da scaricare.Specifies the type of device capability to download. I valori sono appDevelopment, fieldServicing o None.Values are appDevelopment, fieldServicing, or none. Usare None per rimuovere la funzionalità appDevelopment o la funzionalità fieldServicing.Use none to remove the appDevelopment capability or the fieldServicing capability. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-p, --apply-p, --apply - Applica la configurazione delle funzionalità di dispositivo al dispositivo collegato.Applies the device capability configuration to the attached device. Non usare con --deviceid o con --output.Do not use with --deviceid or --output. -Azure Sphere CLI V1- Azure Sphere CLI v1
-s,--Select-s, --select - Seleziona temporaneamente la configurazione della funzionalità del dispositivo collegata.Temporarily selects the device capability configuration for the attached device. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--DeviceID-i, --deviceid IDID Specifica l'ID del dispositivo per cui ottenere la configurazione delle funzionalità.Specifies the ID of the device for which to get the capability configuration. Se si specifica l'ID di un dispositivo, è necessario usare anche il parametro --output.If you specify a device ID, you must also use --output. Se omesso, si ottiene una funzionalità per il dispositivo collegato.If omitted, gets a capability for the attached device. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-o, --output-o, --output stringString Specifica il percorso e il nome file in cui salvare la configurazione delle funzionalità.Specifies the path and filename at which to save the capability configuration. Specificare un percorso assoluto o relativo.Include an absolute or relative path. Se non si specifica un percorso, il comando Archivia il file nella directory locale usando il <capability type> - <first eight characters of device ID> . limite di convenzione di denominazione.If you do not provide a path, the command will store the file in the local directory using the naming convention <capability type>-<first eight characters of device ID>.cap. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo da usare in questo comando quando sono collegati più dispositivi.Specifies the device to use in this command when multiple devices are attached. Usa il dispositivo attualmente collegato per impostazione predefinita.Uses the currently attached device by default. È possibile specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato.You can either specify the IP address or Local Connection ID of an attached device. In alternativa, specificare un ID dispositivo, che non richiede un dispositivo collegato.Alternatively, provide a device ID, which does not require an attached device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-f,--Destination-file-f, --destination-file stringString Specifica il percorso e il nome file in cui salvare la configurazione delle funzionalità.Specifies the path and filename at which to save the capability configuration. Specificare un percorso assoluto o relativo.Include an absolute or relative path. Se non si specifica un percorso, il comando Archivia il file nella directory locale usando il <capability type> - <first eight characters of device ID> . limite di convenzione di denominazione.If you do not provide a path, the command will store the file in the local directory using the naming convention <capability type>-<first eight characters of device ID>.cap. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device capability download --type appDevelopment
Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46'
Downloading device capability configuration.
Successfully wrote device capability configuration file 'C:\capability-file\appdevelopment-<first eight characters of device ID>.cap'.

capability selectcapability select

Seleziona un file di funzionalità da usare con il dispositivo Azure Sphere collegato.Selects a capability file to use with the attached Azure Sphere device.

Il comando di selezione della funzionalità del dispositivo azsphere può essere usato con qualsiasi funzionalità, ma viene usato più spesso con la funzionalità fieldServicing per abilitare una sessione di manutenzione.The azsphere device capability select command can be used with any capability, but is most often used with the fieldServicing capability to enable a servicing session. Tutti i ruoli utente hanno accesso al comando azsphere device capability select.Any user role has access to the azsphere device capability select command.

Quando si usa la funzionalità fieldServicing, la comunicazione tra il dispositivo Azure Sphere e il computer locale che contiene il file di funzionalità è abilitata.When you use the fieldServicing capability, communication is enabled between the Azure Sphere device and the local computer containing the capability file. Il file di funzionalità fieldServicing viene usato per una sessione tra il computer locale e il dispositivo Azure Sphere e a ogni comando della sessione viene anteposto un messaggio che indica il file di funzionalità in uso.The fieldServicing capability file is used for a session between the local computer and the Azure Sphere device, and each command in the session is prepended with a message indicating the capability file in use.

Per terminare una sessione di manutenzione, usare azsphere device capability select --none.To end a servicing session, use azsphere device capability select --none.

Ogni file di funzionalità fieldServicing è univoco per un dispositivo Azure Sphere specifico.Each fieldServicing capability file is unique to a specific Azure Sphere device. Se si tenta di usare un file di funzionalità per un altro dispositivo, verrà visualizzato il messaggio seguente:If you try to use a capability file meant for another device, you will receive the following message:

error: selected capability is not compatible with device <device ID>

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-n, --none-n, --none - Cancella tutte le configurazioni di funzionalità di dispositivo selezionate in precedenza.Clears any previously selected device capability configuration. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-f,--FilePath-f, --filepath stringString Specifica il percorso e il nome file del file di configurazione della funzionalità del dispositivo da selezionare.Specifies the path and filename to the device capability configuration file to select. È possibile fornire un percorso relativo o assoluto.You may provide a relative or absolute path. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-f,--file-path-f, --file-path stringString Specifica il percorso e il nome file del file di configurazione della funzionalità del dispositivo da selezionare.Specifies the path and filename to the device capability configuration file to select. È possibile fornire un percorso relativo o assoluto.You may provide a relative or absolute path. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device capability select --filepath appdevcap
Using selected capability file 'C:\capability-file\appdevcap'.
Capability configuration has been successfully selected.

funzionalità show-attachedcapability show-attached

Visualizza la configurazione delle funzionalità archiviata nel dispositivo collegato.Displays the capability configuration stored on the attached device.

Nota

Il comando Visualizza le funzionalità configurate utilizzando un file di funzionalità e alcune, ma non tutte, le funzionalità presenti per impostazione predefinita nelle lavagne.The command displays the capabilities configured using a capability file and some, but not all, capabilities present by default on boards.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device capability show-attached
Using selected capability file: C:\capability-file\appdevcap
Device capabilities:
        Enable App development

funzionalità updatecapability update

Applica una configurazione delle funzionalità al dispositivo collegato.Applies a device capability configuration to the attached device.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-f,--FilePath-f, --filepath stringString Specifica il percorso e il nome file del file di funzionalità del dispositivo da applicare.Specifies the path and filename of the device capability file to apply. È possibile specificare un percorso relativo o assoluto.You can provide a relative or absolute path. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-f,--file-path-f, --file-path stringString Specifica il percorso e il nome file del file di funzionalità del dispositivo da applicare.Specifies the path and filename of the device capability file to apply. È possibile specificare un percorso relativo o assoluto.You can provide a relative or absolute path. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo da usare in questo comando quando sono collegati più dispositivi.Specifies the device to use in this command when multiple devices are attached. Usa il dispositivo attualmente collegato per impostazione predefinita.Uses the currently attached device by default. È possibile specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato.You can either specify the IP address or Local Connection ID of an attached device. In alternativa, specificare un ID dispositivo, che non richiede un dispositivo collegato.Alternatively, provide a device ID, which does not require an attached device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device capability update --filepath appdevcap2.bin
Applying device capability configuration to device.
The device is rebooting.

certificate, certcertificate, cert

Gestisce i certificati nel dispositivo collegato.Manages certificates on the attached device.

OperazioneOperation DescrizioneDescription
addadd Aggiunge un certificato all'archivio certificati nel dispositivo.Adds a certificate to the certificate store on the device.
deletedelete Elimina un certificato dall'archivio certificati del dispositivo.Deletes a certificate from the device's certificate store.
listlist Elenca gli ID certificato disponibili nell'archivio certificati.Lists the certificate IDs that are available in the certificate store.
showshow Visualizza i dettagli di un singolo certificato nell'archivio certificati del dispositivo.Displays details of an individual certificate in the device's certificate store.
show-quotashow-quota Visualizza lo spazio disponibile nell'archivio certificati del dispositivo.Displays the available free space in the device's certificate store.

certificate addcertificate add

Aggiunge un certificato all'archivio certificati del dispositivo collegato.Adds a certificate to the certificate store of the attached device.

Per caricare i certificati client e CA radice nel dispositivo Azure Sphere, è necessario che siano in formato PEM.The Root CA and client certificates must be in the .pem format to load onto the Azure Sphere device. Sarà necessario acquisire il certificato CA radice dal server appropriato, insieme al certificato client e alla chiave privata (e, facoltativamente, a una password per la chiave privata) per il dispositivo.You will need to acquire the Root CA certificate from the appropriate server, along with the client certificate and private key (and optionally a password for your private key) for your device. Ogni certificato deve essere generato e firmato dal server appropriato nella rete EAP-TLS.Each certificate must be generated and signed by the appropriate server in your EAP-TLS network. L'amministratore di rete o il team di sicurezza può fornire i dettagli necessari per ottenere i certificati.Your network administrator or security team can supply the details you need to get the certificates. Per ulteriori informazioni sull'acquisizione del certificato CA radice, vedere, acquisire e distribuire i certificati per le reti EAP-TLS.For more information on acquiring the Root CA certificate see, Acquire and deploy certificates for EAP-TLS networks.

Attenzione

Poiché gli ID certificato sono a livello di sistema sia per il certificato client che per il certificato CA radice, un comando azsphere o una chiamata di funzione che aggiunge un nuovo certificato può sovrascrivere un certificato aggiunto da un comando o una chiamata di funzione precedente, generando possibilmente errori di connessione di rete.Because certificate IDs are system-wide for both client and Root CA certificates, an azsphere command or a function call that adds a new certificate can overwrite a certificate that was added by an earlier command or function call, potentially causing network connection failures. È consigliabile sviluppare procedure ben definite per l'aggiornamento dei certificati e scegliere con attenzione gli ID certificato.We strongly recommend that you develop clear certificate update procedures and choose certificate IDs carefully.

Per altre informazioni, vedere ID certificato.See Certificate IDs for more information.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--CertId-i, --certid stringString Specifica un nome per il certificato da aggiungere.Specifies a name for the certificate to add. Identificatore di stringa (fino a 16 caratteri).A string identifier (up to 16 characters). I caratteri validi includono: 'A'-'Z', 'a'-'z', '0'-'9', '.' o '-' o ''.Valid characters include 'A' to 'Z', 'a' to 'z', '0' to '9', '.' or '-' or ''. Questo identificatore viene usato anche nelle configurazioni Wi-Fi per le reti EAP-TLS.This identifier is also used in Wi-Fi configurations for EAP-TLS networks. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-t,--tipo certificato-t, --certtype stringString Specifica il tipo di certificato da aggiungere, ovvero "client" o "RootCA".Specifies the type of certificate to add, either "client" or "rootca". INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-pubk, --publickeyfilepath-pubk, --publickeyfilepath stringString Specifica il percorso di un file con estensione PEM del certificato della chiave pubblica.Specifies the path to a public key certificate .pem file. È possibile specificare un percorso relativo o assoluto.You can provide a relative or absolute path. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--Cert-ID-i, --cert-id stringString Specifica un nome per il certificato da aggiungere.Specifies a name for the certificate to add. Identificatore di stringa (fino a 16 caratteri).A string identifier (up to 16 characters). I caratteri validi includono: 'A'-'Z', 'a'-'z', '0'-'9', '.' o '-' o ''.Valid characters include 'A' to 'Z', 'a' to 'z', '0' to '9', '.' or '-' or ''. Questo identificatore viene usato anche nelle configurazioni Wi-Fi per le reti EAP-TLS.This identifier is also used in Wi-Fi configurations for EAP-TLS networks. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
--Cert-type--cert-type stringString Specifica il tipo di certificato da aggiungere, ovvero "client" o "RootCA".Specifies the type of certificate to add, either "client" or "rootca". Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-p,--Public-Key-file-path-p, --public-key-file-path stringString Specifica il percorso di un file con estensione PEM del certificato della chiave pubblica.Specifies the path to a public key certificate .pem file. È possibile specificare un percorso relativo o assoluto.You can provide a relative or absolute path. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-prvk, --privatekeyfilepath-prvk, --privatekeyfilepath stringString Specifica il percorso di un file con estensione PEM del certificato della chiave privata del client.Specifies the path to a client private key certificate .pem file. Necessario quando si aggiunge un certificato di tipo "client".Required when adding a certificate of type "client". È possibile specificare un percorso relativo o assoluto.You can provide a relative or absolute path. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-pwd,--privateKeyPassword-pwd, --privatekeypassword stringString Specifica una password facoltativa per la chiave privata del client.Specifies an optional password for the client private key. La password è necessaria quando si aggiunge una chiave privata del certificato client crittografata.The password is required when adding a client certificate private key that is encrypted. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
--private-key-file-path--private-key-file-path stringString Specifica il percorso di un file con estensione PEM del certificato della chiave privata del client.Specifies the path to a client private key certificate .pem file. Necessario quando si aggiunge un certificato di tipo "client".Required when adding a certificate of type "client". È possibile specificare un percorso relativo o assoluto.You can provide a relative or absolute path. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-w,--private-key-password-w, --private-key-password stringString Specifica una password facoltativa per la chiave privata del client.Specifies an optional password for the client private key. La password è necessaria quando si aggiunge una chiave privata del certificato client crittografata.The password is required when adding a client certificate private key that is encrypted. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device certificate add --certid certroot --certtype rootca --publickeyfilepath publiccert.pem
Certificate 'certroot' successfully added.
azsphere device certificate add -certid certclient -certtype client -privatekeyfilepath privatekey.pem -privatekeypassword 1234 -publickeyfilepath publiccert.pem
Certificate 'certclient' successfully added.

certificate deletecertificate delete

Elimina un certificato dall'archivio certificati del dispositivo.Deletes a certificate from the device's certificate store.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--CertId-i, --certid stringString Specifica l'identificatore del certificato da eliminare.Specifies the identifier of the certificate to delete. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--Cert-ID-i, --cert-id stringString Specifica l'identificatore del certificato da eliminare.Specifies the identifier of the certificate to delete. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device certificate delete --certid certclient
Successfully deleted certificate 'certclient'.

certificate listcertificate list

Elenca gli ID certificato disponibili nell'archivio certificati.Lists the certificate IDs that are available in the certificate store.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device certificate list
Stored certificates:

 - certclient
 - certroot

certificate showcertificate show

Visualizza i dettagli di un singolo certificato nell'archivio certificati del dispositivo.Shows details of an individual certificate in the device's certificate store.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--CertId-i, --certid stringString Specifica l'identificatore del certificato da visualizzare.Specifies the identifier of the certificate to show. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--Cert-ID-i, --cert-id stringString Specifica l'identificatore del certificato da visualizzare.Specifies the identifier of the certificate to show. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device certificate show --certid certroot
Cert ID             : certroot
Start Date          : 2019-08-06T19:31:04
Expiry Date         : 2021-08-06T19:41:04
Subject Name        :
Issuer Name         : /DC=local/DC=azsphere/CN=azsphereca

certificate show-quotacertificate show-quota

Visualizza lo spazio disponibile nell'archivio certificati del dispositivo.Displays the available free space in the device's certificate store.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device certificate show-quota
19435 bytes available for certificate and password storage.

attestazioneclaim

Attesta un dispositivo non attestato in precedenza per il tenant di Azure Sphere.Claims a previously unclaimed device for the current Azure Sphere tenant.

Importante

Prima dell'attestazione del dispositivo, assicurarsi di aver eseguito l'accesso al tenant corretto di Azure Sphere.Before you claim the device, ensure that you are signed in to the correct Azure Sphere tenant. L'attestazione del dispositivo può essere eseguita una sola volta.A device can be claimed only once. Una volta eseguita l'attestazione, non è possibile spostare il dispositivo in un tenant diverso.Once claimed, a device cannot be moved to a different tenant.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
--force--force - Impone la richiesta di un dispositivo nel tenant Azure Sphere selezionato dell'utente corrente.Forces a device to be claimed in the current user's selected Azure Sphere tenant. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta-Azure Sphere CLI v2 Beta
-i,--DeviceID-i, --deviceid GUIDGUID Specifica l'ID del dispositivo da attestare.Specifies the ID of the device to claim. Se omesso, azsphere attesta il dispositivo collegato.If omitted, azsphere claims the attached device. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo da usare in questo comando quando sono collegati più dispositivi.Specifies the device to use in this command when multiple devices are attached. Usa il dispositivo attualmente collegato per impostazione predefinita.Uses the currently attached device by default. È possibile specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato.You can either specify the IP address or Local Connection ID of an attached device. In alternativa, specificare un ID dispositivo, che non richiede un dispositivo collegato.Alternatively, provide a device ID, which does not require an attached device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device claim
warn: You are claiming a device to the following tenant:
warn: a323c263-2aa3-2559-aabb-a3fc32631900 (Tenant1)
warn: Do you want to claim the device ID 6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46 to this tenant?
warn: You cannot change the Azure Sphere tenant this device is claimed to once this action has completed.
Enter 'yes' to continue. Enter anything else to exit.
> yes
Claiming device.
Successfully claimed device ID '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46' into tenant 'Tenant1' with ID 'a323c263-2aa3-2559-aabb-a3fc32631900'.

enable-cloud-test, ectenable-cloud-test, ect

Rende il dispositivo collegato pronto per il caricamento del cloud di test disabilitando lo sviluppo dell'applicazione, eliminando tutte le applicazioni esistenti e consentendo l'esecuzione degli aggiornamenti dell'applicazione caricati sul cloud.Readies the attached device for testing cloud loading by disabling application development, deleting any existing applications, and enabling cloud-loaded application updates.

Richiede un dispositivo collegato al computer e funziona solo su tale dispositivo.It requires a device to be attached to the PC and operates only on the attached device.

In particolare, enable-cloud-test:Specifically, enable-cloud-test:

  • Rimuove la funzionalità appDevelopment per il dispositivo collegatoRemoves the appDevelopment capability for the attached device
  • Assegna il dispositivo a un gruppo di dispositivi, consentendo di eseguire gli aggiornamenti dell'applicazione caricati sul cloudAssigns the device to a device group that enables cloud-loaded application updates
  • Riavvia il dispositivoReboots the device

Le attività specifiche che enable-cloud-test esegue variano in base all'avvenuta assegnazione al dispositivo del prodotto e del gruppo di dispositivi.The specific tasks that enable-cloud-test performs depend on whether a product and device group have already been assigned for this device.

Se azsphere device enable-cloud-test viene emesso senza parametri, il dispositivo verrà inserito nel gruppo di dispositivi "Test sul campo" del prodotto corrente del dispositivo.If azsphere device enable-cloud-test is issued without parameters, the device will be placed in the "Field Test" device group of the device's current product. Si tratta di uno dei gruppi di dispositivi predefiniti creati automaticamente per ogni prodotto, che consente gli aggiornamenti dell'applicazione.This is one of the default device groups created automatically for each product, which enables application updates. Se il dispositivo non dispone di un prodotto oppure un gruppo di dispositivi "Test sul campo" non esiste al suo interno si verificherà un errore.An error will be given if the device doesn't have a product, or a "Field Test" device group doesn't exist within it.

Se viene specificato un prodotto, il dispositivo verrà inserito nel gruppo di dispositivi "Test sul campo" del prodotto.If a product is specified, the device will be placed in the "Field Test" device group of that product. Se il gruppo di dispositivi non esiste, verrà restituito un errore.An error will be given if this device group doesn't exist.

Se viene specificato un gruppo di dispositivi, il dispositivo verrà inserito al suo interno.If a device group is specified, the device will be placed in it. Se il gruppo di dispositivi di destinazione non abilita gli aggiornamenti dell'applicazione, verrà restituito un errore.An error will be given if the target device group doesn't enable application updates.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-DGI,--devicegroupid-dgi, --devicegroupid GUIDGUID Specifica l'ID del gruppo di dispositivi a cui assegnare il dispositivo.Specifies the ID of the device group to which to assign the device. Se omesso, assegna il dispositivo a un gruppo predefinito che consente di eseguire gli aggiornamenti dell'applicazione.If omitted, assigns the device to a default group that enables application updates. Non può essere usato con il parametro --newdevicegroupname.Cannot be used with --newdevicegroupname. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi.Specifies the name of the device group. Usare con --productname per applicare il comando a un gruppo di dispositivi oppure usare --devicegroupid.Use with --productname to apply command to a device group, or use --devicegroupid. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PI,--ProductID-pi, --productid GUIDGUID Specifica l'ID di un prodotto esistente da applicare al dispositivo.Specifies the ID of an existing product to apply to the device. Se specificato, il dispositivo verrà spostato nel gruppo di dispositivi "Test sul campo" predefinito del prodotto, a meno che non sia specificato anche --devicegroupname.If specified, the device will be moved to the default "Field Test" device group of this product, unless --devicegroupname is also specified. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PN,--ProductName-pn, --productname stringString Specifica il nome di un prodotto esistente.Specifies the name of an existing product. Usare con --devicegroupname per specificare un gruppo di dispositivi all'interno del prodotto oppure usare--devicegroupid.Use with --devicegroupname to specify a device group within the product, or use --devicegroupid. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-p,--prodotto-p, --product GUID o nomeGUID or name Specifica il prodotto di destinazione.Specifies the target product. Quando si specifica questa opzione, il dispositivo verrà spostato nel Field Test gruppo di dispositivi predefinito di questo prodotto, a meno che non --device-group sia specificato anche.When this is specified, the device will be moved to the default Field Test device group of this product, unless --device-group is also specified. È possibile specificare l'ID o il nome del prodotto Azure Sphere.You can specify either the ID or name of the Azure Sphere product. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-g,--Device-Group-g, --device-group GUID o nomeGUID or name Specifica il gruppo di dispositivi a cui assegnare il dispositivo.Specifies the device group to which to assign the device. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

Esempio 1.Example 1. Assegnare il dispositivo al gruppo di dispositivi esistente in base al relativo IDAssign device to existing device group by its ID

L'esempio illustra l'assegnazione di un dispositivo a un prodotto e gruppo di dispositivi esistente.This example assigns the attached device to an existing product and device group.

azsphere device enable-cloud-test --devicegroupid 0e78m0mm-47d9-42m5-8572-a20b315d8045
Getting device group by ID '0e78m0mm-47d9-42m5-8572-a20b315d8045'.
Removing applications from device.
Component 'me2712ss-03bb-292b-9663-962f966g9cc3' deleted.
Removing debugging server from device.
Component '2542b129-g16f-4f24-2dge-d2c247862e72' deleted.
Successfully removed applications from device.
Locking device.
Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46'
Downloading device capability configuration.
Applying device capability configuration to device.
The device is rebooting.
Successfully locked device.
Setting device group to 'Marketing' with ID '0e78m0mm-47d9-42m5-8572-a20b315d8045')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46')

Esempio 2.Example 2. Assegnare il dispositivo a gruppo di dispositivi diversoAssign device to different device group

Questo esempio è simile al precedente, ma il prodotto esistente viene mantenuto per il dispositivo.This example is similar to the preceding example, but retains the existing product for the device. In questo caso l'operazione enable-cloud-test modifica il gruppo di dispositivi a cui appartiene il dispositivo e rimuove la funzionalità appDevelopment.Here the enable-cloud-test operation changes the device group to which the device belongs and removes the appDevelopment capability. Questo comando è utile per lo spostamento di un dispositivo da un ambiente di sviluppo che non consente di eseguire gli aggiornamenti dell'applicazione a un ambiente di produzione che invece consente di eseguirli.This command is useful for moving a device from a development environment that does not enable application updates to a production environment that does.

azsphere device enable-cloud-test --devicegroupname "Field Test"
Getting device group 'Field Test' for product 'Marketing'.
Removing applications from device.
There are no components to delete.
Removing debugging server from device.
Component '8548b129-b16f-4f84-8dbe-d2c847862e78' deleted.
Successfully removed applications from device.
Locking device.
Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46'
Downloading device capability configuration.
Applying device capability configuration to device.
The device is rebooting.
Successfully locked device.
Setting device group to 'Field Test' with ID '0e78m0mm-47d9-42m5-8572-a20b315d8045')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46')

Esempio 3.Example 3. Assegnare il dispositivo in base al nome del prodottoAssign device by product name

L'esempio illustra l'abilitazione del caricamento del cloud e l'assegnazione del dispositivo a un prodotto in base al nome.This example enables cloud loading and assigns the device to a product by name.

azsphere device enable-cloud-test --productname Marketing
Getting device group 'Field Test' for product 'Marketing'.
Removing applications from device.
There are no components to delete.
Removing debugging server from device.
Component '8548b129-b16f-4f84-8dbe-d2c847862e78' deleted.
Successfully removed applications from device.
Locking device.
Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46'
Downloading device capability configuration.
Applying device capability configuration to device.
The device is rebooting.
Successfully locked device.
Setting device group to 'Field Test' with ID '0e78m0mm-47d9-42m5-8572-a20b315d8045')
Successfully updated device's device group.
Successfully set up device for application updates.
(Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46')

enable-development, edvenable-development, edv

Configura il dispositivo collegato per il debug locale e disabilita gli aggiornamenti dell'applicazione caricati sul cloud.Sets up the attached device for local debugging and disables cloud-loaded application updates.

In particolare, enable-development:Specifically, enable-development:

  • Scarica e applica la funzionalità appDevelopment per il dispositivo collegato.Downloads and applies the appDevelopment capability for the attached device.
  • Assegna il dispositivo a un gruppo di dispositivi che non Abilita gli aggiornamenti dell'applicazione caricati nel cloud.Assigns the device to a device group that does not enable cloud-loaded application updates.
  • Riavvia il dispositivo.Reboots the device.

Se si esegue il comando azsphere device enable-development senza parametri:If you issue the azsphere device enable-development command with no parameters:

  • Se il dispositivo non è già associato a un gruppo di prodotti o di dispositivi, il comando scarica e applica la funzionalità appDevelopment per il dispositivo collegato e lo riavvia.If the device doesn't already have a product or device group, the command downloads and applies the appDevelopment capability for the attached device, and reboots the device. Tutte le app esistenti rimangono nel dispositivo e il sistema operativo viene aggiornato.Any existing apps remain on the device, and the OS is updated. Pertanto, il processo di installazione per attestare il dispositivo e l'Avvio rapido per la compilazione di un'applicazione di alto livello non saranno interessati.Therefore, the install process to claim your device and the Quickstart to build a high-level application will be unaffected.
  • Se il dispositivo dispone già di un prodotto, il comando sposta il dispositivo al gruppo di dispositivi Sviluppo del prodotto.If the device already has a product, the command moves the device to the product's Development device group. Per impostazione predefinita, gli aggiornamenti dell'applicazione sono disabilitati per questo gruppo, al fine di garantire che le app trasferite localmente non vengano sovrascritte.By default, application updates are disabled for this group, thus ensuring that sideloaded apps are not overwritten.

Se si esegue il comando azsphere device enable-development con il parametro --productname:If you issue the azsphere device enable-development command with the --productname parameter:

  • Inserisce il dispositivo nel gruppo di dispositivi "Sviluppo" per il prodotto.Places the device in the "Development" device group for the product. Se il gruppo di dispositivi non esiste, verrà restituito un errore.An error occurs if this device group doesn't exist.

Se si esegue il comando azsphere device enable-development con il parametro --devicegroupid:If you issue the azsphere device enable-development command with the --devicegroupid parameter:

  • Inserisce il dispositivo nel gruppo di dispositivi specificato.Places the device in the specified device group is specified. Il gruppo di dispositivi di destinazione non deve abilitare gli aggiornamenti dell'applicazione; se il gruppo di dispositivi abilita gli aggiornamenti dell'applicazione, si verifica un errore.The target device group must not enable application updates; if the device group enables application updates, an error occurs.

In alcuni casi, azsphere device enable-development segnala un errore e suggerisce di attestare il dispositivo.In some cases, azsphere device enable-development reports an error and suggests that you claim the device. Se il dispositivo è già stato richiesto, usare azsphere tenant Show-Selected per assicurarsi di essere connessi al tenant in cui è stato richiesto il dispositivo.If you have already claimed the device, use azsphere tenant show-selected to ensure that you are logged in to the tenant in which you claimed the device. In caso contrario, usare l' account di accesso azsphere per accedere al tenant corretto.If not, use azsphere login to log into the correct tenant. Quando si è certi di essere connessi al tenant appropriato, usare --azsphere device claim per richiedere il dispositivo.When you're sure you're logged into the appropriate tenant, use --azsphere device claim to claim the device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-DGI,--devicegroupid-dgi, --devicegroupid GUIDGUID Specifica l'ID di un gruppo di dispositivi su cui non vengono applicati gli aggiornamenti over-the-air dell'applicazione.Specifies the ID of a device group that does not apply over-the-air application updates. Se omesso, assegna il dispositivo a un gruppo predefinito.If omitted, assigns the device to a default group. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi.Specifies the name of the device group. Usare con --productname per applicare il comando a un gruppo di dispositivi oppure usare --devicegroupid.Use with --productname to apply command to a device group, or use --devicegroupid. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-r, --enablertcoredebugging-r, --enablertcoredebugging - Installa i driver necessari per il debug di applicazioni in esecuzione su un core per operazioni in tempo reale.Installs drivers required to debug applications running on a real-time core. Questa opzione richiede le autorizzazioni di amministratore.This option requires administrator permissions. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PI,--ProductID-pi, --productid GUIDGUID Specifica l'ID di un prodotto esistente da applicare al dispositivo.Specifies the ID of an existing product to apply to the device. Se specificato, il dispositivo verrà spostato nel gruppo di dispositivi "Sviluppo" predefinito del prodotto, a meno che non sia specificato anche --devicegroupname.If specified, the device will be moved to the default "Development" device group of this product, unless --devicegroupname is also specified. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto.Specifies the product name. Usare con--nomegruppodispositivi per applicare il comando a un gruppo di dispositivi o usare --devicegroupid .Use with --devicegroupname to apply command to a device group, or use --devicegroupid. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--Device-Group-g, --device-group GUID o nomeGUID or name Specifica il gruppo di dispositivi che non applica gli aggiornamenti dell'applicazione in modalità wireless.Specifies the device group that does not apply over-the-air application updates. Se omesso, assegna il dispositivo a un gruppo predefinito.If omitted, assigns the device to a default group. È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-r,--Enable-RT-core-debug-r, --enable-rt-core-debugging - Installa i driver necessari per il debug di applicazioni in esecuzione su un core per operazioni in tempo reale.Installs drivers required to debug applications running on a real-time core. Questa opzione richiede le autorizzazioni di amministratore.This option requires administrator permissions. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-p,--prodotto-p, --product GUID o nomeGUID or name Specificare il prodotto di destinazione.Specify the target product. Quando si specifica questa opzione, il dispositivo verrà spostato nel Development gruppo di dispositivi predefinito di questo prodotto, a meno che non --devicegroupname sia specificato anche.When this is specified, the device will be moved to the default Development device group of this product, unless --devicegroupname is also specified. È possibile specificare l'ID o il nome del prodotto Azure Sphere.You can specify either the ID or name of the Azure Sphere product. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device enable-development --enablertcoredebugging
Installing USB drivers to enable real-time core debugging.
Drivers installed for all attached devices.
warn: The device already has the 'Enable App development' capability. No changes will be applied to its existing capabilities.
Application updates have already been disabled for this device.
Installing debugging server to device.
Deploying 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' to the attached device.
Image package 'C:\Program Files (x86)\Microsoft Azure Sphere SDK\DebugTools\gdbserver.imagepackage' has been deployed to the attached device.
Previous device capabilities retained. Ensure that you have the correct development capabilities installed before continuing.
Successfully set up device for application development, and disabled application updates.
(Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46')

image, imgimage, img

Restituisce informazioni sulle immagini installate nel dispositivo collegato o destinate ad esso.Returns information about the images that are installed on or targeted to the attached device.

OperazioneOperation DescrizioneDescription
list-installedlist-installed Fornisce informazioni dettagliate sulle immagini attualmente installate nel dispositivo collegatoProvides details about the images that are currently installed on the attached device
list-targetedlist-targeted Fornisce informazioni dettagliate sulle immagini destinate al dispositivo collegato.Provides details about the images that are targeted to the attached device.

image list-installedimage list-installed

Elenca le immagini installate nel dispositivo collegato.Lists the images that are installed on the attached device. L'elenco delle informazioni include gli ID dei componenti e delle immagini.The list of information includes the component and image IDs.

Nota

I nomi di immagini lunghi verranno troncati a 15 caratteri.Long image names will be truncated at 15 characters.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-f, --full-f, --full - Elenca tutte le immagini software installate nel dispositivo.Lists all software images that are installed on the device. Per impostazione predefinita, elenca solo le immagini dell'applicazione, i debugger e le immagini di configurazione della scheda.By default, lists only application images, debuggers, and board configuration images. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device image list-installed
Installed images:
 --> gdbserver
   --> Image type:   Application
   --> Component ID: 8548b129-b16f-4f84-8dbe-d2c847862e78
   --> Image ID:     43d2707f-0bc7-4956-92c1-4a3d0ad91a74
 --> Mt3620Blink4
   --> Image type:   Application
   --> Component ID: 970d2ff1-86b4-4e50-9e80-e5af2845f465
   --> Image ID:     e53ce989-0ecf-493d-8056-fc0683a566d3
Command completed successfully in 00:00:01.6189314.

image list-targetedimage list-targeted

Elenca le immagini caricate nel servizio di sicurezza di Azure Sphere e che verranno installate al successivo aggiornamento del dispositivo.Lists the images that have been uploaded to the Azure Sphere Security Service and will be installed the next time the device is updated. Per altre informazioni su come verificare che il dispositivo Azure Sphere sia pronto ad accettare gli aggiornamenti dell'applicazione basati sul cloud, vedere abilitare la distribuzione basata sul cloud per il dispositivo.For more information on ensuring that your Azure Sphere device is ready to accept cloud-based application updates, see Enable cloud-based deployment for your device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-f, --full-f, --full - Elenca tutte le immagini software che verranno installate nel dispositivo.Lists all software images that will be installed on the device. Per impostazione predefinita, vengono elencate solo le immagini delle applicazioni.By default, lists only application images. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-i,--DeviceID-i, --deviceid GUIDGUID Specifica l'ID del dispositivo per il quale elencare le immagini di destinazione.Specifies the ID of the device for which to list targeted images. Elenca le immagini per il dispositivo attualmente collegato per impostazione predefinita.Lists images for the currently attached device by default. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo da usare in questo comando quando sono collegati più dispositivi.Specifies the device to use in this command when multiple devices are attached. Usa il dispositivo attualmente collegato per impostazione predefinita.Uses the currently attached device by default. È possibile specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato.You can either specify the IP address or Local Connection ID of an attached device. In alternativa, specificare un ID dispositivo, che non richiede un dispositivo collegato.Alternatively, provide a device ID, which does not require an attached device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device image list-targeted
Successfully retrieved the images to be installed on device with ID '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46' from the Azure Sphere Security Service:
 --> CrashApplication
   --> Image type:   Application
   --> Component ID: 9ce57001-90eb-45e1-bd0a-4fc07b0c85c9
   --> Image ID:     85b0797c-8c0f-4254-9437-7083f77fe9eb

listlist

Elenca tutti i dispositivi in un tenant.Lists all devices in a tenant. L'elenco viene troncato dopo i primi 500 dispositivi.The list truncates after first 500 devices.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-o, --output-o, --output stringString Specifica il percorso e il nome file per l'esportazione dei risultati dell'elenco.Specifies the location and filename for exporting the list results. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-si,--showids-si, --showids - Specifica se i risultati devono essere inclusi negli ID dispositivo.Specifies if device IDs should be included in the results. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-NI,--non interattivo-ni, --noninteractive - Consente di visualizzare tutti i dispositivi attivando la modalità non interattiva.Displays all devices by turning on non-interactive mode. L'elenco continuerà automaticamente dopo ogni pagina di risultati.List will automatically continue after each page of results. Questo parametro è utile per l'automazione e per il piping dei risultati in un file con estensione CSV.This parameter is useful for automation and for piping results to a .csv file. Usare con--output per salvare i risultati in un file.Use with --output to save results to a file. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device list
The device(s) in the current tenant:
Device ID                                                                                                                        Chip SKU Product Name Device Group Name
---------                                                                                                                        -------- ------------ -----------------
6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46 MT3620AN DW100    Development
1F01B8X8CXDXG3ED4223F267151CXD59X99G0CED193F2446334F231D925FGFEX9GXDD0550433595653FDDC16723X32DECX5494X7F20D067C1C3X77F6020C9F41 MT3620AN DW200    Field Test

list-attachedlist-attached

Elenca i dispositivi collegati al PC locale.Lists the devices attached to the local PC.

Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device list-attached
1 device attached:
--> Device ID: 6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46
  --> Is responsive: yes
  --> IP address: 192.128.48.1
  --> Connection path: 21143

manufacturing-state, mfgmanufacturing-state, mfg

Gestisce lo stato di produzione del dispositivo collegato.Manages the manufacturing state of the attached device.

OperazioneOperation DescrizioneDescription
showshow Consente di visualizzare lo stato di produzione del dispositivo collegatoDisplays the manufacturing state of the attached device
updateupdate Aggiorna lo stato di produzione del dispositivo collegatoUpdates the manufacturing state of the attached device

Attenzione

Le modifiche allo stato di produzione sono definitive e irreversibili.Manufacturing state changes are permanent and irreversible.

manufacturing-state showmanufacturing-state show

Consente di visualizzare lo stato di produzione del dispositivo collegato.Displays the manufacturing state of the attached device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device manufacturing-state show
Manufacturing State: Module1Complete

manufacturing-state updatemanufacturing-state update

Aggiorna lo stato di produzione del dispositivo collegato.Updates the manufacturing state of the attached device. Per altre informazioni, vedereimpostare lo stato di produzione del dispositivo.For more information, seeSet the device manufacturing state.

Attenzione

Le modifiche allo stato di produzione sono definitive e irreversibili.Manufacturing state changes are permanent and irreversible.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-s,--stato-s, --state Stati di produzione impostabiliSettable Manufacturing States Specifica lo stato di produzione da impostare per il dispositivo.Specifies the manufacturing state to set for the device. I ruoli possibili sono: DeviceComplete e Module1Complete .Possible roles are: DeviceComplete and Module1Complete. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device manufacturing-state update --state Module1Complete
Restarting device for changes to take effect.
Device restarted successfully.

networknetwork

Fornisce informazioni sullo stato delle interfacce di rete sul dispositivo collegato.Provides information about the status of network interfaces on the attached device.

OperazioneOperation DescrizioneDescription
elenco-Firewall-regolelist-firewall-rules Elenca le regole del firewall per il dispositivo collegato.Lists the firewall rules for the attached device.
interfacce elencolist-interfaces Elenca le interfacce di rete per il dispositivo collegato.Lists the network interfaces for the attached device.
SD, Mostra-diagnosticasd, show-diagnostics Mostra la diagnostica per una o tutte le reti Wi-Fi sul dispositivo collegato.Shows diagnostics for one or all Wi-Fi networks on the attached device.
show-statusshow-status Mostra lo stato di rete Wi-Fi per il dispositivo collegato.Shows the Wi-Fi network status for the attached device.
Update-Interfaceupdate-interface Aggiorna l'interfaccia di rete per il dispositivo.Updates the network interface for the device.

elenco reti-Firewall-regolenetwork list-firewall-rules

Elenca le regole del firewall per il dispositivo collegato.Lists the firewall rules for the attached device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Vengono visualizzate le regole seguenti:The following rules are displayed:

  • Firewall RuleSet Name: Visualizza il nome del blocco di RuleSet del firewall.Firewall Ruleset Name: Displays the name of the firewall ruleset block. I valori sono PREROUTING, input, inoltro e output.The values are PREROUTING, INPUT, FORWARD, and OUTPUT.

  • RuleSet valido: Visualizza lo stato del set di regole.Is Ruleset Valid: Displays the status of the ruleset. I valori sono true o false.The values are True or False.

  • Regole di RuleSet del firewall: Visualizza i valori per le regole seguenti:Firewall Ruleset Rules: Displays the values for the following rules:

    • IP di origine: Visualizza l'indirizzo IP del computer mittenteSource IP: Displays the IP address of the sending machine
      • Source mask: visualizza la Network mask del computer di invioSource Mask: Displays the network mask of the sending machine
      • IP di destinazione: Visualizza l'indirizzo IP del computer di destinazioneDestination IP: Displays the IP address of the destination machine
      • UID: Visualizza l'identificazione dell'utente applicata alla regola.UID: Displays the user identification applied to the rule. 4294967295 (0xFFFFFFFF) indica che non è stato applicato alcun UID e che pertanto si applica a tutti gli utenti.4294967295 (0xFFFFFFFF) means no UID was applied and therefore it applies to everyone.
      • Azione: Visualizza l'azione da intraprendere.Action: Displays the action to be taken. I valori possono essere Accept o Drop.The values can be accept or drop.
      • Interfaccia in nome: Visualizza il nome dell'interfaccia di input.Interface IN name: Displays the input interface name. Ad esempio, wlan0.For example, wlan0.
      • Nome interfaccia: Visualizza il nome dell'interfaccia di output.Interface OUT name: Displays the output interface name. Ad esempio, wlan0.For example, wlan0.
      • Stato: Visualizza lo stato della connessione.State: Displays the connection state. I valori sono None, established o related.The values are none, established, or related.
      • TCP mask: Visualizza la matrice di maschere TCP.TCP Mask: Displays the array of TCP masks. I valori sono pinna, SYN, RST, PSH, ACK e Urg.The values are fin, syn, rst, psh, ack, and urg.
      • TCP CMP: Visualizza la matrice di flag TCP.TCP Cmp: Displays the array of TCP flags. I valori sono Urg, ACK, PSH, RST, SyB e fin.The values are urg, ack, psh, rst, syb, and fin.
      • TCP inv: Boolean indica che è necessario invertire il senso dei flag TCP.TCP Inv: Boolean indicates that sense of the TCP flags should be inverted. I valori sono true o false.The values are True or False.
      • Protocollo: Visualizza il protocollo della regola del firewall.Protocol: Displays the protocol of the firewall rule. I valori sono ICMP, IGMP, TCP e UDP.The values are icmp, igmp, tcp, udp.
      • Intervallo di porte di origine: Visualizza l'intervallo di porte dall'origine che invia il traffico.Source Port Range: Displays the port range from source that sends the traffic. Il valore può essere compreso tra 0 e 65535.The value can be between 0 and 65535.
      • Intervallo porte di destinazione: consente di visualizzare l'intervallo di porte della destinazione che riceve il traffico.Destination Port Range: Displays the port range on destination that receives the traffic. Il valore può essere compreso tra 0 e 65535.The value can be between 0 and 65535.
      • Pacchetti: Visualizza il numero di pacchettiPackets: Displays the number of packets
      • Byte: Visualizza il numero di byteBytes: Displays the number of bytes

Un breve riepilogo dei flag è riportato di seguito:A brief summary of the flags is listed as follows:

  • URG: campo puntatore urgente significativoURG: Urgent Pointer field significant
  • ACK: campo di riconoscimento significativoACK: Acknowledgment field significant
  • PSH: funzione pushPSH: Push Function
  • RST: reimpostare la connessioneRST: Reset the connection
  • SYN: sincronizzare i numeri di sequenzaSYN: Synchronize sequence numbers
  • FIN: non sono presenti altri dati dal mittenteFIN: No more data from sender
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device network list-firewall-rules
Firewall Ruleset Name: PREROUTING
Is Ruleset Valid: False
No rules found.

Firewall Ruleset Name: INPUT
Is Ruleset Valid: True
Firewall Ruleset Rules:
   Source IP             : <value>
   Source Mask           : <value>
   Destination IP        : <value>
   UID                   : <value>
   Action                : accept
   Interface IN name     :
   Interface OUT name    :
   State                 : none
   TCP Mask              : {  }
   TCP Cmp               : {  }
   TCP Inv               : False
   Protocol              : any
   Source Port Range     : { min: 0, max: 65535 }
   Destination Port Range: { min: 0, max: 65535 }
   Packets               : 1
   Bytes                 : 97

Firewall Ruleset Name: FORWARD
Is Ruleset Valid: True
Firewall Ruleset Rules:
   Source IP             : <value>
   Source Mask           : <value>
   Destination IP        : <value>
   UID                   : 4294967295
   Action                : drop
   Interface IN name     :
   Interface OUT name    :
   State                 : none
   TCP Mask              : {  }
   TCP Cmp               : {  }
   TCP Inv               : False
   Protocol              : any
   Source Port Range     : { min: 0, max: 65535 }
   Destination Port Range: { min: 0, max: 65535 }
   Packets               : 0
   Bytes                 : 0

Firewall Ruleset Name: OUTPUT
Is Ruleset Valid: True
Firewall Ruleset Rules:
   Source IP             : <value>
   Source Mask           : <value>
   Destination IP        : 127.0.0.1
   UID                   : 4294967295
   Action                : accept
   Interface IN name     :
   Interface OUT name    :
   State                 : none
   TCP Mask              : {  }
   TCP Cmp               : {  }
   TCP Inv               : False
   Protocol              : tcp
   Source Port Range     : { min: 0, max: 65535 }
   Destination Port Range: { min: 0, max: 65535 }
   Packets               : 0
   Bytes                 : 0

Firewall Ruleset Name: POSTROUTING
Is Ruleset Valid: False
No rules found.

elenco reti-interfaccenetwork list-interfaces

Elenca le interfacce di rete per il dispositivo collegato.Lists the network interfaces for the attached device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere dev network list-interfaces
4 Network interface(s)

Interface name                   : eth0
Network interface up             : True
Connected to network             : True
Acquired IP address              : True
Connected to internet            : True
Hardware address                 : ba:98:76:57:a1:de

Interface name                   : lo
Network interface up             : True
Connected to network             : False
Acquired IP address              : False
Connected to internet            : False

Interface name                   : azspheresvc
Network interface up             : True
Connected to network             : False
Acquired IP address              : False
Connected to internet            : False

Interface name                   : wlan0
Network interface up             : True
Connected to network             : True
Acquired IP address              : True
Connected to internet            : True
Hardware address                 : 2c:f7:f1:05:26:6a

Network show-Diagnostics, SDnetwork show-diagnostics, sd

Mostra la diagnostica per una o tutte le reti Wi-Fi sul dispositivo collegato.Shows diagnostics for one or all Wi-Fi networks on the attached device.

Parametri facoltativiOptional parameters

ParametroParameter DescrizioneDescription
-i,--ID-i, --id IntegerInteger Specifica l'ID della rete per cui visualizzare la diagnostica.Specifies the ID of the network for which to show diagnostics. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device network show-diagnostics
Timestamp           : 2020-06-23t16:48:50+0000
Network ID          : 0
SSID                : <value>
Last Recorded Error : NetworkNotFound
Configuration State : enabled
Connection State    : disconnected
No certificate errors logged.

Timestamp:             2020-02-20 02:54:20pm
Network Id:            1
SSID:                  pskNetwork
Last Recorded Error:   WrongKey
Configuration State:   enabled
Connection State:      disconnected

Timestamp:             2020-02-20 02:53:30pm
Network Id:            0
SSID:                  EAP-TLS Wifi
Last Recorded Error:   ConnectionFailed
Configuration State:   temp-disabled
Connection State:      disconnected
No certificate errors logged.

Visualizzazione rete-statonetwork show-status

Mostra lo stato della rete per il dispositivo collegato.Shows the network status for the attached device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device network show-status
Is device authentication ready: True
Network time sync status      : complete

Interfaccia aggiornamento rete, unetwork update-interface, u

Aggiorna l'interfaccia di rete Ethernet per il dispositivo.Updates the Ethernet network interface for the device. Per altre informazioni sull'impostazione dell'indirizzo MAC per il dispositivo, vedere Configurazione Ethernet.For more information on setting the MAC address for the device, see Ethernet configuration.

Nota

Questo comando è supportato per la configurazione delle eth0 connessioni Ethernet.This command is supported for configuring Ethernet eth0 connections. Se si configura o, verrà restituito un lo errore azspheresvc wlan0 .An error will be reported if you configure lo, azspheresvc or wlan0.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ha,--hardwareaddress-ha, --hardwareaddress stringString Specifica l'indirizzo hardware da impostare per il dispositivo in uno dei formati seguenti: AA:BB:33:DD:EE:FF o aa:bb:33:dd:ee:ff .Specifies the hardware address to set for the device in either of the following formats: AA:BB:33:DD:EE:FF or aa:bb:33:dd:ee:ff. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-n,--InterfaceName-n, --interfacename stringString Specifica il nome dell'interfaccia da configurare.Specifies the name of the interface to configure. Eseguire azsphere device network list-interfaces per visualizzare i dettagli delle interfacce di rete per il dispositivo collegato.Run azsphere device network list-interfaces to view details of the network interfaces for the attached device. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
--hardware-address--hardware-address stringString Specifica l'indirizzo hardware da impostare per il dispositivo in uno dei formati seguenti: AA:BB:33:DD:EE:FF o aa:bb:33:dd:ee:ff .Specifies the hardware address to set for the device in either of the following formats: AA:BB:33:DD:EE:FF or aa:bb:33:dd:ee:ff. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
--Interface-Name--interface-name stringString Specifica il nome dell'interfaccia da configurare.Specifies the name of the interface to configure. Eseguire azsphere device network list-interfaces per visualizzare i dettagli delle interfacce di rete per il dispositivo collegato.Run azsphere device network list-interfaces to view details of the network interfaces for the attached device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device network update-interface --interfacename eth0 --hardwareaddress ba:98:76:54:32:10

recoverrecover

Sostituisce il software del sistema nel dispositivo.Replaces the system software on the device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-c,--funzionalità-c, --capability stringString Specifica l'immagine della funzionalità del dispositivo da applicare al dispositivo durante il ripristino.Specifies the device capability image to apply to the device during recovery. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-i,--immagini-i, --images stringString Specifica il percorso di una cartella che contiene i pacchetti di immagini da scrivere nel dispositivo.Specifies the path to a folder that contains the image packages to write to the device. Per impostazione predefinita, il ripristino usa le immagini nell'SDK, a meno che non si specifichi un percorso alternativo con questo flag.By default, recovery uses the images in the SDK unless an alternate path is provided with this flag. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. Specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.Specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

Esempio 1:Example 1:

azsphere device recover
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 17 images. (5443272 bytes to send)
Sent 1 of 17 images. (5440896 of 5443272 bytes remaining)
Sent 2 of 17 images. (5414844 of 5443272 bytes remaining)
Sent 3 of 17 images. (5311892 of 5443272 bytes remaining)
Sent 4 of 17 images. (5311500 of 5443272 bytes remaining)
Sent 5 of 17 images. (5041520 of 5443272 bytes remaining)
Sent 6 of 17 images. (5024908 of 5443272 bytes remaining)
Sent 7 of 17 images. (4994856 of 5443272 bytes remaining)
Sent 8 of 17 images. (2397456 of 5443272 bytes remaining)
Sent 9 of 17 images. (885796 of 5443272 bytes remaining)
Sent 10 of 17 images. (861220 of 5443272 bytes remaining)
Sent 11 of 17 images. (758608 of 5443272 bytes remaining)
Sent 12 of 17 images. (135796 of 5443272 bytes remaining)
Sent 13 of 17 images. (70048 of 5443272 bytes remaining)
Sent 14 of 17 images. (41164 of 5443272 bytes remaining)
Sent 15 of 17 images. (32768 of 5443272 bytes remaining)
Sent 16 of 17 images. (16384 of 5443272 bytes remaining)
Sent 17 of 17 images. (0 of 5443272 bytes remaining)
Finished writing images; rebooting board.
Device ID: 6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46
Device recovered successfully.

Esempio 2:Example 2:

azsphere device recover --capability "C:\Users\capability file\capability_6A06X8X_5.bin"
Downloading recovery images...
Download complete.
Starting device recovery. Please note that this may take up to 10 minutes.
Board found. Sending recovery bootloader.
Erasing flash.
Sending 16 images. (5474668 bytes to send)
Sent 1 of 16 images. (5447384 of 5474668 bytes remaining)
Sent 2 of 16 images. (5343788 of 5474668 bytes remaining)
Sent 3 of 16 images. (5343396 of 5474668 bytes remaining)
Sent 4 of 16 images. (5073416 of 5474668 bytes remaining)
Sent 5 of 16 images. (5056612 of 5474668 bytes remaining)
Sent 6 of 16 images. (5026240 of 5474668 bytes remaining)
Sent 7 of 16 images. (2479376 of 5474668 bytes remaining)
Sent 8 of 16 images. (889892 of 5474668 bytes remaining)
Sent 9 of 16 images. (865316 of 5474668 bytes remaining)
Sent 10 of 16 images. (754512 of 5474668 bytes remaining)
Sent 11 of 16 images. (135796 of 5474668 bytes remaining)
Sent 12 of 16 images. (70048 of 5474668 bytes remaining)
Sent 13 of 16 images. (41164 of 5474668 bytes remaining)
Sent 14 of 16 images. (32768 of 5474668 bytes remaining)
Sent 15 of 16 images. (16384 of 5474668 bytes remaining)
Sent 16 of 16 images. (0 of 5474668 bytes remaining)
Finished writing images; rebooting board.
Device ID: 6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46
Device recovered successfully.

ripetizione dell'analisi: collegata, rarescan-attached, ra

Ripete l'analisi dei dispositivi collegati eseguendo il ciclo di alimentazione di tutte le porte FTDI.Rescans the attached devices by power-cycling all their FTDI ports. Usare questo comando per la risoluzione dei problemi di connessione del dispositivo in Windows.Use this command when troubleshooting device connection problems on Windows. Questo comando viene eseguito solo in Windows.This command runs only on Windows.

Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device rescan-attached
Rescanning has found 1 attached device.

restartrestart

Riavvia il dispositivo collegato.Restarts the attached device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
--devicelocation--devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device restart
Restarting device.
Device restarted successfully.

showshow

Consente di visualizzare le informazioni che il servizio di sicurezza di Azure Sphere archivia per un dispositivo.Displays information that the Azure Sphere Security Service stores for a device. Questi dettagli differiscono da quelli che vengono archiviati nel dispositivo stesso.These details differ from those that the device itself stores.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--DeviceID-i, --deviceid GUIDGUID Specifica l'ID del dispositivo.Specifies the ID of the device. Mostra informazioni sul dispositivo attualmente collegato per impostazione predefinita.Shows information about the currently attached device by default. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo da usare in questo comando quando sono collegati più dispositivi.Specifies the device to use in this command when multiple devices are attached. Usa il dispositivo attualmente collegato per impostazione predefinita.Uses the currently attached device by default. È possibile specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato.You can either specify the IP address or Local Connection ID of an attached device. In alternativa, specificare un ID dispositivo, che non richiede un dispositivo collegato.Alternatively, provide a device ID, which does not require an attached device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device show
Retrieved the device configuration for device with ID '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46':
   ChipSKU: 'MT3620AN'
   Product ID: '6gae21e6-g661-4b01-b935-3c5bf2ba0f72'
   Product name: 'DW100'
   Device group ID: '0e78m0mm-47d9-42m5-8572-a20b315d8045'
   Device group name: 'Development'

show-attachedshow-attached

Consente di visualizzare informazioni relative al dispositivo collegato dal dispositivo stesso.Displays information about the attached device from the device itself. Questi dettagli differiscono da quelli che il servizio di sicurezza di Azure Sphere archivia per il dispositivo.These details differ from those that the Azure Sphere Security Service stores for the device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device show-attached
Device ID: 6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46
IP address: 192.128.48.1
Connection path: 21143

show-deployment-statusshow-deployment-status

Mostra lo stato di distribuzione degli aggiornamenti dell'applicazione e del sistema operativo per il dispositivo.Displays the deployment status of application and operating system updates for the device.

Usare questo comando per scoprire la versione del sistema operativo di Azure Sphere in esecuzione nel dispositivo o per ottenere informazioni sul completamento dell'aggiornamento della distribuzione corrente.Use this command to find out which version of the Azure Sphere OS your device is running or whether the current deployment update has completed.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device show-deployment-status
Your device is running Azure Sphere OS version <version-number>.
The Azure Sphere Security Service is targeting this device with Azure Sphere OS version <version-number>.
Your device has the expected version of the Azure Sphere OS: <version-number>.

In questo esempio, <version-number> rappresenta la versione corrente del sistema operativo.In this example, <version-number> represents the current operating system version.

show-countshow-count

Mostra il numero di dispositivi nel tenant corrente.Displays the number of devices in the current tenant.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device show-count
The current tenant has 2 device(s).

show-os-versionshow-os-version

Mostra la versione corrente del sistema operativo nel dispositivo collegato.Displays the current operating system version on the attached device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only)Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device show-os-version
Your device is running Azure Sphere OS version <version-number>

In questo esempio, <version-number> rappresenta la versione corrente del sistema operativo.In this example, <version-number> represents the current operating system version.

sideload, slsideload, sl

Gestisce l'applicazione nel dispositivo.Manages the application on the device.

Alcune opzioni per il trasferimento locale richiedono la funzionalità appDevelopment, che può essere acquisita tramite enable-development.Some sideload options require the appDevelopment capability, which can be acquired by using enable-development. Per trasferire localmente un'applicazione con firma SDK o per avviare, arrestare, eseguire il debug o eliminare un'applicazione con firma SDK o di produzione, il dispositivo deve essere dotato della funzionalità appDevelopment.To sideload an SDK-signed application, or to start, stop, debug, or delete an SDK-signed application or a production-signed application, the device must have the appDevelopment capability.

OperazioneOperation DescrizioneDescription
deletedelete Elimina l'applicazione corrente dal dispositivo.Deletes the current application from the device.
deploydeploy Carica un'applicazione nel dispositivo.Loads an application onto the device.
Set-Deployment-timeoutset-deployment-timeout Imposta il periodo di timeout della distribuzione in secondi.Sets the deployment time-out period in seconds.
Mostra-distribuzione-timeoutshow-deployment-timeout Indica il periodo di timeout della distribuzione in secondi.Shows the deployment time-out period in seconds.

Si noti che i parametri per start , stop , show-status e show-quota sono stati spostati nel comando azsphere Device app .Note that the parameters to start, stop, show-status, and show-quota have been moved to the azsphere device app command.

sideload deletesideload delete

Elimina le applicazioni dal dispositivo.Deletes applications from the device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ComponentID-i, --componentid GUIDGUID Specifica l'ID dell'applicazione da eliminare dal dispositivo.Specifies the ID of the application to delete from the device. Se omesso, elimina tutte le applicazioni.If omitted, deletes all applications. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--Component-ID-i, --component-id GUIDGUID Specifica l'ID dell'applicazione da eliminare dal dispositivo.Specifies the ID of the application to delete from the device. Se omesso, elimina tutte le applicazioni.If omitted, deletes all applications. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device sideload delete
Component '54acba7c-7719-461a-89db-49c807e0fa4d' deleted.

sideload deploysideload deploy

Carica un'applicazione nel dispositivo collegato e la avvia.Loads an application onto the attached device and starts the application.

Questo comando non può essere eseguito se il manifesto dell'applicazione richiede una risorsa che è già in uso da un'applicazione presente sul dispositivo.This command fails if the application manifest requests a resource that is being used by an application that is already on the device. In questo caso, usare azsphere device sideload delete per eliminare l'applicazione esistente e quindi ripetere l'operazione.In this case, use azsphere device sideload delete to delete the existing application and then try sideloading again. Il comando azsphere device sideload delete eliminerà sia le applicazioni di alto livello che le applicazioni con operazioni in tempo reale. Per eliminare un'applicazione e lasciare le altre, specificare l'ID componente dell'applicazione da eliminare.The azsphere device sideload delete command will delete both high level applications and real time applications; to delete one application and leave the other specify the component ID of the application to delete.

Lo stesso comando viene usato per distribuire sia le applicazioni di alto livello che le applicazioni con operazioni in tempo reale.The same command is used to deploy both high-level applications and real-time capable applications.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-p,--imagepackage-p, --imagepackage stringString Specifica il percorso e il nome del file del pacchetto di immagini da caricare nel dispositivo.Specifies the path and filename of the image package to load on the device. Se il dispositivo non ha la funzionalità appDevelopment, la distribuzione con trasferimento locale avrà esito negativo.Sideload deployment will fail if the device does not have the appDevelopment capability. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-p,--Image-Package-p, --image-package stringString Specifica il percorso e il nome del file del pacchetto di immagini da caricare nel dispositivo.Specifies the path and filename of the image package to load on the device. Se il dispositivo non ha la funzionalità appDevelopment, la distribuzione con trasferimento locale avrà esito negativo.Sideload deployment will fail if the device does not have the appDevelopment capability. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
--force--force - Forza la distribuzione di un'immagine che usa un'API Beta che potrebbe non essere più supportata.Forces the deployment of an image that uses a Beta API that may no longer be supported. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-m, --manualstart-m, --manualstart - Specifica di non avviare l'applicazione dopo il caricamento.Specifies not to start the application after loading it. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device sideload deploy --imagepackage C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage
Deploying 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' to the attached device.
Image package 'C:\Users\LocalSamples\HelloWorld\HelloWorld_HighLevelApp\out\ARM-Debug\HelloWorld_HighLevelApp.imagepackage' has been deployed to the attached device.

set di sideload-Deployment-timeoutsideload set-deployment-timeout

Imposta il valore di timeout della distribuzione in secondi per le immagini sideload nel dispositivo.Sets the deployment time-out value in seconds for sideloading images on the device.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
<timeout-value> IntegerInteger Specifica la durata in secondi prima del timeout di un comando sideload. Il valore deve essere un numero intero positivo.Specifies the duration in seconds before a sideload command times out. The value must be a positive integer. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-v,--value-v, --value IntegerInteger Specifica la durata in secondi prima del timeout di un comando sideload. Il valore deve essere un numero intero positivo.Specifies the duration in seconds before a sideload command times out. The value must be a positive integer. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device sideload set-deployment-timeout 60
Sideload timeout value has been set to 60 seconds

sideload Show-Deployment-timeoutsideload show-deployment-timeout

Visualizza il valore di timeout della distribuzione corrente in secondi per le immagini sideload nel dispositivo.Displays the current deployment time-out value in seconds for sideloading images on the device.

Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device sideload show-deployment-timeout 30
Sideload timeout is 30 seconds

updateupdate

Sposta il dispositivo in un altro gruppo di dispositivi nel tenant di Azure Sphere.Moves the device into a different device group in your Azure Sphere tenant.

Oltre ai gruppi di dispositivi creati in un prodotto, vengono aggiunti cinque gruppi di dispositivi predefiniti quando viene creato un prodotto:In addition to device groups you create in a product, five default device groups are added when a product is created:

  • Il gruppo di dispositivi Sviluppo disabilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la valutazione per la vendita al dettaglio.Development device group disables cloud application updates and delivers the Retail Evaluation OS.
  • Il gruppo di dispositivi Test sul campo abilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la vendita al dettaglio.Field Test device group enables cloud application updates, and delivers the Retail OS.
  • Il gruppo di dispositivi Produzione abilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la vendita al dettaglio.Production device group enables cloud application updates, and delivers the Retail OS.
  • Il gruppo di dispositivi Valutazione del sistema operativo di produzione abilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la valutazione per la vendita al dettaglio.Production OS Evaluation device group enables cloud application updates and delivers the Retail Evaluation OS.
  • Il gruppo di dispositivi Valutazione del sistema operativo per test sul campo abilita gli aggiornamenti delle applicazioni cloud e fornisce il sistema operativo per la valutazione per la vendita al dettaglio.Field Test OS Evaluation device group enables cloud application updates and delivers the Retail Evaluation OS.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-DGI,--devicegroupid-dgi, --devicegroupid GUIDGUID Specifica l'ID del gruppo di dispositivi.Specifies the ID of the device group. Usare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi e la coppia di nomi di prodotto.Use either device group ID or a device group name and product name pair. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-DGN,--nomegruppodispositivi-dgn, --devicegroupname stringString Specifica il nome del gruppo di dispositivi.Specifies the name of the device group. Usare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi e la coppia di nomi di prodotto.Use either device group ID or a device group name and product name pair. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-i,--DeviceID-i, --deviceid GUIDGUID Specifica l'ID del dispositivo da spostare.Specifies the ID of the device to move. Sposta il dispositivo attualmente collegato per impostazione predefinita.Moves the currently attached device by default. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-PN,--ProductName-pn, --productname stringString Specifica il nome del prodotto.Specifies the name of the product. Usare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi e la coppia di nomi di prodotto.Use either device group ID or a device group name and product name pair. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-g,--Device-Group-g, --device-group GUID o nomeGUID or name Specifica il gruppo di dispositivi da aggiornare.È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format.Specifies the device group to update.È possibile specificare l'ID del gruppo di dispositivi o il nome del gruppo di dispositivi.You can specify either the device group ID or the device group name. Per usare il nome del gruppo di dispositivi, è necessario specificare il nome del prodotto e il nome del gruppo di dispositivi nel <product-name/device-group-name> formato.To use the device group name, you must provide both the product name and device group name in the <product-name/device-group-name> format. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--dispositivo-d, --device stringString Specifica il dispositivo da usare in questo comando quando sono collegati più dispositivi.Specifies the device to use in this command when multiple devices are attached. Usa il dispositivo attualmente collegato per impostazione predefinita.Uses the currently attached device by default. È possibile specificare l'indirizzo IP o l'ID connessione locale di un dispositivo collegato.You can either specify the IP address or Local Connection ID of an attached device. In alternativa, specificare un ID dispositivo, che non richiede un dispositivo collegato.Alternatively, provide a device ID, which does not require an attached device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-t,--tenant-t, --tenant GUID o nomeGUID or name Specifica il tenant in cui eseguire questa operazione.Specifies the tenant to perform this operation in. Esegue l'override del tenant selezionato predefinito.Overrides the default selected tenant. È possibile specificare l'ID tenant o il nome del tenant.You can specify either the tenant ID or tenant name. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device update --devicegroupid 0e78m0mm-47d9-42m5-8572-a20b315d8045
Getting device group by ID '0e78m0mm-47d9-42m5-8572-a20b315d8045'.
Successfully moved device to device group '0e78m0mm-47d9-42m5-8572-a20b315d8045'.
(Device ID: '6A06X8X8CXDXA8ED4223A267656CXD59X99A0CED693A2446884A236D925AAAEX9AXDD0550438595658ADDC66723X32DECX5494X7A20D067C6C8X77A6020C9A46')

wifiwifi

Gestisce le configurazioni Wi-Fi per il dispositivo collegato.Manages Wi-Fi configurations for the attached device.

Per usare il dispositivo in una rete di Wi-Fi, è necessario aggiungere informazioni sulla rete e abilitare la rete sul dispositivo.To use the device on a Wi-Fi network, you must add information about the network and enable the network on the device. Anche se per i nomi delle reti è possibile immettere caratteri non ASCII, azsphere non li visualizza correttamente.Although you can input non-ASCII characters in SSIDs, azsphere does not display them properly.

Se l'applicazione usa l' API di configurazione Wi-Fi, è necessario includere anche la funzionalità WifiConfig nel app_manifest.js del file dell'applicazione.If your application uses the Wi-Fi configuration API, you must also include the WifiConfig capability in the application's app_manifest.json file.

OperazioneOperation DescrizioneDescription
addadd Aggiunge i dettagli di una rete di Wi-Fi al dispositivo collegato.Adds details of a Wi-Fi network to the attached device.
disabledisable Disabilita una rete Wi-Fi sul dispositivo collegato.Disables a Wi-Fi network on the attached device.
enableenable Abilita una Wi-Fi rete sul dispositivo collegato.Enables a Wi-Fi network on the attached device.
forgetforget Rimuove i dettagli di una rete Wi-Fi dal dispositivo collegato.Removes the details of a Wi-Fi network from the attached device.
listlist Elenca l'attuale configurazione Wi-Fi del dispositivo.Lists the current Wi-Fi configuration for the device.
reload-configreload-config Ricarica la configurazione di rete Wi-Fi sul dispositivo collegato.Reloads the Wi-Fi network configuration on the attached device.
scanscan Esegue la ricerca delle reti disponibili.Scans for available networks.
showshow Mostra i dettagli di una rete Wi-Fi sul dispositivo collegato.Shows details of a Wi-Fi network on the attached device.
show-statusshow-status Mostra lo stato dell'interfaccia Wi-Fi sul dispositivo collegato.Shows the status of the Wi-Fi interface on the attached device.

wifi addwifi add

Aggiunge i dettagli di una rete di Wi-Fi al dispositivo collegato.Adds details of a Wi-Fi network to the attached device.

Un dispositivo può avere più connessioni Wi-Fi.A device can have multiple Wi-Fi connections. Anche se per i nomi delle reti è possibile immettere caratteri non ASCII, azsphere non li visualizza correttamente.Although you can input non-ASCII characters in SSIDs, azsphere does not display them properly. È possibile includere il --targeted-scan parametro per connettersi a SSID nascosti.You can include the --targeted-scan parameter to connect to hidden SSIDs. Per ulteriori informazioni, vedere la pagina relativa alla connessione Azure Sphere al Wi-Fi.For more information see, Connect Azure Sphere to Wi-Fi.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-s,--SSID-s, --ssid stringString Specifica l'identificatore SSID della rete.Specifies the SSID of the network. I SSID distinguono tra maiuscole e minuscole.Network SSIDs are case-sensitive. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-p,--PSK-p, --psk stringString Specifica la chiave WPA o WPA2 per la nuova rete.Specifies the WPA/WPA2 key for the new network. Omettere per aggiungere l'SSID come una rete aperta.Omit to add the SSID as an open network. Se la chiave contiene una e commerciale (&), racchiudere la chiave tra virgolette.If your key contains an ampersand (&), enclose the key in quotation marks. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta
-CC,--clientcertid-cc, --clientcertid stringString [EAP-TLS] Specifica una stringa (fino a 16 caratteri) che identifica il certificato client (contenente sia la chiave pubblica che quella privata).[EAP-TLS] Specifies a string (up to 16 characters) that identifies the client certificate (containing both the public and private key). Obbligatorio per configurare una rete EAP-TLS.Required to set up an EAP-TLS network. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-cid, --clientid -cid, --clientid User@domain [EAP-TLS] Specifica l'ID riconosciuto per l'autenticazione da parte del server RADIUS della rete.[EAP-TLS] Specifies the ID recognized for authentication by the network's RADIUS server. Obbligatorio per alcune reti EAP-TLS.Required for some EAP-TLS networks. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-CN,--configName-cn, --configname stringString Specifica una stringa (fino a 16 caratteri) che specifica il nome della configurazione di rete.Specifies a string (up to 16 characters) that specifies the name for the network configuration. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is required only when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-CA,--rootcacertid-ca, --rootcacertid stringString [EAP-tLS] Specifica una stringa (fino a 16 caratteri) che identifica il certificato della CA radice del server per le reti EAP-TLS in cui il dispositivo esegue l'autenticazione del server.[EAP-tLS] Specifies a string (up to 16 characters) that identifies the server's root CA certificate for EAP-TLS networks where the device authenticates the server. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-t, --targeted-scan-t, --targeted-scan - Prova a connettersi a una rete anche quando questa non trasmette o è nascosta dalla congestione della rete.Attempts to connect to a network even when it is not broadcasting or is hidden by network congestion. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
--client-Cert-ID--client-cert-id stringString [EAP-TLS] Specifica una stringa (fino a 16 caratteri) che identifica il certificato client (contenente sia la chiave pubblica che quella privata).[EAP-TLS] Specifies a string (up to 16 characters) that identifies the client certificate (containing both the public and private key). Obbligatorio per configurare una rete EAP-TLS.Required to set up an EAP-TLS network. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
--client-ID--client-id User@domain [EAP-TLS] Specifica l'ID riconosciuto per l'autenticazione da parte del server RADIUS della rete.[EAP-TLS] Specifies the ID recognized for authentication by the network's RADIUS server. Obbligatorio per alcune reti EAP-TLS.Required for some EAP-TLS networks. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
--config-Name--config-name stringString Specifica una stringa (fino a 16 caratteri) che specifica il nome della configurazione di rete.Specifies a string (up to 16 characters) that specifies the name for the network configuration. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
--root-CA-Cert-ID--root-ca-cert-id stringString [EAP-tLS] Specifica una stringa (fino a 16 caratteri) che identifica il certificato della CA radice del server per le reti EAP-TLS in cui il dispositivo esegue l'autenticazione del server.[EAP-tLS] Specifies a string (up to 16 characters) that identifies the server's root CA certificate for EAP-TLS networks where the device authenticates the server. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
--Targeted-Scan--targeted-scan - Prova a connettersi a una rete anche quando questa non trasmette o è nascosta dalla congestione della rete.Attempts to connect to a network even when it is not broadcasting or is hidden by network congestion. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi add --ssid MyNetwork --psk myKey123
Add network succeeded:
ID                  : 0
SSID                : MyNetwork
Configuration state : enabled
Connection state    : unknown
Security state      : psk
Targeted scan       : False

Se l'SSID o la chiave di rete includono spazi, racchiudere l’SSID o la chiave tra virgolette.If the network SSID or key has embedded spaces or an ampersand, enclose the SSID or key in quotation marks. Se l'SSID o la chiave includono una virgoletta, usare una barra rovesciata per annullare le virgolette.If the SSID or key includes a quotation mark, use a backslash to escape the quotation mark. Le barre rovesciate non richiedono l'annullamento se fanno parte di un valore.Backslashes do not require escape if they are part of a value. Ad esempio:For example:

azsphere device wifi add --ssid "New SSID" --psk "key \"value\" with quotes"

wifi disablewifi disable

Disabilita una rete Wi-Fi sul dispositivo collegato.Disables a Wi-Fi network on the attached device.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ID-i, --id IntegerInteger Specifica l'ID della rete da disabilitare.Specifies the ID of the network to disable. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta-Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi disable --id 0
Successfully disabled network:
ID                  : 0
SSID                : NETGEAR21-5G
Configuration state : disabled
Connection state    : connected
Security state      : psk
Targeted scan       : False

wifi enablewifi enable

Abilita una Wi-Fi rete sul dispositivo collegato.Enables a Wi-Fi network on the attached device.

Per cambiare rete nel caso in cui ne sia disponibile più di una, disabilitare la rete attualmente connessa prima di abilitare la nuova.To change from one network to another if both are within range, disable the currently connected network before you enable the new network.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ID-i, --id IntegerInteger Specifica l'ID della rete da abilitare.Specifies the ID of the network to enable. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi enable --id 0
Successfully enabled network:
ID                  : 0
SSID                : NETGEAR21-5G
Configuration state : enabled
Connection state    : connected
Security state      : psk
Targeted scan       : False

wifi forgetwifi forget

Rimuove i dettagli di una rete Wi-Fi dal dispositivo collegato.Removes details of a Wi-Fi network from the attached device.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ID-i, --id IntegerInteger Specifica l'ID della rete da eliminare.Specifies the ID of the network to delete. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi forget --id 0
Successfully forgotten network.

wifi listwifi list

Elenca la configurazione del Wi-Fi corrente per il dispositivo collegato.Lists the current Wi-Fi configuration for the attached device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi list
Network list:

ID                  : 0
SSID                : NETGEAR21
Configuration state : enabled
Connection state    : connected
Security state      : psk

ID                  : 1
SSID                : A_WiFi_SSID
Configuration state : enabled
Connection state    : disconnected
Security state      : open

ID                  : 2
SSID                : NETGEAR21-5G
Configuration state : enabled
Connection state    : disconnected
Security state      : psk

ID                  : 3
SSID                : eap-sphere
Configuration state : enabled
Connection state    : disconnected
Security state      : eaptls
Targetd scan        : False
Configuration name  : SampleCfg

wifi reload-configwifi reload-config

Ricarica la configurazione di rete Wi-Fi sul dispositivo collegato.Reloads the Wi-Fi network configuration on the attached device. Usare questo comando dopo l'aggiunta o la rimozione di un certificato (certificato del dispositivo azsphere) per assicurarsi che le reti EAP-TLS usino il contenuto più recente dell'archivio certificati.Use this command after you add or remove a certificate (azsphere device certificate) to ensure that EAP-TLS networks use the most recent contents of the certificate store.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi reload-config
Wi-Fi configuration was successfully reloaded.

wifi scanwifi scan

Consente di cercare le reti Wi-Fi disponibili visibili al dispositivo collegato.Scan for available Wi-Fi networks visible to the attached device. Il comando restituisce fino a 64 Wi-Fi reti, ma il numero di Wi-Fi reti visualizzate può essere limitato da fattori ambientali come la densità dei punti di accesso nell'intervallo.The command will return up to 64 Wi-Fi networks, but the number of Wi-Fi networks displayed may be limited by environmental factors such as the density of access points in range.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You can specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi scan
Scan results:

SSID : NETGEAR21
Security state : psk
BSSID : 44:94:fc:36:c8:65
Signal level : -66
Frequency : 2442

SSID : CenturyLink9303
Security state : psk
BSSID : 58:8b:f3:09:ae:d2
Signal level : -75
Frequency : 2412

SSID : NETGEAR21-5G
Security state : psk
BSSID : 44:94:fc:36:c8:64
Signal level : -86
Frequency : 5765

SSID : belkin.c32
Security state : psk
BSSID : 08:86:3b:0b:cc:32
Signal level : -86
Frequency : 2462

wifi showwifi show

Mostra i dettagli di una rete Wi-Fi sul dispositivo collegato.Shows details of a Wi-Fi network on the attached device.

Parametri obbligatoriRequired parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-i,--ID-i, --id IntegerInteger Specifica l'ID della configurazione di rete da visualizzare.Specifies the ID of the network configuration to show. -Azure Sphere CLI V1- Azure Sphere CLI v1
-Azure Sphere interfaccia della riga di comando v2 beta- Azure Sphere CLI v2 Beta

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi show --id 0
ID                  : 0
SSID                : eap-sphere
Configuration state : enabled
Connection state    : disconnected
Security state      : eaptls
Targeted scan       : False
Configuration name  : SmplNetCfg
CA Cert ID          : SmplRootCACertId
Client Cert ID      : SmplClientCertId
Client identity     : user@azuresphere-test.com

wifi show-statuswifi show-status

Mostra lo stato dell'interfaccia Wi-Fi sul dispositivo collegato.Shows the status of the Wi-Fi interface on the attached device.

Parametri facoltativiOptional parameters

ParametroParameter TipoType DescrizioneDescription Versione supportataSupported version
-ip, --deviceip -ip, --deviceip stringString (Più dispositivi, solo Windows) Specifica l'indirizzo IP del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the IP address of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-l, --devicelocation -l, --devicelocation stringString (Più dispositivi, solo Windows) Specifica l'ID del percorso FTDI del dispositivo da usare per questa operazione.(Multi-device, Windows only) Specifies the FTDI location ID of the device to use for this operation. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. È possibile specificare un indirizzo IP o un percorso del dispositivo.You may specify either a device IP address or device location. INTERFACCIA della riga di comando Azure Sphere V1Azure Sphere CLI v1
-d,--dispositivo-d, --device stringString Specifica il dispositivo in cui eseguire il comando quando sono collegati più dispositivi.Specifies the device to run the command on when multiple devices are attached. Questo parametro è necessario solo quando sono collegati più dispositivi.This is only required when multiple devices are attached. Il dispositivo attualmente collegato viene usato per impostazione predefinita.The currently attached device is used by default. È possibile specificare l'ID, l'indirizzo IP o l'ID connessione locale del dispositivo.You can either specify the ID, IP address, or Local Connection ID of the device. Interfaccia della riga di comando di Azure Sphere v2 BetaAzure Sphere CLI v2 Beta
Parametri globaliGlobal parameters

ParametroParameter DescrizioneDescription
-v, --verbose-v, --verbose Fornisce l'output dettagliato nell'interfaccia della riga di comando Azure Sphere V1Provides verbose output in Azure Sphere CLI v1
-?, --help-?, --help Visualizza la guida del comando in Azure Sphere CLI V1Displays help on the command in Azure Sphere CLI v1

Nota

Se si usa Azure Sphere interfaccia della riga di comando v2 beta, vedere parametri globali per ulteriori informazioni sulle opzioni disponibili.If you are using Azure Sphere CLI v2 Beta, see Global Parameters for more information on available options.

EsempioExample

azsphere device wifi show-status
SSID                : NETGEAR23
Configuration state : enabled
Connection state    : connected
Security state      : psk
Frequency           : 2417
Mode                : station
Key management      : WPA2-PSK
WPA State           : COMPLETED
IP Address          : 192.128.48.1
MAC Address         : be:98:26:be:0d:e0