az iot du device group
Notitie
Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.37.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az iot du device group-opdracht uitvoert. Meer informatie over extensies.
Apparaatgroepbeheer.
Een apparaatgroep is een verzameling apparaten. Apparaatgroepen bieden een manier om implementaties naar veel apparaten te schalen. Elk apparaat behoort tot precies één apparaatgroep tegelijk. Er wordt automatisch een apparaatgroep gemaakt wanneer een apparaat met apparaatupdate is verbonden met de hub en de eigenschappen rapporteert.
Opdracht
| Name | Description | Type | Status |
|---|---|---|---|
| az iot du device group delete |
Een apparaatgroep verwijderen. |
Toestel | GA |
| az iot du device group list |
Apparaatgroepen binnen een exemplaar weergeven. |
Toestel | GA |
| az iot du device group show |
Details weergeven over een apparaatgroep, inclusief de beste update- en updatecompatibiliteit. |
Toestel | GA |
az iot du device group delete
Een apparaatgroep verwijderen.
Apparaatgroepen worden niet automatisch opgeschoond, maar worden bewaard voor geschiedenisdoeleinden. Deze bewerking kan worden gebruikt als de groep niet nodig is of de geschiedenis hiervoor moet behouden. Als een apparaat ooit opnieuw is verbonden voor een groep nadat de groep is verwijderd, wordt het automatisch opnieuw gemaakt zonder geschiedenis.
az iot du device group delete --account
--gid
--instance
[--resource-group]
[--yes {false, true}]Voorbeelden
Een apparaatgroep verwijderen.
az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id}Verwijder een apparaatgroep die de bevestigingsprompt overslaat.
az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id} -yVereiste parameters
Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.
Apparaatgroep-id. Dit wordt gemaakt op basis van de waarde van de ADUGroup-tag in de apparaat-/moduledubbel van de verbonden IoT Hub of $default voor apparaten zonder tag.
De naam van het apparaatupdate-exemplaar. U kunt de naam van het standaardexemplaren configureren met behulp van az config set defaults.adu_instance=<name>.
Optionele parameters
Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.
Gebruikersprompts overslaan. Geeft de acceptatie van de actie aan. Wordt voornamelijk gebruikt voor automatiseringsscenario's. Standaard: onwaar.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az iot du device group list
Apparaatgroepen binnen een exemplaar weergeven.
az iot du device group list --account
--instance
[--order-by]
[--resource-group]Voorbeelden
Apparaatgroepen weergeven.
az iot du device group list -n {account_name} -i {instance_name}Vermeld apparaatgroepen in een gewenste volgorde, in dit geval per deviceCount.
az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCountVereiste parameters
Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.
De naam van het apparaatupdate-exemplaar. U kunt de naam van het standaardexemplaren configureren met behulp van az config set defaults.adu_instance=<name>.
Optionele parameters
Hiermee wordt de set geretourneerde groepen besteld. U kunt bestellen op groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount of subgroupsWithOnLatestUpdateCount.
Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az iot du device group show
Details weergeven over een apparaatgroep, inclusief de beste update- en updatecompatibiliteit.
az iot du device group show --account
--gid
--instance
[--best-updates {false, true}]
[--resource-group]
[--update-compliance {false, true}]Voorbeelden
Een apparaatgroep weergeven.
az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id}De beste updates weergeven die beschikbaar zijn voor een apparaatgroep. Met deze vlag wordt de opdracht gewijzigd om een lijst te retourneren.
az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updatesUpdatecompatibiliteit voor een apparaatgroep weergeven.
az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --update-complianceVereiste parameters
Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.
Apparaatgroep-id. Dit wordt gemaakt op basis van de waarde van de ADUGroup-tag in de apparaat-/moduledubbel van de verbonden IoT Hub of $default voor apparaten zonder tag.
De naam van het apparaatupdate-exemplaar. U kunt de naam van het standaardexemplaren configureren met behulp van az config set defaults.adu_instance=<name>.
Optionele parameters
Vlag die aangeeft dat de opdracht de beste beschikbare updates voor de apparaatgroep moet ophalen, inclusief het aantal apparaten dat elke update nodig heeft. Een beste update is de nieuwste update die voldoet aan alle compatibiliteitsspecificaties van een apparaatklasse.
Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.
Vlag die aangeeft dat de opdracht nalevingsinformatie voor apparaatgroepen moet ophalen, zoals hoeveel apparaten de meest recente update hebben, hoeveel nieuwe updates nodig zijn en hoeveel er worden uitgevoerd bij het ontvangen van een nieuwe update.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor