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
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
O nome da instância de Operações IoT do Azure.
O nome do dispositivo a ser criado.
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.
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.
Desabilite o dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
| Valores aceitos: | false, true |
O fabricante do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
O modelo do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
O sistema operacional do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
A versão do sistema operativo do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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
O nome da instância de Operações IoT do Azure.
O nome do dispositivo a ser criado.
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.
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
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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.
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.
Estado do ativo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
| Valores aceitos: | false, true |
O nome da instância de Operações IoT do Azure.
O fabricante do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
O modelo do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
O nome do dispositivo a ser criado.
O sistema operacional do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
A versão do sistema operativo do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
O grupo de recursos da instância de Operações IoT do Azure.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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
O nome da instância de Operações IoT do Azure.
O nome do dispositivo a ser criado.
O grupo de recursos da instância de Operações IoT do Azure.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
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
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
O nome da instância de Operações IoT do Azure.
O nome do dispositivo a ser criado.
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.
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.
Desabilite o dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
| Valores aceitos: | false, true |
A versão do sistema operativo do dispositivo.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Additional Info Arguments |
Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |