az iot central device

Note

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

Gerencie e configure dispositivos IoT Central.

Comandos

Nome	Descrição	Tipo	Estado
az iot central device attestation	Gerencie e configure o atestado de dispositivo do IoT Central.	Extension	disponibilidade geral
az iot central device attestation create	Crie um atestado de dispositivo individual.	Extension	disponibilidade geral
az iot central device attestation delete	Remova um atestado de dispositivo individual.	Extension	disponibilidade geral
az iot central device attestation show	Obtenha o atestado do dispositivo.	Extension	disponibilidade geral
az iot central device attestation update	Atualize um atestado de dispositivo individual via patch.	Extension	disponibilidade geral
az iot central device c2d-message	Execute comandos de mensagens da nuvem para o dispositivo do dispositivo.	Extension	disponibilidade geral
az iot central device c2d-message purge	Limpa a fila de mensagens da nuvem para o dispositivo de destino.	Extension	disponibilidade geral
az iot central device command	Execute comandos de dispositivo.	Extension	disponibilidade geral
az iot central device command history	Obtenha os detalhes da última solicitação de comando e resposta enviada ao dispositivo.	Extension	disponibilidade geral
az iot central device command run	Execute um comando em um dispositivo e visualize a resposta associada. NÃO monitora atualizações de propriedade que o comando pode executar.	Extension	disponibilidade geral
az iot central device compute-device-key	Gere uma chave SAS de dispositivo derivada.	Extension	disponibilidade geral
az iot central device create	Crie um dispositivo no IoT Central.	Extension	disponibilidade geral
az iot central device delete	Exclua um dispositivo do IoT Central.	Extension	disponibilidade geral
az iot central device edge	Gerencie e configure dispositivos de borda do IoT Central.	Extension	disponibilidade geral
az iot central device edge children	Gerencie dispositivos filhos de dispositivos IoT Edge.	Extension	disponibilidade geral
az iot central device edge children add	Adicione dispositivos como crianças a um dispositivo de borda de destino.	Extension	Preview
az iot central device edge children list	Obtenha a lista de filhos de um dispositivo IoT Edge.	Extension	disponibilidade geral
az iot central device edge children remove	Remova dispositivos filho de um dispositivo de borda de destino.	Extension	Preview
az iot central device edge manifest	Gerencie manifestos de dispositivos do IoT Edge.	Extension	Preview
az iot central device edge manifest show	Obtenha o manifesto de implantação associado ao dispositivo IoT Edge especificado.	Extension	Preview
az iot central device edge module	Gerencie módulos de dispositivo do IoT Edge.	Extension	Preview
az iot central device edge module list	Obtenha a lista de módulos em um dispositivo IoT Edge.	Extension	Preview
az iot central device edge module restart	Reinicie um módulo em um dispositivo IoT Edge.	Extension	Preview
az iot central device edge module show	Obtenha um módulo em um dispositivo IoT Edge.	Extension	Preview
az iot central device list	Obtenha a lista de dispositivos para um aplicativo do IoT Central.	Extension	disponibilidade geral
az iot central device list-components	Liste os componentes presentes em um dispositivo.	Extension	disponibilidade geral
az iot central device list-modules	Liste os módulos presentes em um dispositivo.	Extension	disponibilidade geral
az iot central device manual-failback	Reverte o comando de failover executado anteriormente movendo o dispositivo de volta ao Hub IoT original.	Extension	disponibilidade geral
az iot central device manual-failover	Execute um failover manual de dispositivo em vários Hubs IoT para validar a capacidade do firmware do dispositivo de se reconectar usando DPS a um Hub IoT diferente.	Extension	disponibilidade geral
az iot central device registration-info	Obtenha informações de registo no(s) dispositivo(s) a partir do IoT Central.	Extension	disponibilidade geral
az iot central device show	Obtenha um dispositivo do IoT Central.	Extension	disponibilidade geral
az iot central device show-credentials	Obtenha credenciais de dispositivo do IoT Central.	Extension	disponibilidade geral
az iot central device telemetry	Consulte o último valor de telemetria do dispositivo IoT Central.	Extension	disponibilidade geral
az iot central device telemetry show	Obtenha o último valor de telemetria de um dispositivo.	Extension	disponibilidade geral
az iot central device twin	Gerencie gêmeos de dispositivos do IoT Central.	Extension	disponibilidade geral
az iot central device twin replace	Substitua valores de propriedade graváveis de um dispositivo, um componente de dispositivo ou um módulo de dispositivo ou um componente de módulo de dispositivo.	Extension	disponibilidade geral
az iot central device twin show	Obtenha todos os valores de propriedade de um dispositivo, um componente de dispositivo, um módulo de dispositivo ou um componente de módulo de dispositivo.	Extension	disponibilidade geral
az iot central device twin update	Atualize os valores de propriedade graváveis de um dispositivo, um componente de dispositivo, um módulo de dispositivo ou um componente de módulo de dispositivo.	Extension	disponibilidade geral
az iot central device update	Atualize um dispositivo no IoT Central.	Extension	disponibilidade geral

