Compartilhar via

az iot du device class

  • 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 class . Saiba mais sobre extensões.

Gerenciamento de subgrupos de classes e classes de dispositivos.

Uma classe de dispositivo descreve um conjunto de dispositivos que compartilham um conjunto comum de atributos entre grupos, enquanto um subgrupo de classe de dispositivo é um subconjunto de dispositivos em um grupo que compartilham a mesma ID de classe de dispositivo. As classes de dispositivo são criadas automaticamente quando dispositivos habilitados para Atualização de Dispositivo são conectados ao hub.

Comandos

Nome Description Tipo Status
az iot du device class delete

Exclua uma classe de dispositivo ou um subgrupo de classe de dispositivo.

 Extensão GA
az iot du device class list

Listar classes de dispositivo ou subgrupos de classes de dispositivo.

 Extensão GA
az iot du device class show

Mostrar detalhes sobre uma classe de dispositivo ou subgrupo de classe de dispositivo, incluindo atualizações instaláveis, a melhor atualização e conformidade de atualização.

 Extensão GA
az iot du device class update

Atualizar uma classe de dispositivo.

 Extensão GA

az iot du device class delete

Exclua uma classe de dispositivo ou um subgrupo de classe de dispositivo.

As classes de dispositivo são criadas automaticamente quando os dispositivos habilitados para Atualização de Dispositivo são conectados ao hub, mas não são limpas automaticamente, pois são referenciadas por subgrupos de classes de dispositivo. Se todos os subgrupos de classe de dispositivo para uma classe de dispositivo de destino forem excluídos, a própria classe de dispositivo também poderá ser excluída para remover os registros do sistema e parar de verificar a compatibilidade da classe de dispositivo com novas atualizações. Se um dispositivo for reconectado, sua classe de dispositivo será recriada se não existir.

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

Exemplos

Exclua uma classe de dispositivo.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id}

Exclua uma classe de dispositivo e ignore o prompt de confirmação.

az iot du device class delete -n {account_name} -i {instance_name} --class-id {device_class_id} -y

Exclua um subgrupo de classe de dispositivo.

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

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 .

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

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

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

--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 class list

Listar classes de dispositivo ou subgrupos de classes de dispositivo.

az iot du device class list --account
                            --instance
                            [--filter]
                            [--gid]
                            [--resource-group]

Exemplos

Listar classes de dispositivo dentro de uma instância.

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

Listar classes de dispositivo de instância filtradas por nome amigável.

az iot du device class list -n {account_name} -i {instance_name} --filter "friendlyName eq 'my-favorite-class'"

Listar subgrupos de classe de dispositivo para o grupo.

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

Listar subgrupos de classe de dispositivo para o grupo, filtrados por compatProperties/manufacturer.

az iot du device class list -n {account_name} -i {instance_name} --group-id {device_group_id} --filter "compatProperties/manufacturer eq 'Contoso'"

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

--filter

Se fornecido com --group-id, oferece suporte à filtragem com base em nomes e valores de propriedade compat de classe de dispositivo. Por exemplo, "compatProperties/manufacturer eq 'Contoso'". Caso contrário, suporta a filtragem por nome amigável de classe.

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

--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 class show

Mostrar detalhes sobre uma classe de dispositivo ou subgrupo de classe de dispositivo, incluindo atualizações instaláveis, a melhor atualização e conformidade de atualização.

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

Exemplos

Mostrar uma classe de dispositivo.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id}

Mostrar atualizações instaláveis para a classe de dispositivo. Esse sinalizador modifica o comando para retornar uma lista.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --installable-updates

Mostrar um subgrupo de classe de dispositivo.

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

Mostrar a melhor atualização disponível para um subgrupo de classe de dispositivo.

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

Mostrar a conformidade de atualização para um subgrupo de classe de dispositivo.

az iot du device class show -n {account_name} -i {instance_name} --class-id {device_class_id} --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 .

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

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

Sinalizador indicando que o comando deve buscar a melhor atualização disponível para o subgrupo de classe de dispositivo, incluindo uma contagem de quantos dispositivos precisam da atualização. A ID do Grupo é necessária para esse sinalizador. 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
--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.

--installable-updates

Sinalizador indicando que o comando deve buscar atualizações instaláveis para a 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 de subgrupo de classe de dispositivo, 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. A ID do Grupo é necessária para esse sinalizador.

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 class update

Atualizar uma classe de dispositivo.

az iot du device class update --account
                              --cid
                              --instance
                              [--friendly-name]
                              [--resource-group]

Exemplos

Atualize o nome amigável da classe de dispositivo.

az iot du device class update -n {account_name} -i {instance_name} --class-id {device_class_id} --friendly-name "EU-region"

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 .

--cid --class-id

ID da classe do dispositivo. Isso é gerado a partir da ID do modelo e das propriedades compat relatadas pelo agente de atualização de dispositivo na interface PnP de Atualização de Dispositivo no Hub IoT. É um hash SHA1 codificado por hex.

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

--friendly-name

O nome amigável da classe de dispositivo. O nome amigável deve ter de 1 a 100 caracteres e suporta valores alfanuméricos, de pontos e traços.

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