az iot central enrollment-group
Nota
Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot central enrollment-group . Altre informazioni sulle estensioni.
Gestire e configurare il gruppo di registrazione IoT Central.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az iot central enrollment-group create |
Creare un gruppo di registrazione. |
Estensione | Disponibilità generale |
| az iot central enrollment-group delete |
Eliminare un gruppo di registrazione in base all'ID. |
Estensione | Disponibilità generale |
| az iot central enrollment-group generate-verification-code |
Generare un codice di verifica per il certificato x509 primario o secondario di un gruppo di registrazione. |
Estensione | Disponibilità generale |
| az iot central enrollment-group list |
Ottenere l'elenco dei gruppi di registrazione in un'applicazione. |
Estensione | Disponibilità generale |
| az iot central enrollment-group show |
Ottenere informazioni dettagliate su un gruppo di registrazioni in base all'ID. |
Estensione | Disponibilità generale |
| az iot central enrollment-group update |
Aggiornare un gruppo di registrazione. |
Estensione | Disponibilità generale |
| az iot central enrollment-group verify-certificate |
Verificare il certificato x509 primario o secondario di un gruppo di registrazione. |
Estensione | Disponibilità generale |
az iot central enrollment-group create
Creare un gruppo di registrazione.
az iot central enrollment-group create --app-id
--at {symmetricKey, x509}
--display-name
--group-id
--type
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--certificate-path]
[--etag]
[--pk]
[--provisioning-status {disabled, enabled}]
[--scp]
[--secondary-key]
[--token]Esempio
Creare un gruppo di registrazioni
az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at {attestation} --display-name {displayName} --type {type}Creare un gruppo di registrazioni con certificazione primaria x509
az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at 'x509' --display-name {displayName} --type {type} --cp {primayCertPath}Creare un gruppo di registrazione con la certificazione chiave simmetrica specificata
az iot central enrollment-group create --app-id {appid} --id {enrollmentGroupId} --at 'symmetricKey' --display-name {displayName} --type {type} --pk {primaryKey} --sk {secondaryKey}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
Meccanismo di attestazione per il gruppo di registrazioni. Sono consentiti solo 'x509' o 'symmetricKey'. Per impostazione predefinita, 'symmetricKey' verrà usato per l'attestazione.
Nome visualizzato del gruppo di registrazione.
Identificatore univoco per il gruppo di registrazione.
Tipo di dispositivi che si connettono tramite il gruppo.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Percorso del file contenente il certificato primario.
Tag Etag o tag di entità corrispondente all'ultimo stato della risorsa. Se non viene specificato alcun etag, viene usato il valore '*'.
Chiave di accesso condiviso simmetrica primaria archiviata in formato Base64.
Indica se i dispositivi che usano il gruppo possono connettersi a IoT Central. Vero o falso.
Percorso del file contenente il certificato secondario.
Chiave di accesso condiviso simmetrica secondaria archiviata in formato Base64.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central enrollment-group delete
Eliminare un gruppo di registrazione in base all'ID.
az iot central enrollment-group delete --app-id
--group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Esempio
Eliminare un gruppo di registrazione in base all'ID
az iot central enrollment-group delete --app-id {appid} --id {enrollmentGroupId}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
Identificatore univoco per il gruppo di registrazione.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central enrollment-group generate-verification-code
Generare un codice di verifica per il certificato x509 primario o secondario di un gruppo di registrazione.
az iot central enrollment-group generate-verification-code --app-id
--group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--certificate-entry {primary, secondary}]
[--token]Esempio
Generare un codice di verifica per il certificato x509 primario di un gruppo di registrazione
az iot central enrollment-group generate-verification-code --app-id {appid} --id {enrollmentGroupId} --entry 'primary'Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
Identificatore univoco per il gruppo di registrazione.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Tipo di voce del certificato x509 che consente solo 'primary' e 'secondary'.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central enrollment-group list
Ottenere l'elenco dei gruppi di registrazione in un'applicazione.
az iot central enrollment-group list --app-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Esempio
Ottenere l'elenco dei gruppi di registrazione in un'applicazione
az iot central enrollment-group list --app-id {appid}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central enrollment-group show
Ottenere informazioni dettagliate su un gruppo di registrazioni in base all'ID.
az iot central enrollment-group show --app-id
--group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--certificate-entry {primary, secondary}]
[--token]Esempio
Ottenere informazioni dettagliate su un gruppo di registrazione in base all'ID
az iot central enrollment-group show --app-id {appid} --id {enrollmentGroupId}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
Identificatore univoco per il gruppo di registrazione.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Tipo di voce del certificato x509 che consente solo 'primary' e 'secondary'.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central enrollment-group update
Aggiornare un gruppo di registrazione.
az iot central enrollment-group update --app-id
--group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--certificate-entry {primary, secondary}]
[--certificate-path]
[--display-name]
[--etag]
[--provisioning-status {disabled, enabled}]
[--remove-x509 {false, true}]
[--scp]
[--token]
[--type]Esempio
Aggiornare un gruppo di registrazione
az iot central enrollment-group update --app-id {appid} --id {enrollmentGroupId} --display-name {displayName} --type {type} --ps {enabled}Rimuovere il certificato primario x509 da un gruppo di registrazioni
az iot central enrollment-group update --app-id {appid} --id {enrollmentGroupId} --remove-x509 'true' --entry 'primary'Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
Identificatore univoco per il gruppo di registrazione.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Tipo di voce del certificato x509 che consente solo 'primary' e 'secondary'.
Percorso del file contenente il certificato primario.
Nome visualizzato del gruppo di registrazione.
ETag usato per evitare conflitti negli aggiornamenti del gruppo di registrazione.
Indica se i dispositivi che usano il gruppo possono connettersi a IoT Central. Vero o falso.
Indica se il certificato x509 deve essere rimosso dal gruppo. Vero o falso.
Percorso del file contenente il certificato secondario.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Tipo di dispositivi che si connettono tramite il gruppo.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az iot central enrollment-group verify-certificate
Verificare il certificato x509 primario o secondario di un gruppo di registrazione.
Verificare il certificato x509 primario o secondario di un gruppo di registrazioni fornendo un certificato con il codice di verifica firmato.
Si noti che se un gruppo di registrazione è stato creato con un certificato x509 non verificato, è necessario creare un certificato di verifica usando il certificato x509 non verificato e un codice di verifica prima di usare questo comando. È possibile generare un codice di verifica tramite l'interfaccia della riga di comando usando il comando 'enrollment-group generate-verification-code'. Altre informazioni su come creare certificati di verifica usando il codice di verifica all'indirizzo https://learn.microsoft.com/en-us/azure/iot-central/core/how-to-connect-devices-x509.
az iot central enrollment-group verify-certificate --app-id
--group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--certificate-path]
[--scp]
[--token]Esempio
Verificare il certificato x509 primario di un gruppo di registrazione
az iot central enrollment-group verify-certificate --app-id {appid} --id {enrollmentGroupId} --cp {primayCertPath}Parametri necessari
ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.
Identificatore univoco per il gruppo di registrazione.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.
Suffisso DNS di IoT Central associato all'applicazione.
Percorso del file contenente il certificato primario.
Percorso del file contenente il certificato secondario.
Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
