Compartilhar via

device-group

  • Artigo

Importante

Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).

Cria e gerencia grupos de dispositivos.

Os grupos de dispositivos são tratados por ID (identificador) ou por um nome de produto e par de nome de grupo de dispositivos.

Operação Descrição
create Cria um novo grupo de dispositivos.
lista Liste todos os grupos de dispositivos em seu locatário do Azure Sphere.
excluir Exclui um grupo de dispositivos existente.
Implantação Gerencia implantações em um grupo de dispositivos.
device Lista os dispositivos em um grupo de dispositivos.
show Exibe informações sobre um grupo de dispositivos.
update Modifica um grupo de dispositivos existente.

create

Cria um grupo de dispositivos com o nome especificado para o produto especificado. O grupo de dispositivos organiza os dispositivos que têm o mesmo produto e recebem os mesmos aplicativos da nuvem.

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-p, --produto GUID ou nome Especifica o produto ao qual adicionar esse grupo de dispositivos. Você pode especificar a ID ou o nome do produto do Azure Sphere.
-n, --name String Especifica um nome para o grupo de dispositivos. O nome só pode incluir caracteres alfanuméricos. Se o nome contiver espaços, coloque-o entre aspas. O nome do grupo de dispositivos não pode exceder 50 caracteres, não diferencia maiúsculas de minúsculas e deve ser exclusivo no produto.

Parâmetros opcionais

Parâmetro Tipo Descrição
-a, --atualização do aplicativo Enum Especifica a política de atualização de aplicativo a ser aplicada a esse grupo de dispositivos. Valores aceitos: No3rdPartyAppUpdates, UpdateAlle NoUpdates. O padrão é UpdateAll. No momento, a NoUpdates política está reservada apenas para uso interno.
-f, --os-feed Enum Especifica o tipo de feed do sistema operacional a ser usado para atualizações do sistema operacional. Valores aceitos:Retail, RetailEval.
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
-d, --descrição String Especifica o texto opcional para descrever o grupo de dispositivos. O tamanho máximo é de 100 caracteres. Se a descrição incluir espaços, coloque-a entre aspas.
-r, --limite de dados regionais String Limite de dados regional para esta imagem. Valores Permitidos: EU e None. O valor padrão é None. Se nenhum valor for especificado, o valor padrão será usado. Para obter mais informações, consulte Configurar despejos de memória - Considerações sobre Pivacy
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device-group create --name Marketing --product DW100

 ------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- ---------------------
 Id                                   TenantId                             OsFeedType ProductId                            Name       UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
 ===================================================================================================================================================================================================================================================
 7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     6f52bead-700d-4289-bdc2-2f11f774270e Marketing Accept all updates from the Azure Sphere Security Service. False                          None
 ------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------

lista

Liste todos os grupos de dispositivos em seu locatário do Azure Sphere.

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device-group list --tenant 143adbc9-1bf0-4be2-84a2-084a331d81cb

  ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- ---------------------
 Id                                   Name                     Description                                   ProductId                            OsFeedType UpdatePolicy                                                           AllowCrashDumpsCollection     RegionalDataBoundary
 =====================================================================================================================================================================================================================================================================================
 a3a49688-4601-4422-8b51-a0838ea84627 Development              Default development device group              6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept only system software updates. Don't accept application updates. False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 7cb46b96-8c17-4afd-bd3f-614acad9d264 Field Test               Default test device group                     6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 30c39bae-f525-4094-8008-d03705429ef0 Production               Default production device group               6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 cb5c9685-5dbe-470c-91a9-91dc129884d6 Production OS Evaluation Default Production OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- ----------------------------- --------------------
 63e72035-3fcf-4fdc-b88a-05e30d1ba224 Field Test OS Evaluation Default Field Test OS Evaluation device group 6f52bead-700d-4289-bdc2-2f11f774270e RetailEval Accept all updates from the Azure Sphere Security Service.             False                         None
 ------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------

excluir

Exclui o grupo de dispositivos especificado em seu locatário do Azure Sphere.

Um grupo de dispositivos só pode ser excluído quando:

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-g, --grupo-de-dispositivos String Especifica o grupo de dispositivos a ser excluído. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

azsphere device-group delete --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd
Successfully deleted the device group

azsphere device-group delete --device-group DW100/Development
Successfully deleted the device group

implantação

Gerencia implantações para um grupo de dispositivos.

Operação Descrição
create Cria uma implantação para o grupo de dispositivos especificado.
lista Exibe implantações para um grupo de dispositivos.

