Compartilhar via


az iot ops ns device

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 instalará automaticamente na primeira vez que você executar um comando de dispositivo az iot ops ns . Saiba mais sobre extensões.

O grupo de comandos 'iot ops ns' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Gerenciar dispositivos em namespaces do Registro de Dispositivos.

Comandos

Nome Description Tipo Status
az iot ops ns device create

Crie um dispositivo em um namespace do Registro de Dispositivos.

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

Gerenciar pontos de extremidade para dispositivos em namespaces do Registro de Dispositivo.

Extension Preview
az iot ops ns device endpoint inbound

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

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 ponto de extremidade de entrada MQTT a um dispositivo em um namespace do Registro de Dispositivo.

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 rest a um dispositivo em um namespace do Registro de Dispositivo.

Extension Preview
az iot ops ns device endpoint inbound add sse

Adicione um ponto de extremidade de entrada SSE a um dispositivo em um namespace do Registro de Dispositivo.

Extension Preview
az iot ops ns device endpoint inbound list

Listar pontos de extremidade de entrada de um dispositivo em um namespace do Registro de Dispositivos.

Extension Preview
az iot ops ns device endpoint inbound remove

Remova pontos de extremidade de entrada de um dispositivo em um namespace do Registro de Dispositivos.

Extension Preview
az iot ops ns device endpoint list

Liste todos os pontos de extremidade de um dispositivo em um namespace do Registro de Dispositivos.

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

Extension Preview
az iot ops ns device update

Atualize um dispositivo em um namespace do Registro de Dispositivos.

Extension Preview

az iot ops ns device create

Versão Prévia

O grupo de comandos 'iot ops ns' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Crie um dispositivo em um namespace do Registro de Dispositivos.

O dispositivo será vinculado a uma instância de Operações de 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 desabilitado com marcas

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

Parâmetros Exigidos

--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 IoT do Azure.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--attr --custom-attribute

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

--disabled

Desabilite o dispositivo.

Propriedade Valor
Grupo de parâmetros: Additional Info Arguments
Valores aceitos: 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 operativo do dispositivo.

Propriedade Valor
Grupo de parâmetros: Additional Info Arguments
--tags

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

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

Formato de saída.

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 ops ns device delete

Versão Prévia

O grupo de comandos 'iot ops ns' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--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 IoT do Azure.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--yes -y

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

Propriedade Valor
Valor padrão: False
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

Formato de saída.

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 ops ns device query

Versão Prévia

O grupo de comandos 'iot ops ns' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Consultar dispositivos em namespaces do Registro de Dispositivo.

Consulte dispositivos em 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

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

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

Consultar um dispositivo específico por nome

az iot ops ns device query --name mydevice

Consultar dispositivos de um fabricante específico

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

Usar uma consulta personalizada para pesquisar 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--cq --custom-query

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

--disabled

Estado do ativo.

Propriedade Valor
Grupo de parâmetros: Additional Info Arguments
Valores aceitos: 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 operativo do dispositivo.

Propriedade Valor
Grupo de parâmetros: Additional Info Arguments
--resource-group -g

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

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

Formato de saída.

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 ops ns device show

Versão Prévia

O grupo de comandos 'iot ops ns' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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

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 Exigidos

--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 IoT do Azure.

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

Formato de saída.

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 ops ns device update

Versão Prévia

O grupo de comandos 'iot ops ns' está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Atualize um dispositivo em um namespace do Registro de Dispositivos.

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"

Desabilitar um dispositivo

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

Atualizar marcas de dispositivo

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

Parâmetros Exigidos

--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 IoT do Azure.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--attr --custom-attribute

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

--disabled

Desabilite o dispositivo.

Propriedade Valor
Grupo de parâmetros: Additional Info Arguments
Valores aceitos: false, true
--os-version --osv

A versão do sistema operativo do dispositivo.

Propriedade Valor
Grupo de parâmetros: Additional Info Arguments
--tags

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

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

Formato de saída.

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