Compartilhar via

az iot du device group

  • Referência

Observação

Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.46.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot du device group . Saiba mais sobre extensões.

Gerenciamento de grupo de dispositivos.

Um grupo de dispositivos é uma coleção de dispositivos. Grupos de dispositivos fornecem uma maneira de dimensionar as implantações em vários dispositivos. Cada dispositivo pertence a exatamente um grupo de dispositivos por vez. Um grupo de dispositivos é criado automaticamente quando um dispositivo habilitado para Atualização de Dispositivo é conectado ao hub e relata suas propriedades.

Comandos

Nome Description Tipo Status
az iot du device group delete

Excluir um grupo de dispositivos.

 Extensão GA
az iot du device group list

Listar grupos de dispositivos em uma instância.

 Extensão GA
az iot du device group show

Mostrar detalhes sobre um grupo de dispositivos, incluindo a melhor atualização e conformidade de atualização.

 Extensão GA

az iot du device group delete

Excluir um grupo de dispositivos.

Os grupos de dispositivos não são limpos automaticamente, mas são retidos para fins de histórico. Essa operação pode ser usada se não houver necessidade do grupo ou necessidade de reter o histórico para ele. Se um dispositivo for conectado novamente para um grupo depois que o grupo foi excluído, ele será recriado automaticamente sem histórico.

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

Exemplos

Excluir um grupo de dispositivos.

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

Exclua um grupo de dispositivos ignorando o prompt de confirmação.

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

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

--yes -y

Ignorar prompts do usuário. Indica aceitação da ação. Usado principalmente para cenários de automação. Padrão: falso.

Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot du device group list

Listar grupos de dispositivos em uma instância.

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

Exemplos

Listar grupos de dispositivos.

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

Liste grupos de dispositivos em uma ordem desejada, neste caso por deviceCount.

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

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--order-by

Ordena que o conjunto de grupos retornado. Você pode ordenar por groupId, deviceCount, createdDateTime, subgroupsWithNewUpdatesAvailableCount, subgroupsWithUpdatesInProgressCount ou subgroupsWithOnLatestUpdateCount.

--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az iot du device group show

Mostrar detalhes sobre um grupo de dispositivos, incluindo a melhor atualização e conformidade de atualização.

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

Exemplos

Mostrar um grupo de dispositivos.

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

Mostrar as melhores atualizações disponíveis para um grupo de dispositivos. Esse sinalizador modifica o comando para retornar uma lista.

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

Mostrar a conformidade de atualização para um grupo de dispositivos.

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

Parâmetros Exigidos

--account -n

Nome da conta de Atualização de Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account=<name>o .

--gid --group-id

ID do grupo de dispositivos. Isso é criado a partir do valor da tag ADUGroup no gêmeo de dispositivo/módulo do Hub IoT conectado ou $default para dispositivos sem marca.

--instance -i

Nome da instância de Atualização de Dispositivo. Você pode configurar o nome da instância padrão usando az config set defaults.adu_instance=<name>o .

Parâmetros Opcionais

--best-updates

Sinalizador indicando que o comando deve buscar as melhores atualizações disponíveis para o grupo de dispositivos, incluindo uma contagem de quantos dispositivos precisam de cada atualização. Uma melhor atualização é a atualização mais recente que atende a todas as especificações de compatibilidade de uma classe de dispositivo.

Valores aceitos: false, true
--resource-group -g

Nome do grupo de recursos da conta de Atualização de Dispositivo. Você pode configurar o grupo padrão usando az config set defaults.adu_group=<name>.

--update-compliance

Sinalizador indicando que o comando deve buscar informações de conformidade de atualização do grupo de dispositivos, como quantos dispositivos estão em sua atualização mais recente, quantos precisam de novas atualizações e quantos estão em andamento ao receber uma nova atualização.

Valores aceitos: false, true
Parâmetros Globais
--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.