az iot central device compute-device-key

Gere uma chave SAS de dispositivo derivada.

Gere uma chave de dispositivo derivada de uma chave SAS no nível do grupo.

az iot central device compute-device-key --device-id
                                         --pk --primary-key

Exemplos

Utilização básica

az iot central device compute-device-key --pk {primaryKey} --device-id {deviceid}

Parâmetros Obrigatórios

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

--pk --primary-key

A chave de acesso compartilhada simétrica primária armazenada no formato base64.

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device create

Crie um dispositivo no IoT Central.

az iot central device create --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--device-name]
                             [--organizations --orgs]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Exemplos

Criar um dispositivo

az iot central device create --app-id {appid} --device-id {deviceid}

Criar um dispositivo simulado

az iot central device create --app-id {appid} --device-id {deviceid} --template {devicetemplateid} --simulated

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

Identificador exclusivo do dispositivo. Uma cadeia de caracteres que diferencia maiúsculas de minúsculas (até 128 caracteres) de caracteres alfanuméricos ASCII de 7 bits mais certos caracteres especiais: - . + % _ # * ? ! ( ) , : = @ $ '.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Este parâmetro de comando foi preterido e será ignorado. Na versão futura, só suportaremos APIs do IoT Central a partir da versão mais recente do GA. Se alguma API ainda não for GA, chamaremos a versão de visualização mais recente.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--device-name

Nome do dispositivo legível por humanos. Exemplo: Frigorífico.

--organizations --orgs

Atribua o dispositivo às organizações especificadas. Lista separada por vírgulas de IDs da organização. Versão mínima suportada: 1.1-preview.

--simulated

Adicione este sinalizador se quiser que o IoT Central o configure como um dispositivo simulado. --template é necessário se isso for verdade.

Propriedade	Valor
Valor padrão:	False
Valores aceites:	false, true

--template

Exemplo: dtmi:ojpkindbz:modelDefinition:iild3tm_uo.

--token

Se preferir enviar sua solicitação sem autenticar na CLI do Azure, você pode especificar um token de usuário válido para autenticar sua solicitação. Você deve especificar o tipo de chave como parte da solicitação. Saiba mais em https://aka.ms/iotcentraldocsapi.

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device delete

Exclua um dispositivo do IoT Central.

az iot central device delete --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--token]

Exemplos

Excluir um dispositivo

az iot central device delete --app-id {appid} --device-id {deviceid}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device list

Obtenha a lista de dispositivos para um aplicativo do IoT Central.

