Condividi tramite

az iot ops connector opcua client

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione azure-iot-ops per l'interfaccia della riga di comando di Azure (versione 2.53.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot ops connector opcua client . Altre informazioni sulle estensioni.

Il gruppo di comandi 'iot ops connector' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Gestire il certificato dell'istanza dell'applicazione client di livello aziendale per OPC UA Broker.

Il connettore per OPC UA usa un singolo certificato dell'istanza dell'applicazione OPC UA per tutte le sessioni stabilite per raccogliere i dati di telemetria dai server OPC UA. Per altre informazioni, vedi https://aka.ms/opcua-certificates.

Comandi

Nome Descrizione Tipo Status
az iot ops connector opcua client add

Aggiungere un certificato dell'istanza dell'applicazione client di livello aziendale.

 Estensione Anteprima
az iot ops connector opcua client remove

Rimuovere il certificato dell'istanza dell'applicazione client dal broker OPC UA.

 Estensione Anteprima
az iot ops connector opcua client show

Mostra i dettagli della risorsa secretsync 'aio-opc-ua-broker-client-certificate'.

 Estensione Anteprima

az iot ops connector opcua client add

Anteprima

Il gruppo di comandi 'iot ops connector' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiungere un certificato dell'istanza dell'applicazione client di livello aziendale.

L'estensione del file di chiave pubblica deve essere .der e l'estensione del file di chiave privata deve essere con estensione pem. Assicurarsi di usare lo stesso nome file per la chiave pubblica e il file di chiave privata. Se non viene trovato, verrà creata la classe secretproviderclass 'opc-ua-connector' e secretsync 'aio-opc-ua-broker-client-certificate'. Il certificato appena aggiunto sostituirà il certificato esistente, se presente.

az iot ops connector opcua client add --application-uri
                                      --instance
                                      --pkf
                                      --private-key-file
                                      --resource-group
                                      --sn
                                      [--overwrite-secret {false, true}]
                                      [--pks]
                                      [--private-key-secret-name]

Esempio

Aggiungere un certificato client.

az iot ops connector opcua client add --instance instance --resource-group instanceresourcegroup --public-key-file "newopc.der" --private-key-file "newopc.pem" --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker"

Aggiungere un certificato client e ignorare la richiesta di conferma della sovrascrittura quando il segreto esiste già.

az iot ops connector opcua client add --instance instance --resource-group instanceresourcegroup --public-key-file "newopc.der" --private-key-file "newopc.pem" --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker" --overwrite-secret

Aggiungere un certificato client con il nome del segreto di chiave pubblica e privata personalizzato.

az iot ops connector opcua client add --instance instance --resource-group instanceresourcegroup --public-key-file "newopc.der" --private-key-file "newopc.pem" --public-key-secret-name public-secret-name --private-key-secret-name private-secret-name --subject-name "aio-opc-opcuabroker" --application-uri "urn:microsoft.com:aio:opc:opcuabroker"

Parametri necessari

--application-uri --au

URI dell'istanza dell'applicazione incorporato nell'istanza dell'applicazione. È possibile trovare il certificato con chiave pubblica.

--instance -i -n

Nome dell'istanza di IoT Operations.

--pkf --public-key-file

File contenente la chiave pubblica del certificato dell'istanza dell'applicazione di livello aziendale nel formato .der. Il nome file verrà usato per generare il nome del segreto della chiave pubblica.

--private-key-file --prkf

File che contiene la chiave privata del certificato dell'istanza dell'applicazione di livello aziendale in formato pem. Il nome file verrà usato per generare il nome del segreto della chiave privata.

--resource-group -g

Gruppo di risorse dell'istanza.

--sn --subject-name

Stringa del nome soggetto incorporata nel certificato dell'istanza dell'applicazione. È possibile trovare il certificato con chiave pubblica.

Parametri facoltativi

--overwrite-secret

