Dela via

az iot ops ns device

  • Förhandsgranskning

Note

Den här referensen är en del av azure-iot-ops-tillägget för Azure CLI (version 2.67.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az iot ops ns-enhetskommando . Läs mer om tillägg.

Kommandogruppen "iot ops ns" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hantera enheter i enhetsregistrets namnområden.

Kommandon

Name Description Typ Status
az iot ops ns device create

Skapa en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device delete

Ta bort en enhet från ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device endpoint

Hantera slutpunkter för enheter i enhetsregistrets namnområden.

 Extension Preview
az iot ops ns device endpoint inbound

Hantera inkommande slutpunkter för enheter i enhetsregistrets namnområden.

 Extension Preview
az iot ops ns device endpoint inbound add

Lägg till inkommande slutpunkter till enheter i enhetsregistrets namnområden.

 Extension Preview
az iot ops ns device endpoint inbound add custom

Lägg till en anpassad inkommande slutpunkt till en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device endpoint inbound add media

Lägg till en slutpunkt för inkommande media till en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device endpoint inbound add onvif

Lägg till en inkommande ONVIF-slutpunkt till en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device endpoint inbound add opcua

Lägg till en OPC UA-inkommande slutpunkt till en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device endpoint inbound add rest

Lägg till en inkommande slutpunkt för vila till en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device endpoint inbound list

Visa en lista över inkommande slutpunkter för en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device endpoint inbound remove

Ta bort inkommande slutpunkter från en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device endpoint list

Visa en lista över alla slutpunkter för en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device query

Fråga enheter i enhetsregistrets namnområden.

 Extension Preview
az iot ops ns device show

Visa information om en enhet i ett namnområde för enhetsregistret.

 Extension Preview
az iot ops ns device update

Uppdatera en enhet i ett namnområde för enhetsregistret.

 Extension Preview

az iot ops ns device create

Förhandsgranskning

Kommandogruppen "iot ops ns" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skapa en enhet i ett namnområde för enhetsregistret.

Enheten länkas till en Azure IoT Operations-instans.

az iot ops ns device create --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--manufacturer]
                            [--model]
                            [--os]
                            [--os-version --osv]
                            [--tags]

Exempel

Skapa en enhet med minimal konfiguration

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup

Skapa en enhet med anpassade attribut

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building1 floor=3

Skapa en enhet med information om tillverkare och operativsystem

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --manufacturer "Contoso" --model "Gateway X1" --os "Linux" --os-version "4.15"

Skapa en inaktiverad enhet med taggar

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled --tags environment=test criticality=low

Obligatoriska parametrar

--instance -i

Namnet på Azure IoT Operations-instansen.

--name -n

Namnet på den enhet som ska skapas.

--resource-group -g

Resursgruppen för Azure IoT Operations-instansen.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--attr --custom-attribute

Blankstegsavgränsade nyckel=värdepar som motsvarar ytterligare anpassade attribut för enheten. Den här parametern kan användas mer än en gång.

--disabled

Inaktivera enheten.

Egenskap Värde
Parameter group: Additional Info Arguments
Godkända värden: false, true
--manufacturer

Enhetstillverkaren.

Egenskap Värde
Parameter group: Additional Info Arguments
--model

Enhetsmodell.

Egenskap Värde
Parameter group: Additional Info Arguments
--os

Enhetens operativsystem.

Egenskap Värde
Parameter group: Additional Info Arguments
--os-version --osv

Enhetens operativsystemversion.

Egenskap Värde
Parameter group: Additional Info Arguments
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot ops ns device delete

Förhandsgranskning

Kommandogruppen "iot ops ns" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Ta bort en enhet från ett namnområde för enhetsregistret.

az iot ops ns device delete --instance
                            --name
                            --resource-group
                            [--yes {false, true}]

Exempel

Ta bort en enhet

az iot ops ns device delete --name mydevice --instance myInstance -g myInstanceResourceGroup

Obligatoriska parametrar

--instance -i

