az iot ops ns device

Pré-visualizar

Note

Essa referência faz parte da extensão azure-iot-ops 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 az iot ops ns device . Saiba mais sobre extensões.

O grupo de comando 'iot ops ns' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie dispositivos em namespaces do Registro de Dispositivo.

Comandos

Name	Description	Tipo	Status
az iot ops ns device create	Crie um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device delete	Exclua um dispositivo de um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint	Gerencie pontos de extremidade para dispositivos em namespaces do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound	Gerencie pontos de extremidade de entrada para dispositivos em namespaces do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound add	Adicione pontos de extremidade de entrada a dispositivos em namespaces do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound add custom	Adicione um ponto de extremidade de entrada personalizado a um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound add media	Adicione um ponto de extremidade de entrada de mídia a um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound add mqtt	Adicione um endpoint de entrada MQTT a um dispositivo num namespace do Registo de Dispositivos.	Extension	Preview
az iot ops ns device endpoint inbound add onvif	Adicione um ponto de extremidade de entrada ONVIF a um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound add opcua	Adicione um ponto de extremidade de entrada OPC UA a um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound add rest	Adicione um ponto de extremidade de entrada restante a um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound add sse	Adicione um endpoint de entrada SSE a um dispositivo num namespace do Registo de Dispositivos.	Extension	Preview
az iot ops ns device endpoint inbound list	Liste pontos de extremidade de entrada de um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint inbound remove	Remova os pontos de extremidade de entrada de um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device endpoint list	Liste todos os pontos de extremidade de um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device query	Consultar dispositivos em namespaces do Registro de Dispositivo.	Extension	Preview
az iot ops ns device show	Mostrar detalhes de um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview
az iot ops ns device update	Atualize um dispositivo em um namespace do Registro de Dispositivo.	Extension	Preview

az iot ops ns device create

Pré-visualizar

O grupo de comando 'iot ops ns' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie um dispositivo em um namespace do Registro de Dispositivo.

O dispositivo será vinculado a uma instância de Operações IoT do Azure.

az iot ops ns device create --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--manufacturer]
                            [--model]
                            [--os]
                            [--os-version --osv]
                            [--tags]

Exemplos

Criar um dispositivo com configuração mínima

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup

Criar um dispositivo com atributos personalizados

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building1 floor=3

Criar um dispositivo com informações do fabricante e detalhes do sistema operacional

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --manufacturer "Contoso" --model "Gateway X1" --os "Linux" --os-version "4.15"

Criar um dispositivo desativado com tags

az iot ops ns device create --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled --tags environment=test criticality=low

Parâmetros Obrigatórios

--instance -i

O nome da instância de Operações IoT do Azure.

--name -n

O nome do dispositivo a ser criado.

--resource-group -g

O grupo de recursos da instância de Operações do Azure IoT.

Parâmetros Opcionais

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

--attr --custom-attribute

Pares chave=valor separados por espaço correspondentes a atributos personalizados adicionais para o dispositivo. Este parâmetro pode ser usado mais de uma vez.

--disabled

Desative o dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments
Valores aceites:	false, true

--manufacturer

O fabricante do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--model

O modelo do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--os

O sistema operacional do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--os-version --osv

A versão do sistema operacional do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	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
Default value:	False

az iot ops ns device delete

Pré-visualizar

O grupo de comando 'iot ops ns' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua um dispositivo de um namespace do Registro de Dispositivo.

az iot ops ns device delete --instance
                            --name
                            --resource-group
                            [--yes {false, true}]

Exemplos

Excluir um dispositivo

az iot ops ns device delete --name mydevice --instance myInstance -g myInstanceResourceGroup

Parâmetros Obrigatórios

--instance -i

O nome da instância de Operações IoT do Azure.

--name -n

O nome do dispositivo a ser criado.

--resource-group -g

O grupo de recursos da instância de Operações do Azure IoT.

Parâmetros Opcionais

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

--yes -y

Confirme [s]es sem um prompt. Útil para cenários de CI e automação.

