az iot central device
Notitie
Deze verwijzing 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 voor het eerst gebruikt. Meer informatie over extensies.
Beheer en configureer IoT Central apparaten.
Opdracht
| az iot central device command |
Voer apparaatopdrachten uit. |
| 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 compute-device-key |
Genereer een AFGELEIDE SAS-sleutel voor het apparaat. |
| az iot central device create |
Maak een apparaat in IoT Central. |
| az iot central device delete |
Verwijder een apparaat uit IoT Central. |
| az iot central device manual-failback |
De eerder uitgevoerde failover-opdracht wordt terugverdraaid door het apparaat terug te verplaatsen naar de oorspronkelijke IoT Hub. |
| az iot central device manual-failover |
Voer een handmatige failover van het apparaat uit op meerdere IoT Hubs om te valideren of de apparaatfirmware opnieuw verbinding kan maken met behulp van DPS met een IoT Hub. |
| az iot central device registration-info |
U kunt registratiegegevens op een of meer apparaten op IoT Central. |
| az iot central device show |
Haal een apparaat op uit IoT Central. |
| az iot central device show-credentials |
Haal apparaatreferenties op uit IoT Central. |
| az iot central device twin |
Apparaattweeling IoT Central beheren. |
| az iot central device twin show |
Haal de apparaat dubbel op uit IoT Hub. |
az iot central device compute-device-key
Genereer een AFGELEIDE SAS-sleutel voor het apparaat.
Genereer een afgeleide apparaatsleutel op basis van een SAS-sleutel op groepsniveau.
az iot central device compute-device-key --device-id
--pk
Voorbeelden
Basisgebruik
az iot central device compute-device-key --pk {primaryKey} --device-id {deviceid}
Vereiste parameters
De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op Verbinding maken knop Apparaatdetails.
De primaire symmetrische gedeelde toegangssleutel die is opgeslagen in base64-indeling.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot central device create
Maak een apparaat in IoT Central.
az iot central device create --app-id
--device-id
[--api-version {1.0, preview}]
[--central-api-uri]
[--device-name]
[--simulated {false, true}]
[--template]
[--token]
Voorbeelden
Een apparaat maken
az iot central device create --app-id {appid} --device-id {deviceid}
Een gesimuleerd apparaat maken
az iot central device create --app-id {appid} --device-id {deviceid} --template {devicetemplateid} --simulated
Vereiste parameters
De app-id van IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.
Geef een unieke id op voor het apparaat. Een hoofd-gevoelige tekenreeks (maximaal 128 tekens lang) van 7-bits ASCII-alfanumerieke tekens plus bepaalde speciale tekens: - . + % _ # * ? ! ( ) , : = @ $ '.
Optionele parameters
De API-versie voor de aangevraagde bewerking.
Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.
Door mensen leesbare apparaatnaam. Voorbeeld: Gededer.
Voeg deze vlag toe als u dit IoT Central als een gesimuleerd apparaat wilt instellen. --template is vereist als dit waar is.
Centrale sjabloon-id. Voorbeeld: dtmi:hebtpkindbz:modelDefinition:iild3tm_uo.
Als u uw aanvraag liever indient zonder verificatie met 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 .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot central device delete
Verwijder een apparaat uit IoT Central.
az iot central device delete --app-id
--device-id
[--api-version {1.0, preview}]
[--central-api-uri]
[--token]
Voorbeelden
Een apparaat verwijderen
az iot central device delete --app-id {appid} --device-id {deviceid}
Vereiste parameters
De app-id van IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.
De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op Verbinding maken knop Apparaatdetails.
Optionele parameters
De API-versie voor de aangevraagde bewerking.
Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.
Als u uw aanvraag liever indient zonder verificatie met 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 .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot central device manual-failback
De eerder uitgevoerde failover-opdracht wordt terugverdraaid door het apparaat terug te verplaatsen naar de oorspronkelijke IoT Hub.
Ga naar voor meer informatie over hoge https://github.com/iot-for-all/iot-central-high-availability-clients#readme beschikbaarheid.
az iot central device manual-failback --app-id
--device-id
[--central-api-uri]
[--token]
Voorbeelden
De eerder uitgevoerde failover-opdracht wordt terugverdraaid door het apparaat terug te verplaatsen naar de oorspronkelijke IoT Hub
az iot central device manual-failback --app-id {appid} --device-id {deviceid}
Vereiste parameters
De app-id van IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.
De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op Verbinding maken knop Apparaatdetails.
Optionele parameters
Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.
Als u uw aanvraag liever indient zonder verificatie met 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 .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot central device manual-failover
Voer een handmatige failover van het apparaat uit op meerdere IoT Hubs om te valideren of de apparaatfirmware opnieuw verbinding kan maken met behulp van DPS met een IoT Hub.
Ga voor meer informatie over hoge beschikbaarheid en standaardwaarde voor ttl-minuten naar https://github.com/iot-for-all/iot-central-high-availability-clients#readme .
az iot central device manual-failover --app-id
--device-id
[--central-api-uri]
[--token]
[--ttl]
Voorbeelden
Voer een handmatige failover van het apparaat uit op meerdere IoT Hubs om te valideren of de apparaatfirmware opnieuw verbinding kan maken met behulp van DPS met een IoT Hub.
az iot central device manual-failover --app-id {appid} --device-id {deviceid} --ttl-minutes {ttl_minutes}
Vereiste parameters
De app-id van IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.
De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op Verbinding maken knop Apparaatdetails.
Optionele parameters
Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.
Als u uw aanvraag liever indient zonder verificatie met 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 .
Een positief geheel getal. TTL in minuten om het apparaat terug te verplaatsen naar de oorspronkelijke hub. Heeft een standaardwaarde in de back-end. Zie de documentatie over wat de meest recente standaardwaarde voor time to live van de back-end is door naar te https://github.com/iot-for-all/iot-central-high-availability-clients#readme gaan.
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot central device registration-info
U kunt registratiegegevens op een of meer apparaten op IoT Central.
Opmerking: het kan een aanzienlijke hoeveelheid tijd duren om deze opdracht te retourneren als er geen apparaat-id is opgegeven en uw app veel apparaten bevat.
az iot central device registration-info --app-id
--device-id
[--central-api-uri]
[--token]
Voorbeelden
Registratiegegevens op het opgegeven apparaat op halen
az iot central device registration-info --app-id {appid} --device-id {deviceid}
Vereiste parameters
De app-id van IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.
De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op Verbinding maken knop Apparaatdetails.
Optionele parameters
Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.
Als u uw aanvraag liever indient zonder verificatie met 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 .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot central device show
Haal een apparaat op uit IoT Central.
az iot central device show --app-id
--device-id
[--api-version {1.0, preview}]
[--central-api-uri]
[--token]
Voorbeelden
Een apparaat krijgen
az iot central device show --app-id {appid} --device-id {deviceid}
Vereiste parameters
De app-id van IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.
De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op Verbinding maken knop Apparaatdetails.
Optionele parameters
De API-versie voor de aangevraagde bewerking.
Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.
Als u uw aanvraag liever indient zonder verificatie met 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 .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
az iot central device show-credentials
Haal apparaatreferenties op uit IoT Central.
az iot central device show-credentials --app-id
--device-id
[--central-api-uri]
[--token]
Voorbeelden
Apparaatreferenties voor een apparaat op halen
az iot central device show-credentials --app-id {appid} --device-id {deviceid}
Vereiste parameters
De app-id van IoT Central app die u wilt beheren. U vindt de app-id op de pagina Over voor uw toepassing onder het Help-menu.
De id van het doelapparaat. U kunt de apparaat-id vinden door te klikken op Verbinding maken knop Apparaatdetails.
Optionele parameters
Het IoT Central DNS-achtervoegsel dat is gekoppeld aan uw toepassing. De standaardwaarde is: azureiotcentral.com.
Als u uw aanvraag liever indient zonder verificatie met 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 .
Vergroot de logboekbebossing om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.