Dela via

az iot du device group

  • Referens

Kommentar

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

Hantering av enhetsgrupp.

En enhetsgrupp är en samling enheter. Enhetsgrupper är ett sätt att skala distributioner till många enheter. Varje enhet tillhör exakt en enhetsgrupp i taget. En enhetsgrupp skapas automatiskt när en enhet som är aktiverad för enhetsuppdatering är ansluten till hubben och rapporterar dess egenskaper.

Kommandon

Name Description Typ Status
az iot du device group delete

Ta bort en enhetsgrupp.

 Anknytning Allmän tillgänglighet
az iot du device group list

Visa en lista över enhetsgrupper i en instans.

 Anknytning Allmän tillgänglighet
az iot du device group show

Visa information om en enhetsgrupp, inklusive den bästa uppdaterings- och uppdateringsefterlevnaden.

 Anknytning Allmän tillgänglighet

az iot du device group delete

Ta bort en enhetsgrupp.

Enhetsgrupper rensas inte automatiskt utan behålls i historiksyfte. Den här åtgärden kan användas om det inte finns något behov av gruppen eller behöver behålla historiken för den. Om en enhet någonsin ansluts igen för en grupp efter att gruppen har tagits bort skapas den automatiskt igen utan historik.

az iot du device group delete --account
                              --gid
                              --instance
                              [--resource-group]
                              [--yes {false, true}]

Exempel

Ta bort en enhetsgrupp.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id}

Ta bort en enhetsgrupp som hoppar över bekräftelseprompten.

az iot du device group delete -n {account_name} -i {instance_name} --group-id {device_group_id} -y

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--gid --group-id

Enhetsgrupp-ID. Detta skapas från värdet för taggen ADUGroup i den anslutna IoT Hub-enhets-/modultvillingen eller $default för enheter utan tagg.

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

Valfria parametrar

--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--yes -y

Hoppa över användarprompter. Anger godkännande av åtgärd. Används främst för automatiseringsscenarier. Standard: falskt.

Godkända värden: false, true
Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az iot du device group list

Visa en lista över enhetsgrupper i en instans.

az iot du device group list --account
                            --instance
                            [--order-by]
                            [--resource-group]

Exempel

Visa en lista över enhetsgrupper.

az iot du device group list -n {account_name} -i {instance_name}

Lista enhetsgrupper i önskad ordning, i det här fallet efter deviceCount.

az iot du device group list -n {account_name} -i {instance_name} --order-by deviceCount

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

Valfria parametrar

--order-by

Beställer den uppsättning grupper som returneras. Du kan beställa efter groupId, deviceCount, createdDateTime, undergrupperWithNewUpdatesAvailableCount, undergrupperWithUpdatesInProgressCount eller undergrupperWithOnLatestUpdateCount.

--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az iot du device group show

Visa information om en enhetsgrupp, inklusive den bästa uppdaterings- och uppdateringsefterlevnaden.

az iot du device group show --account
                            --gid
                            --instance
                            [--best-updates {false, true}]
                            [--resource-group]
                            [--update-compliance {false, true}]

Exempel

Visa en enhetsgrupp.

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

Visa de bästa uppdateringarna som är tillgängliga för en enhetsgrupp. Den här flaggan ändrar kommandot till att returnera en lista.

az iot du device group show -n {account_name} -i {instance_name} --group-id {device_group_id} --best-updates

Visa uppdateringsefterlevnad för en enhetsgrupp.

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

Obligatoriska parametrar

--account -n

Namn på enhetsuppdateringskonto. Du kan konfigurera standardkontonamnet med .az config set defaults.adu_account=<name>

--gid --group-id

Enhetsgrupp-ID. Detta skapas från värdet för taggen ADUGroup i den anslutna IoT Hub-enhets-/modultvillingen eller $default för enheter utan tagg.

--instance -i

Namnet på enhetsuppdateringsinstansen. Du kan konfigurera standardinstansnamnet med .az config set defaults.adu_instance=<name>

Valfria parametrar

--best-updates

Flagga som anger att kommandot ska hämta de bästa tillgängliga uppdateringarna för enhetsgruppen, inklusive antalet enheter som behöver varje uppdatering. En bästa uppdatering är den senaste uppdateringen som uppfyller alla kompatibilitetsspecifikationer för en enhetsklass.

Godkända värden: false, true
--resource-group -g

Namn på resursgrupp för enhetsuppdateringskonto. Du kan konfigurera standardgruppen med .az config set defaults.adu_group=<name>

--update-compliance

Flagga som anger att kommandot ska hämta information om enhetsgruppens uppdateringsefterlevnad, till exempel hur många enheter som har den senaste uppdateringen, hur många som behöver nya uppdateringar och hur många som pågår för att ta emot en ny uppdatering.

Godkända värden: false, true
Globala parametrar
--debug

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

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

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

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

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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