Propriedade	Valor
Default value:	False
Valores aceites:	false, true

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	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
Default value:	False

az iot ops ns device query

Pré-visualizar

O grupo de comando 'iot ops ns' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Consultar dispositivos em namespaces do Registro de Dispositivo.

Consulte dispositivos entre namespaces com base em vários critérios de pesquisa, incluindo nome do dispositivo, fabricante, modelo e muito mais.

az iot ops ns device query [--cq --custom-query]
                           [--disabled {false, true}]
                           [--instance]
                           [--manufacturer]
                           [--model]
                           [--name]
                           [--os]
                           [--os-version --osv]
                           [--resource-group]

Exemplos

Consulta de dispositivos em uma instância de Operações IoT

az iot ops ns device query --instance myInstance -g myInstanceResourceGroup

Consulta de um dispositivo específico pelo nome

az iot ops ns device query --name mydevice

Consulta de dispositivos de um fabricante específico

az iot ops ns device query --manufacturer "Contoso"

Utilizar uma consulta personalizada para procurar dispositivos

az iot ops ns device query --custom-query "where tags.environment=='production'"

Parâmetros Opcionais

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

--cq --custom-query

Consulta personalizada a ser usada. Todos os outros argumentos de consulta, exceto o nome da instância e o grupo de recursos, serão ignorados.

--disabled

Estado do ativo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments
Valores aceites:	false, true

--instance -i

O nome da instância de Operações IoT do Azure.

--manufacturer

O fabricante do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--model

O modelo do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--name -n

O nome do dispositivo a ser criado.

--os

O sistema operacional do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--os-version --osv

A versão do sistema operacional do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--resource-group -g

O grupo de recursos da instância de Operações do Azure IoT.

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	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
Default value:	False

az iot ops ns device show

Pré-visualizar

O grupo de comando 'iot ops ns' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar detalhes de um dispositivo em um namespace do Registro de Dispositivo.

az iot ops ns device show --instance
                          --name
                          --resource-group

Exemplos

Mostrar detalhes de um dispositivo

az iot ops ns device show --name mydevice --instance myInstance -g myInstanceResourceGroup

Parâmetros Obrigatórios

--instance -i

O nome da instância de Operações IoT do Azure.

--name -n

O nome do dispositivo a ser criado.

--resource-group -g

O grupo de recursos da instância de Operações do Azure IoT.

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	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
Default value:	False

az iot ops ns device update

Pré-visualizar

O grupo de comando 'iot ops ns' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualize um dispositivo em um namespace do Registro de Dispositivo.

az iot ops ns device update --instance
                            --name
                            --resource-group
                            [--attr --custom-attribute]
                            [--disabled {false, true}]
                            [--os-version --osv]
                            [--tags]

Exemplos

Atualizar atributos personalizados do dispositivo

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --attr location=building2 floor=5

Atualizar a versão do sistema operacional

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --os-version "4.18"

Desativar um dispositivo

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --disabled

Atualizar tags de dispositivo

az iot ops ns device update --name mydevice --instance myInstance -g myInstanceResourceGroup --tags environment=production criticality=high

Parâmetros Obrigatórios

--instance -i

O nome da instância de Operações IoT do Azure.

--name -n

O nome do dispositivo a ser criado.

--resource-group -g

O grupo de recursos da instância de Operações do Azure IoT.

Parâmetros Opcionais

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

--attr --custom-attribute

Pares chave=valor separados por espaço correspondentes a atributos personalizados adicionais para o dispositivo. Este parâmetro pode ser usado mais de uma vez.

--disabled

Desative o dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments
Valores aceites:	false, true

--os-version --osv

A versão do sistema operacional do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Additional Info Arguments

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	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
Default value:	False

Feedback

Esta página foi útil?

Partilhar via

az iot ops ns device

Comandos

az iot ops ns device create

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot ops ns device delete

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az iot ops ns device query

Exemplos

Parâmetros Opcionais

az iot ops ns device show

Exemplos

Parâmetros Obrigatórios

az iot ops ns device update

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

Feedback