az iot du device class

Note

This reference is part of the azure-iot extension for the Azure CLI (version 2.59.0 or higher). A extensão instalará automaticamente na primeira vez que você executar um comando classe de dispositivo az iot du. Learn more about extensions.

Gerenciamento de classe de dispositivo e subgrupo de classe de dispositivo.

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 subgrupo de classe de dispositivo.	Extension	GA
az iot du device class list	Listar classes de dispositivo ou subgrupos de classe de dispositivo.	Extension	GA
az iot du device class show	Mostre detalhes sobre uma classe de dispositivo ou subgrupo de classe de dispositivo, incluindo atualizações instaláveis, a melhor atualização e a conformidade de atualizações.	Extension	GA
az iot du device class update	Atualize uma classe de dispositivo.	Extension	GA

az iot du device class delete

Exclua uma classe de dispositivo ou 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 limpos automaticamente, pois são referenciados por subgrupos de classe de dispositivo. Se todos os subgrupos de classe de dispositivo de 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 --class-id
                              --instance
                              [--gid --group-id]
                              [--resource-group]
                              [--yes {false, true}]

Exemplos

Excluir 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

Excluir 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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade	Valor
Parameter group:	Account Identifier Arguments

--cid --class-id

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

--instance -i

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

Propriedade	Valor
Parameter group:	Account Identifier Arguments

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--gid --group-id

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

--resource-group -g

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

Propriedade	Valor
Parameter group:	Account Identifier Arguments

--yes -y

Ignore as solicitações do usuário. Indica a aceitação da ação. Usado principalmente para cenários de automação. Default: false.

Propriedade	Valor
Valores aceitos:	false, true

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

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

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot du device class list

Listar classes de dispositivo ou subgrupos de classe de dispositivo.

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

Exemplos

Listar classes de dispositivo em 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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade	Valor
Parameter group:	Account Identifier Arguments

--instance -i

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

Propriedade	Valor
Parameter group:	Account Identifier Arguments

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--filter

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

--gid --group-id

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

--resource-group -g

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

Propriedade	Valor
Parameter group:	Account Identifier Arguments

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

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

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot du device class show

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

az iot du device class show --account
                            --cid --class-id
                            --instance
                            [--best-update {false, true}]
                            [--gid --group-id]
                            [--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 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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade	Valor
Parameter group:	Account Identifier Arguments

--cid --class-id

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

--instance -i

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

Propriedade	Valor
Parameter group:	Account Identifier Arguments

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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 atualização recomendada é a atualização mais recente que atende a todas as especificações de compatibilidade de uma classe de dispositivo.

Propriedade	Valor
Parameter group:	Update Arguments
Valores aceitos:	false, true

--gid --group-id

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

--installable-updates

Sinalizador que indica que o comando deve buscar atualizações instaláveis para a classe de dispositivo.

Propriedade	Valor
Parameter group:	Update Arguments
Valores aceitos:	false, true

--resource-group -g

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

Propriedade	Valor
Parameter group:	Account Identifier Arguments

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

Propriedade	Valor
Parameter group:	Update Arguments
Valores aceitos:	false, true

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

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

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot du device class update

Atualize uma classe de dispositivo.

az iot du device class update --account
                              --cid --class-id
                              --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 do Dispositivo. Você pode configurar o nome da conta padrão usando az config set defaults.adu_account={name}.

Propriedade	Valor
Parameter group:	Account Identifier Arguments

--cid --class-id

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

--instance -i

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

Propriedade	Valor
Parameter group:	Account Identifier Arguments

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--friendly-name

O nome amigável da classe de dispositivo. O nome amigável deve ter de 1 a 100 caracteres e dá suporte a valores alfanuméricos, ponto e traço.

--resource-group -g

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

Propriedade	Valor
Parameter group:	Account Identifier Arguments

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

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

--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 a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False