Namnet på Azure IoT Operations-instansen.

--name -n

Namnet på den enhet som ska skapas.

--resource-group -g

Resursgruppen för Azure IoT Operations-instansen.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--yes -y

Bekräfta [y]es utan att fråga. Användbart för CI- och automationsscenarier.

Egenskap Värde
Standardvärde: False
Godkända värden: false, true
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot ops ns device query

Förhandsgranskning

Kommandogruppen "iot ops ns" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Fråga enheter i enhetsregistrets namnområden.

Fråga enheter mellan namnområden baserat på olika sökvillkor, inklusive enhetsnamn, tillverkare, modell med mera.

az iot ops ns device query [--cq --custom-query]
                           [--disabled {false, true}]
                           [--instance]
                           [--manufacturer]
                           [--model]
                           [--name]
                           [--os]
                           [--os-version --osv]
                           [--resource-group]

Exempel

Fråga efter enheter i en IoT Operations-instans

az iot ops ns device query --instance myInstance -g myInstanceResourceGroup

Fråga efter en specifik enhet efter namn

az iot ops ns device query --name mydevice

Fråga efter enheter från en specifik tillverkare

az iot ops ns device query --manufacturer "Contoso"

Använda en anpassad fråga för att söka efter enheter

az iot ops ns device query --custom-query "where tags.environment=='production'"

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--cq --custom-query

Anpassad fråga som ska användas. Alla andra frågeargument, förutom instansnamn och resursgrupp, ignoreras.

--disabled

Tillgångstillstånd.

Egenskap Värde
Parameter group: Additional Info Arguments
Godkända värden: false, true
--instance -i

Namnet på Azure IoT Operations-instansen.

--manufacturer

Enhetstillverkaren.

Egenskap Värde
Parameter group: Additional Info Arguments
--model

Enhetsmodell.

Egenskap Värde
Parameter group: Additional Info Arguments
--name -n

Namnet på den enhet som ska skapas.

--os

Enhetens operativsystem.

Egenskap Värde
Parameter group: Additional Info Arguments
--os-version --osv

Enhetens operativsystemversion.

Egenskap Värde
Parameter group: Additional Info Arguments
--resource-group -g

Resursgruppen för Azure IoT Operations-instansen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot ops ns device show

Förhandsgranskning

Kommandogruppen "iot ops ns" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Visa information om en enhet i ett namnområde för enhetsregistret.

az iot ops ns device show --instance
                          --name
                          --resource-group

Exempel

Visa information om en enhet

az iot ops ns device show --name mydevice --instance myInstance -g myInstanceResourceGroup

Obligatoriska parametrar

--instance -i

Namnet på Azure IoT Operations-instansen.

--name -n

Namnet på den enhet som ska skapas.

--resource-group -g

Resursgruppen för Azure IoT Operations-instansen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az iot ops ns device update

Förhandsgranskning

Kommandogruppen "iot ops ns" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Uppdatera en enhet i ett namnområde för enhetsregistret.

az iot ops ns device update --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--os-version --osv]
                            [--tags]

Exempel

Uppdatera anpassade attribut för enheter

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building2 floor=5

Uppdatera operativsystemversion

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --os-version "4.18"

Inaktivera en enhet

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled

Uppdatera enhetstaggar

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --tags environment=production criticality=high

Obligatoriska parametrar

--instance -i

Namnet på Azure IoT Operations-instansen.

--name -n

Namnet på den enhet som ska skapas.

--resource-group -g

Resursgruppen för Azure IoT Operations-instansen.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--attr --custom-attribute

Blankstegsavgränsade nyckel=värdepar som motsvarar ytterligare anpassade attribut för enheten. Den här parametern kan användas mer än en gång.

--disabled

Inaktivera enheten.

Egenskap Värde
Parameter group: Additional Info Arguments
Godkända värden: false, true
--os-version --osv

Enhetens operativsystemversion.

Egenskap Värde
Parameter group: Additional Info Arguments
--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False