az iot central device-group
Observação
Essa referência faz parte da extensão azure-iot para a CLI do Azure (versão 2.37.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az iot central device-group . Saiba mais sobre extensões.
Gerenciar e configurar grupos de dispositivos do IoT Central.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az iot central device-group create |
Criar um grupo de dispositivos. |
Extensão | GA |
| az iot central device-group delete |
Excluir um grupo de dispositivos. |
Extensão | GA |
| az iot central device-group list |
Obtenha a lista de grupos de dispositivos para um aplicativo do IoT Central. |
Extensão | GA |
| az iot central device-group show |
Obtenha o grupo de dispositivos por ID. |
Extensão | GA |
| az iot central device-group update |
Atualizar um grupo de dispositivos existente. |
Extensão | GA |
az iot central device-group create
Criar um grupo de dispositivos.
Nota: Apenas uma organização é suportada hoje, várias organizações serão suportadas em breve.
az iot central device-group create --app-id
--device-group-id
--display-name
--filter
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--description]
[--organizations]
[--token]Exemplos
Criar um grupo de dispositivos.
az iot central device-group create --app-id {appid} --device-group-id {devicegroupid} --display-name "DeviceGroup1" --filter "SELECT * FROM devices WHERE $provisioned = true" --description "This is a default device group." --organizations {organization}Parâmetros Exigidos
A ID do aplicativo do IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.
ID exclusivo do grupo de dispositivos.
Nome para exibição do grupo de dispositivos.
Consulta definindo quais dispositivos devem estar nesse grupo. [Exemplo de filtro de consulta: SELECT * FROM devices WHERE $template = "dtmi:modelDefinition:dtdlv2"].
Parâmetros Opcionais
O argumento 'api_version' foi preterido e será removido em uma versão futura.
Esse parâmetro de comando foi preterido e será ignorado. Na versão futura, só daremos suporte às APIs do IoT Central da versão mais recente do GA. Se alguma API ainda não for GA, chamaremos a versão de visualização mais recente.
O sufixo DNS do IoT Central associado ao seu aplicativo.
Breve resumo do grupo de dispositivos.
Lista de IDs de organização do grupo de dispositivos.
Se preferir enviar sua solicitação sem autenticar na CLI do Azure, você poderá 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
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
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 o detalhamento do log. Use --debug para logs de depuração completos.
az iot central device-group delete
Excluir um grupo de dispositivos.
az iot central device-group delete --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Exemplos
Excluir um grupo de dispositivos
az iot central device-group delete --app-id {appid} --device-group-id {devicegroupid}Parâmetros Exigidos
A ID do aplicativo do IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.
ID exclusivo do grupo de dispositivos.
Parâmetros Opcionais
O argumento 'api_version' foi preterido e será removido em uma versão futura.
Esse parâmetro de comando foi preterido e será ignorado. Na versão futura, só daremos suporte às APIs do IoT Central da versão mais recente do GA. Se alguma API ainda não for GA, chamaremos a versão de visualização mais recente.
O sufixo DNS do IoT Central associado ao seu aplicativo.
Se preferir enviar sua solicitação sem autenticar na CLI do Azure, você poderá 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
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
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 o detalhamento do log. Use --debug para logs de depuração completos.
az iot central device-group list
Obtenha a lista de grupos de dispositivos para um aplicativo do IoT Central.
az iot central device-group list --app-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Exemplos
Listar grupos de dispositivos em um aplicativo
az iot central device-group list --app-id {appid}Parâmetros Exigidos
A ID do aplicativo do 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
O argumento 'api_version' foi preterido e será removido em uma versão futura.
Esse parâmetro de comando foi preterido e será ignorado. Na versão futura, só daremos suporte às APIs do IoT Central da versão mais recente do GA. Se alguma API ainda não for GA, chamaremos a versão de visualização mais recente.
O sufixo DNS do IoT Central associado ao seu aplicativo.
Se preferir enviar sua solicitação sem autenticar na CLI do Azure, você poderá 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
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
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 o detalhamento do log. Use --debug para logs de depuração completos.
az iot central device-group show
Obtenha o grupo de dispositivos por ID.
az iot central device-group show --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--token]Exemplos
Obtenha o grupo de dispositivos por ID.
az iot central device-group show --app-id {appid} --device-group-id {devicegroupid}Parâmetros Exigidos
A ID do aplicativo do IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.
ID exclusivo do grupo de dispositivos.
Parâmetros Opcionais
O argumento 'api_version' foi preterido e será removido em uma versão futura.
Esse parâmetro de comando foi preterido e será ignorado. Na versão futura, só daremos suporte às APIs do IoT Central da versão mais recente do GA. Se alguma API ainda não for GA, chamaremos a versão de visualização mais recente.
O sufixo DNS do IoT Central associado ao seu aplicativo.
Se preferir enviar sua solicitação sem autenticar na CLI do Azure, você poderá 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
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
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 o detalhamento do log. Use --debug para logs de depuração completos.
az iot central device-group update
Atualizar um grupo de dispositivos existente.
Nota: Apenas uma organização é suportada hoje, várias organizações serão suportadas em breve.
az iot central device-group update --app-id
--device-group-id
[--api-version {2022-06-30-preview, 2022-07-31}]
[--central-api-uri]
[--description]
[--display-name]
[--filter]
[--organizations]
[--token]Exemplos
Atualizar um grupo de dispositivos via patch
az iot central device-group update --app-id {appid} --device-group-id {devicegroupid} --display-name {displayname} --filter {filter} --description {description} --organizations {organization}Parâmetros Exigidos
A ID do aplicativo do IoT Central que você deseja gerenciar. Você pode encontrar o ID do aplicativo na página "Sobre" do seu aplicativo no menu de ajuda.
ID exclusivo do grupo de dispositivos.
Parâmetros Opcionais
O argumento 'api_version' foi preterido e será removido em uma versão futura.
Esse parâmetro de comando foi preterido e será ignorado. Na versão futura, só daremos suporte às APIs do IoT Central da versão mais recente do GA. Se alguma API ainda não for GA, chamaremos a versão de visualização mais recente.
O sufixo DNS do IoT Central associado ao seu aplicativo.
Breve resumo do grupo de dispositivos.
Nome para exibição do grupo de dispositivos.
Consulta definindo quais dispositivos devem estar nesse grupo. [Exemplo de filtro de consulta: SELECT * FROM devices WHERE $template = "dtmi:modelDefinition:dtdlv2"].
Lista de IDs de organização do grupo de dispositivos.
Se preferir enviar sua solicitação sem autenticar na CLI do Azure, você poderá 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
Aumente o detalhamento do log para mostrar todos os logs de depuração.
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
Formato de saída.
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 o detalhamento do log. Use --debug para logs de depuração completos.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de