az iot central device command

Notitie

Deze referentie maakt deel uit van de azure-iot-extensie voor Azure CLI en vereist versie 2.17.1 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u de opdracht az iot central device de eerste keer gebruikt. Meer informatie over extensies.

Voer apparaatopdrachten uit.

Opdracht

az iot central device command history

Haal de details op voor de meest recente opdrachtaanvraag en het meest recente antwoord dat naar het apparaat is verzonden.

az iot central device command run

Voer een opdracht uit op een apparaat en bekijk het bijbehorende antwoord. De updates van eigenschappen die de opdracht kan uitvoeren, worden NIET bewaakt.

az iot central device command history

Haal de details op voor de meest recente opdrachtaanvraag en het meest recente antwoord dat naar het apparaat is verzonden.

Een lijst met de meest recente opdrachtaanvraag en het meest recente antwoord dat naar het apparaat is verzonden vanuit IoT Central. Elke update die het apparaat uitvoert naar de apparaateigenschappen als gevolg van de uitvoering van de opdracht, wordt niet opgenomen in het antwoord.

az iot central device command history --app-id
                                      --cn
                                      --device-id
                                      [--api-version {1.0, preview}]
                                      [--central-api-uri]
                                      [--interface-id]
                                      [--token]

Voorbeelden

Opdrachtreactie tonen

az iot central device command history --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname}

Vereiste parameters

--app-id -n

De app-id van de IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.

--cn --command-name

De naam van de opdracht zoals opgegeven in de apparaatsjabloon. De naam van de opdracht kan verschillen van de weergavenaam van de opdracht.

--device-id -d

De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op de knop Verbinding maken apparaatdetails op de pagina Apparaatdetails.

Optionele parameters

--api-version --av

De API-versie voor de aangevraagde bewerking.

geaccepteerde waarden: 1.0, preview
standaardwaarde: 1.0
--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--interface-id -i

De naam van de interface/het onderdeel zoals opgegeven in de apparaatsjabloon. U vindt deze door te navigeren naar Apparaatsjabloon en de interface-/onderdeel-id onder de bijbehorende apparaatmogelijkheid weer te geven.

--token

Als u uw aanvraag liever indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruiker-token opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi .

az iot central device command run

Voer een opdracht uit op een apparaat en bekijk het bijbehorende antwoord. De updates van eigenschappen die de opdracht kan uitvoeren, worden NIET bewaakt.

Opmerking: nettolading moet worden genest onder 'aanvraag'. Dat wil zeggen dat als uw apparaat de nettolading in een vorm verwacht {"sleutel": "waarde"} nettolading {"request": {"key": "value"}} moet zijn. --content kan ook worden gericht op een bestandspad zoals dit (.../path/to/payload.json).

az iot central device command run --app-id
                                  --cn
                                  --content
                                  --device-id
                                  [--api-version {1.0, preview}]
                                  [--central-api-uri]
                                  [--interface-id]
                                  [--token]

Voorbeelden

Opdrachtreactie uitvoeren

az iot central device command run --app-id {appid} --device-id {deviceid} --interface-id {interfaceid} --command-name {commandname} --content {payload}

Korte-runopdrachtreactie

az iot central device command run -n {appid} -d {deviceid} -i {interfaceid} --cn {commandname} -k {payload}

Vereiste parameters

--app-id -n

De app-id van de IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.

--cn --command-name

De naam van de opdracht zoals opgegeven in de apparaatsjabloon. De naam van de opdracht kan verschillen van de weergavenaam van de opdracht.

--content -k

Configuratie voor aanvraag. Geef het pad op naar het JSON-bestand of onbewerkte JSON met tekenreeks. [Bestandspadvoorbeeld: ./path/to/file.json] [Stringified JSON Example: {'a': 'b'}].

--device-id -d

De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op de knop Verbinding maken apparaatdetails op de pagina Apparaatdetails.

Optionele parameters

--api-version --av

De API-versie voor de aangevraagde bewerking.

geaccepteerde waarden: 1.0, preview
standaardwaarde: 1.0
--central-api-uri --central-dns-suffix

Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.

standaardwaarde: azureiotcentral.com
--interface-id -i

De naam van de interface/het onderdeel zoals opgegeven in de apparaatsjabloon. U vindt deze door te navigeren naar Apparaatsjabloon en de interface-/onderdeel-id onder de bijbehorende apparaatmogelijkheid weer te geven.

--token

Als u uw aanvraag liever indient zonder verificatie bij de Azure CLI, kunt u een geldig gebruiker-token opgeven om uw aanvraag te verifiëren. U moet het type sleutel opgeven als onderdeel van de aanvraag. Meer informatie op https://aka.ms/iotcentraldocsapi .