Confermare [y]es senza chiedere di sovrascrivere il segreto. se il nome del segreto esiste nell'insieme di credenziali delle chiavi di Azure. Utile per scenari di integrazione continua e automazione.

Valori accettati: false, true
Valore predefinito: False
--pks --public-key-secret-name

Nome del segreto della chiave pubblica nell'insieme di credenziali delle chiavi. Se non specificato, il nome file del certificato verrà usato per generare il nome del segreto.

--private-key-secret-name --prks

Nome del segreto della chiave privata nell'insieme di credenziali delle chiavi. Se non specificato, il nome file del certificato verrà usato per generare il nome del segreto.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot ops connector opcua client remove

Anteprima

Il gruppo di comandi 'iot ops connector' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Rimuovere il certificato dell'istanza dell'applicazione client dal broker OPC UA.

Nota: la rimozione di tutti i certificati dall'archivio certificati client di OPC UA Broker attiverà l'eliminazione della risorsa secretsync 'aio-opc-ua-broker-client-certificate'. Questa operazione attiverà il fallback sul certificato predefinito (basato su cert manager). Questo fallback richiede un aggiornamento dell'estensione aio. Assicurarsi di rimuovere sia la coppia di certificati public(.der) che private(.pem) per evitare il segreto orfano.

az iot ops connector opcua client remove --certificate-names
                                         --instance
                                         --resource-group
                                         [--force {false, true}]
                                         [--include-secrets {false, true}]
                                         [--yes {false, true}]

Esempio

Rimuovere i certificati client dall'archivio certificati client di OPC UA Broker.

az iot ops connector opcua client remove --instance instance --resource-group instanceresourcegroup --certificate-names testcert.der testcert.pem

Rimuovere i certificati client dall'archivio certificati client, inclusa la rimozione del segreto dell'insieme di credenziali delle chiavi correlato.

az iot ops connector opcua client remove --instance instance --resource-group instanceresourcegroup --certificate-names testcert.der testcert.pem --include-secrets

Forzare l'operazione di rimozione dei certificati indipendentemente dagli avvisi. Può causare errori.

az iot ops connector opcua client remove --instance instance --resource-group instanceresourcegroup --certificate-names testcert.der testcert.pem --force

Rimuovere i certificati client dall'archivio certificati client e ignorare la richiesta di conferma per la rimozione.

az iot ops connector opcua client remove --instance instance --resource-group instanceresourcegroup --certificate-names testcert.der testcert.pem --yes

Parametri necessari

--certificate-names --cn

Nomi di certificato separati da spazi da rimuovere. Nota: i nomi sono disponibili nella proprietà della risorsa secretsync corrispondente 'targetKey'.

--instance -i -n

Nome dell'istanza di IoT Operations.

--resource-group -g

Gruppo di risorse dell'istanza.

Parametri facoltativi

--force

Forzare l'esecuzione dell'operazione.

Valori accettati: false, true
Valore predefinito: False
--include-secrets

Indica che il comando deve rimuovere i segreti dell'insieme di credenziali delle chiavi associati ai certificati. Questa opzione eliminerà ed eliminerà i segreti.

Valori accettati: false, true
Valore predefinito: False
--yes -y

Confermare [y]es senza una richiesta. Utile per scenari di integrazione continua e automazione.

Valori accettati: false, true
Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az iot ops connector opcua client show

Anteprima

Il gruppo di comandi 'iot ops connector' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Mostra i dettagli della risorsa secretsync 'aio-opc-ua-broker-client-certificate'.

az iot ops connector opcua client show --instance
                                       --resource-group

Esempio

Mostra i dettagli della risorsa secretsync 'aio-opc-ua-broker-client-certificate'.

az iot ops connector opcua client show --instance instance --resource-group instanceresourcegroup

Parametri necessari

--instance -i -n

Nome dell'istanza di IoT Operations.

--resource-group -g

Gruppo di risorse dell'istanza.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.