az iot du device group

Notitie

Deze verwijzing maakt deel uit van de Azure-iot-extensie voor de Azure CLI (versie 2.46.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} -y

Vereiste parameters

--account -n

Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.

--gid --group-id

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.

--instance -i

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

--resource-group -g

Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.

--yes -y

Gebruikersprompts overslaan. Geeft de acceptatie van de actie aan. Wordt voornamelijk gebruikt voor automatiseringsscenario's. Standaard: onwaar.

Geaccepteerde waarden: false, true

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 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 deviceCount

Vereiste parameters

--account -n

Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.

--instance -i

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

--order-by

Hiermee wordt de set geretourneerde groepen besteld. U kunt bestellen op groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount of subgroupsWithOnLatestUpdateCount.

--resource-group -g

Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.

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 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-updates

Updatecompatibiliteit voor een apparaatgroep weergeven.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --update-compliance

Vereiste parameters

--account -n

Accountnaam voor apparaatupdate. U kunt de standaardaccountnaam configureren met behulp van az config set defaults.adu_account=<name>.

--gid --group-id

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.

--instance -i

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

--best-updates

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.

Geaccepteerde waarden: false, true

--resource-group -g

Resourcegroepnaam voor apparaatupdate-account. U kunt de standaardgroep configureren met behulp van az config set defaults.adu_group=<name>.

--update-compliance

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.

Geaccepteerde waarden: false, true

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.