criação da implantação…

Cria uma nova implantação para um grupo de dispositivos com as imagens fornecidas.

É possível identificar o grupo de dispositivos por ID (identificador) ou por um nome de produto e par de nome de grupo de dispositivos.

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-g, --grupo-de-dispositivos String Especifica o grupo de dispositivos no qual criar a implantação. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.
-i, --imagens String Especifica as IDs de imagem para uma ou mais imagens a serem incluídas na implantação. Você pode adicionar várias imagens adicionando parâmetros adicionais ou várias IDs de imagem podem ser combinadas em um único parâmetro em uma lista separada por espaços. Execute o comando azsphere image add para obter a ID da imagem.

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

O --device-group parâmetro identifica o grupo de dispositivos. A ID do grupo de dispositivos fornece um GUID, que identifica exclusivamente o grupo de dispositivos em todos os produtos. Como alternativa, você pode usar o par de nome do produto e nome do grupo de dispositivos no <formato product-name>/<device-group-name> . Esse par de nomes identifica exclusivamente um grupo de dispositivos para um produto específico.

Exemplo para especificar o grupo de dispositivos por ID:

azsphere device-group deployment create --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --images 5572509b-43a4-45b0-88c5-365cbf9732c1

Exemplo para especificar o grupo de dispositivos por nome:

azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1

Exemplo para especificar várias IDs de imagem fornecendo uma lista de valores separados por espaços:

azsphere device-group deployment create --device-group DW100/Development --images 5572509b-43a4-45b0-88c5-365cbf9732c1 3bbd2d2a-2870-4dde-9db8-ae50548ea7b4

Você deve ver uma saída como a abaixo:

------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id                                   TenantId                             DeployedImages                       DeploymentDateUtc                    
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb 5572509b-43a4-45b0-88c5-365cbf9732c1 2021-04-01T18:48:41.721662+00:00     
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------

deployment list

Exibe o histórico de implantação para um grupo de dispositivos. Retorna a ID de implantação, o carimbo de data/hora e a lista de imagens incluídas. A lista é ordenada por implantações mais recentes.

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-g, --grupo-de-dispositivos String Especifica o grupo de dispositivos para o qual exibir a lista de histórico de implantação. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

Exemplo para especificar o grupo de dispositivos por ID:

azsphere device-group deployment list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

Exemplo para especificar o grupo de dispositivos por nome:

azsphere device-group deployment list --device-group DW100/Development

Você deve ver uma saída como a abaixo:

------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
Id                                   TenantId                             DeployedImages                       DeploymentDateUtc                   
===================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb e3769536-dc4b-48d9-afd4-22ed321ba4bc 2020-11-18T19:46:50.514429+00:00    
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------

dispositivo

Gerencia dispositivos para um grupo de dispositivos.

Operação Descrição
lista Exibe os dispositivos em um grupo de dispositivos.
show-count Mostra o número de dispositivos no grupo de dispositivos.

device list

Exibe os dispositivos em um grupo de dispositivos.

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-g, --grupo-de-dispositivos String Especifica o grupo de dispositivos para o qual exibir a lista de dispositivos. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

Exemplo para especificar o grupo de dispositivos por ID:

azsphere device-group device list --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

Exemplo para especificar o grupo de dispositivos por nome:

azsphere device-group device list --device-group DW100/Marketing

Você deve ver uma saída como a abaixo:

-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId                                                                                                                         TenantId                             ProductId                            DeviceGroupId                           
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd    
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------

device show-count

Mostra o número de dispositivos em um grupo de dispositivos.

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-g, --grupo-de-dispositivos String Especifica o grupo de dispositivos para o qual mostrar a contagem de dispositivos. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

Exemplo para especificar o grupo de dispositivos por ID:

azsphere device-group device show-count --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

Exemplo para especificar o grupo de dispositivos por nome:

azsphere device-group device show-count --device-group DW100/Marketing

Você deve ver uma saída como a abaixo:

------
Result
======
1
------

show

Retorna informações sobre um grupo de dispositivos.

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-g, --grupo-de-dispositivos String Especifica o grupo de dispositivos para o qual exibir detalhes. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.

Parâmetros opcionais

Parâmetro Tipo Descrição
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

Exemplo para especificar o grupo de dispositivos por ID:

azsphere device-group show --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd

Exemplo para especificar o grupo de dispositivos por nome:

azsphere device-group show --device-group DW100/Marketing

