Delen via


az iot ops connector opcua client

Notitie

Deze verwijzing maakt deel uit van de azure-iot-ops-extensie voor de Azure CLI (versie 2.53.0 of hoger). De extensie installeert automatisch de eerste keer dat u een opcua-clientopdracht az iot ops connector uitvoert. Meer informatie over extensies.

De opdrachtgroep 'iot ops connector' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Beheer het exemplaarcertificaat van clienttoepassing op bedrijfsniveau voor de OPC UA Broker.

De connector voor OPC UA maakt gebruik van één OPC UA-toepassingsexemplarencertificaat voor alle sessies die worden gemaakt voor het verzamelen van telemetriegegevens van OPC UA-servers. Zie voor meer informatie https://aka.ms/opcua-certificates.

Opdracht

Name Description Type Status
az iot ops connector opcua client add

Voeg een certificaat voor clienttoepassingsexemplaren op bedrijfsniveau toe.

Toestel Preview uitvoeren
az iot ops connector opcua client remove

Verwijder het exemplaarcertificaat van de clienttoepassing uit de OPC UA Broker.

Toestel Preview uitvoeren
az iot ops connector opcua client show

Details weergeven van secretsync-resource 'aio-opc-ua-broker-client-certificate'.

Toestel Preview uitvoeren

az iot ops connector opcua client add

Preview

De opdrachtgroep 'iot ops connector' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Voeg een certificaat voor clienttoepassingsexemplaren op bedrijfsniveau toe.

De bestandsextensie openbare sleutel moet .der zijn en de bestandsextensie persoonlijke sleutel moet .pem zijn. Zorg ervoor dat u dezelfde bestandsnaam gebruikt voor een openbare sleutel en een persoonlijk sleutelbestand. Azure resource secretproviderclass 'opc-ua-connector' en secretsync 'aio-opc-ua-broker-client-certificate' wordt gemaakt als dit niet wordt gevonden. Het zojuist toegevoegde certificaat vervangt het bestaande certificaat indien aanwezig.

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]

Voorbeelden

Voeg een clientcertificaat toe.

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"

Voeg een clientcertificaat toe en sla de bevestigingsprompt overschrijven over wanneer het geheim al bestaat.

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

Voeg een clientcertificaat toe met een aangepaste geheime naam voor openbare en persoonlijke sleutels.

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"

Vereiste parameters

--application-uri --au

De URI van het toepassingsexemplaren die is ingesloten in het toepassingsexemplaren. U vindt deze onder het certificaat van de openbare sleutel.

--instance -i -n

Naam ioT Operations-exemplaar.

--pkf --public-key-file

Bestand met de openbare sleutel van het toepassingsexemplaren van bedrijfsniveau in .der-indeling. Bestandsnaam wordt gebruikt om de geheime naam van de openbare sleutel te genereren.

--private-key-file --prkf

Bestand dat de persoonlijke sleutel voor het certificaatcertificaat van het zakelijke toepassingsexemplaren bevat in pem-indeling. Bestandsnaam wordt gebruikt om de geheime naam van de persoonlijke sleutel te genereren.

--resource-group -g

Resourcegroep exemplaar.

--sn --subject-name

De tekenreeks met de onderwerpnaam die is ingesloten in het certificaat van het toepassingsexemplaren. U vindt deze onder het certificaat van de openbare sleutel.

Optionele parameters

--overwrite-secret

Bevestig [y]s zonder een prompt om het geheim te overschrijven. als de geheime naam bestond in Azure Key Vault. Handig voor CI- en automatiseringsscenario's.

Geaccepteerde waarden: false, true
Default value: False
--pks --public-key-secret-name

De naam van het geheim van de openbare sleutel in de sleutelkluis. Als deze niet is opgegeven, wordt de naam van het certificaatbestand gebruikt om de geheime naam te genereren.

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

De geheime naam van de persoonlijke sleutel in de sleutelkluis. Als deze niet is opgegeven, wordt de naam van het certificaatbestand gebruikt om de geheime naam te genereren.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot ops connector opcua client remove

Preview

De opdrachtgroep 'iot ops connector' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Verwijder het exemplaarcertificaat van de clienttoepassing uit de OPC UA Broker.

Opmerking: als u alle certificaten verwijdert uit het clientcertificaatarchief van OPC UA Broker, wordt het verwijderen van de secretsync-resource 'aio-opc-ua-broker-client-certificate' geactiveerd. En met deze bewerking wordt de terugval naar het standaardcertificaat (op basis van certificaatbeheer) geactiveerd. Voor deze terugval is een aio-extensie-update vereist. Zorg ervoor dat u zowel openbaar(.der) als een persoonlijk(.pem)-sleutelcertificaatpaar verwijdert om zwevend geheim te voorkomen.

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

Voorbeelden

Verwijder clientcertificaten uit het clientcertificaatarchief van OPC UA Broker.

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

Verwijder clientcertificaten uit het clientcertificaatarchief, inclusief het verwijderen van gerelateerd sleutelkluisgeheim.

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

Forceer het verwijderen van certificaten, ongeacht waarschuwingen. Kan leiden tot fouten.

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

Verwijder clientcertificaten uit het clientcertificaatarchief en sla de bevestigingsprompt voor verwijdering over.

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

Vereiste parameters

--certificate-names --cn

Door spaties gescheiden certificaatnamen die moeten worden verwijderd. Opmerking: de namen vindt u onder de bijbehorende secretsync-resourceeigenschap targetKey.

--instance -i -n

Naam ioT Operations-exemplaar.

--resource-group -g

Resourcegroep exemplaar.

Optionele parameters

--force

Dwing de bewerking uit te voeren.

Geaccepteerde waarden: false, true
Default value: False
--include-secrets

Geeft aan dat de opdracht de sleutelkluisgeheimen moet verwijderen die zijn gekoppeld aan de certificaten. Met deze optie worden de geheimen verwijderd en verwijderd.

Geaccepteerde waarden: false, true
Default value: False
--yes -y

Bevestig [y]s zonder prompt. Handig voor CI- en automatiseringsscenario's.

Geaccepteerde waarden: false, true
Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az iot ops connector opcua client show

Preview

De opdrachtgroep 'iot ops connector' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Details weergeven van secretsync-resource 'aio-opc-ua-broker-client-certificate'.

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

Voorbeelden

Details weergeven van secretsync-resource 'aio-opc-ua-broker-client-certificate'.

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

Vereiste parameters

--instance -i -n

Naam ioT Operations-exemplaar.

--resource-group -g

Resourcegroep exemplaar.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.