az iot central device list --app-id
                           [--api-version --av {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri --central-dns-suffix]
                           [--edge-only]
                           [--token]

Exemplos

Listar todos os dispositivos em um aplicativo, classificados por ID do dispositivo (padrão)

az iot central device list --app-id {appid}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--edge-only -e

Liste apenas dispositivos IoT Edge.

Propriedade	Valor
Valor padrão:	False

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device list-components

Liste os componentes presentes em um dispositivo.

az iot central device list-components --app-id
                                      --device-id
                                      [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--mn --module-name]
                                      [--token]

Exemplos

Listar os componentes presentes em um dispositivo

az iot central device list-components --app-id {appid} --device-id {deviceid}

Listar os componentes presentes em um módulo de dispositivo

az iot central device list-components --app-id {appid} --module-name {modulename} --device-id {deviceid}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--mn --module-name

O nome do módulo do dispositivo.

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device list-modules

Liste os módulos presentes em um dispositivo.

az iot central device list-modules --app-id
                                   --device-id
                                   [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                   [--central-api-uri --central-dns-suffix]
                                   [--token]

Exemplos

Listar os módulos presentes em um dispositivo

az iot central device list-modules --app-id {appid} --device-id {deviceid}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device manual-failback

Reverte o comando de failover executado anteriormente movendo o dispositivo de volta ao Hub IoT original.

Para obter mais informações sobre alta disponibilidade, visite https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device manual-failback --app-id
                                      --device-id
                                      [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--token]

Exemplos

Reverte o comando de failover executado anteriormente movendo o dispositivo de volta ao Hub IoT original

az iot central device manual-failback --app-id {appid} --device-id {deviceid}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device manual-failover

Execute um failover manual de dispositivo em vários Hubs IoT para validar a capacidade do firmware do dispositivo de se reconectar usando DPS a um Hub IoT diferente.

Para obter mais informações sobre alta disponibilidade e valor padrão para ttl-minutes, visite https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

az iot central device manual-failover --app-id
                                      --device-id
                                      [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                      [--central-api-uri --central-dns-suffix]
                                      [--token]
                                      [--ttl --ttl-minutes]

Exemplos

Execute um failover manual de dispositivo em vários Hubs IoT para validar a capacidade do firmware do dispositivo de se reconectar usando DPS a um Hub IoT diferente.

az iot central device manual-failover --app-id {appid} --device-id {deviceid} --ttl-minutes {ttl_minutes}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--token

--ttl --ttl-minutes

Um número inteiro positivo. TTL em minutos para mover o dispositivo de volta ao hub original. Tem valor padrão no back-end. Consulte a documentação sobre qual o valor padrão padrão do back-end mais recente, visitando https://github.com/iot-for-all/iot-central-high-availability-clients#readme.

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device registration-info

Obtenha informações de registo no(s) dispositivo(s) a partir do IoT Central.

Observação: esse comando pode levar um tempo significativo para retornar se nenhum ID de dispositivo for especificado e seu aplicativo contiver muitos dispositivos.

az iot central device registration-info --app-id
                                        --device-id
                                        [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                        [--central-api-uri --central-dns-suffix]
                                        [--token]

Exemplos

Obter informações de registro no dispositivo especificado

az iot central device registration-info --app-id {appid} --device-id {deviceid}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device show

Obtenha um dispositivo do IoT Central.

az iot central device show --app-id
                           --device-id
                           [--api-version --av {2022-06-30-preview, 2022-07-31}]
                           [--central-api-uri --central-dns-suffix]
                           [--token]

Exemplos

Obter um dispositivo

az iot central device show --app-id {appid} --device-id {deviceid}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device show-credentials

Obtenha credenciais de dispositivo do IoT Central.

az iot central device show-credentials --app-id
                                       --device-id
                                       [--api-version --av {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri --central-dns-suffix]
                                       [--token]

Exemplos

Obter credenciais de dispositivo para um dispositivo

az iot central device show-credentials --app-id {appid} --device-id {deviceid}

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az iot central device update

Atualize um dispositivo no IoT Central.

Permite alterar as seguintes propriedades de um dispositivo: "displayName", "template", "simulated", "enabled" e "organizations". A ID do dispositivo não pode ser alterada.

az iot central device update --app-id
                             --device-id
                             [--api-version --av {2022-06-30-preview, 2022-07-31}]
                             [--central-api-uri --central-dns-suffix]
                             [--device-name]
                             [--enable {false, true}]
                             [--organizations --orgs]
                             [--simulated {false, true}]
                             [--template]
                             [--token]

Exemplos

Atualizar um nome de exibição do dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --device-name {deviceName}

Transforme um dispositivo simulado em um real

az iot central device update --app-id {appid} --device-id {deviceid} --simulated false

Atualizar organizações para o dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --organizations {organizations}

Desativar um dispositivo

az iot central device update --app-id {appid} --device-id {deviceid} --enable false

Parâmetros Obrigatórios

--app-id -n

A ID do aplicativo IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.

--device-id -d

O ID do dispositivo de destino. Você pode encontrar o ID do dispositivo clicando no botão Conectar na página Detalhes do dispositivo.

Parâmetros Opcionais

Os parâmetros seguintes são opcionais, mas dependendo do contexto, podem ser necessários um ou mais para que o comando seja executado com sucesso.

--api-version --av

Descontinuado

O argumento 'api_version' foi preterido e será removido em uma versão futura.

Propriedade	Valor
Valor padrão:	2022-07-31
Valores aceites:	2022-06-30-preview, 2022-07-31

--central-api-uri --central-dns-suffix

O sufixo DNS do IoT Central associado ao seu aplicativo.

Propriedade	Valor
Valor padrão:	azureiotcentral.com

--device-name

Nome do dispositivo legível por humanos. Exemplo: Frigorífico.

--enable

Adicione este sinalizador se quiser que o IoT Central habilite ou desative o dispositivo.

Propriedade	Valor
Valores aceites:	false, true

--organizations --orgs

Atribua o dispositivo às organizações especificadas. Lista separada por vírgulas de IDs da organização. Versão mínima suportada: 1.1-preview.

--simulated

Adicione este sinalizador se quiser que o IoT Central o configure como um dispositivo simulado. --template é necessário se isso for verdade.

Propriedade	Valor
Valores aceites:	false, true

--template

Exemplo: dtmi:ojpkindbz:modelDefinition:iild3tm_uo.

--token

Parâmetros globais

--debug

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

Propriedade	Valor
Valor padrão:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

Feedback

Esta página foi útil?

Partilhar via

az iot central device

Comandos

az iot central device compute-device-key

Exemplos

Parâmetros Obrigatórios

az iot central device create

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device delete

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device list

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device list-components

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device list-modules

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device manual-failback

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device manual-failover

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device registration-info

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device show

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device show-credentials

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot central device update

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

Feedback