Você deve ver uma saída como a abaixo:

------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Id                                   Name      Description            TenantId                             ProductId                            OsFeedType UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd Marketing Marketing device group 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e Retail     Accept all updates from the Azure Sphere Security Service. False                         None                         
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------

update

Atualiza um grupo de dispositivos existente, identificado por ID ou por nome do produto e par do nome do grupo de dispositivos.

Parâmetros obrigatórios

Parâmetro Tipo Descrição
-g, --grupo-de-dispositivos String Especifica o grupo de dispositivos para o qual atualizar os detalhes. Você pode especificar a ID do grupo de dispositivos ou o nome do grupo de dispositivos. Para usar o nome do grupo de dispositivos, você deve fornecer o nome do produto e o nome do grupo de dispositivos no <product-name/device-group-name> formato.

Parâmetros opcionais

Parâmetro Tipo Descrição
-c, --allow-crash-dumps-collection String Defina o consentimento para a coleta de despejos de memória pela Microsoft para o grupo de dispositivos. O padrão é Off. Valores permitidos: Off e On. Use o --regional-data-boundary parâmetro para especificar onde os arquivos de despejo de memória devem ser armazenados. Para obter mais informações, consulte Configurar despejos de memória.
-a, --atualização do aplicativo ApplicationUpdatePolicyType Especifica a política de atualização de aplicativo para o grupo de dispositivos. Valores permitidos: No3rdPartyAppUpdates, UpdateAll e NoUpdates. O padrão é UpdateAll. No momento, a NoUpdates política está reservada apenas para uso interno.
-d, --nova-descrição String Especifica o texto opcional para descrever o grupo de dispositivos. O tamanho máximo é de 100 caracteres.
-n, --novo-nome String Especifica um novo nome para o grupo de dispositivos. O nome só pode incluir caracteres alfanuméricos. Se o nome contiver espaços, coloque-o entre aspas. O nome do grupo de dispositivos não pode exceder 50 caracteres, não diferencia maiúsculas de minúsculas e deve ser exclusivo no produto.
-f, --os-feed String Especifica o feed do sistema operacional para o grupo de dispositivos. Os valores possíveis são Retail e RetailEval.
-t, --inquilino GUID ou nome Especifica o locatário no qual executar essa operação. Substitui o locatário padrão selecionado. Você pode especificar a ID do locatário ou o nome do locatário.
-r, --limite de dados regionais String Limite de dados regional para esta imagem. Valores Permitidos: EU e None. O valor padrão é None. Se nenhum valor for especificado, o valor padrão será usado. Para obter mais informações, consulte Configurar despejos de memória - Considerações sobre Pivacy
Parâmetros Globais

Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:

Parâmetro Descrição
--debug Aumenta o detalhamento do log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o sinalizador --debug ao enviar um relatório de bugs.
-h, --help Imprime informações de referência da CLI sobre comandos e seus argumentos e lista subgrupos e comandos disponíveis.
--only-show-errors Mostra apenas erros, suprimindo avisos.
-o, --output Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (valores separados por tabulação), table (tabelas ASCII legíveis por humanos) e yaml. Por padrão, a CLI gera table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere.
--query Usa a linguagem de consulta JMESPath para filtrar a saída retornada dos Serviços de Segurança do Azure Sphere. Consulte o tutorial JMESPath e a saída do comando Consultar a CLI do Azure para obter mais informações e exemplos.
--verbose Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Use --debug para logs de depuração completos.

Observação

Se você estiver usando a CLI clássica do Azure Sphere, consulte Parâmetros globais para obter mais informações sobre as opções disponíveis.

Exemplo

Exemplo para especificar o grupo de dispositivos por ID:

azsphere device-group update --device-group 7f860cc1-4949-4000-a541-9a988ba4c3cd --new-description "Marketing device group"

Exemplo para especificar o grupo de dispositivos por nome:

azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"

Você deve ver uma saída como a abaixo:

------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
Id                                   TenantId                             OsFeedType ProductId                            Name      Description            UpdatePolicy                                               AllowCrashDumpsCollection     RegionalDataBoundary
========================================================================================================================================================================================================================================================================
7f860cc1-4949-4000-a541-9a988ba4c3cd 143adbc9-1bf0-4be2-84a2-084a331d81cb Retail     6f52bead-700d-4289-bdc2-2f11f774270e Marketing Marketing device group Accept all updates from the Azure Sphere Security Service. False                         None
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------