grupo-dispositivo
Importante
Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) 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 endereçados por identificador (ID) ou por um nome de produto e par de nomes de grupos de dispositivos.
| Operation | Description |
|---|---|
| criar | Cria um novo grupo de dispositivos. |
| list | Liste todos os grupos de dispositivos em seu locatário do Azure Sphere. |
| eliminar | Exclui um grupo de dispositivos existente. |
| implantação | Gerencia implantações dentro de um grupo de dispositivos. |
| dispositivo | Lista dispositivos em um grupo de dispositivos. |
| programa | Exibe informações sobre um grupo de dispositivos. |
| atualizar | Modifica um grupo de dispositivos existente. |
criar
Cria um grupo de dispositivos com o nome especificado para o produto especificado. O grupo de dispositivos organiza dispositivos que têm o mesmo produto e recebem os mesmos aplicativos da nuvem.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -p, --produto | GUID ou nome | Especifica o produto ao qual adicionar este grupo de dispositivos. Você pode especificar a ID ou o nome do produto Azure Sphere. |
| -n, --nome | String | Especifica um nome para o grupo de dispositivos. O nome só pode incluir caracteres alfanuméricos. Se o nome incluir 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, deve ser exclusivo dentro do produto. |
Parâmetros opcionais
| Parâmetro | Tipo | Description |
|---|---|---|
| -a, --application-update | Enumeração | Especifica a política de atualização de aplicativo a ser aplicada para este grupo de dispositivos. Valores aceites: No3rdPartyAppUpdates, UpdateAll, e NoUpdates. A predefinição é UpdateAll. Atualmente, a NoUpdates política está reservada apenas para uso interno. |
| -f, --os-alimentação | Enumeração | Especifica o tipo de feed do sistema operacional a ser usado para atualizações do sistema operacional. Valores aceites: Retail, RetailEval. |
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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 comprimento máximo é de 100 caracteres. Se a descrição incluir espaços, coloque-a entre aspas. |
| -r, --regional-data-boundary | String | Limite de dados regionais para esta imagem. Valores permitidos: EU, None. O valor predefinido é 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
list
Liste todos os grupos de dispositivos em seu locatário do Azure Sphere.
Parâmetros opcionais
| Parâmetro | Tipo | Description |
|---|---|---|
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
delete
Exclui o grupo de dispositivos especificado em seu locatário do Azure Sphere.
Um grupo de dispositivos só pode ser excluído quando:
- O usuário tem permissões de administrador para o locatário.
- O grupo de dispositivos está vazio e não tem dispositivos. O comando azsphere device-group device list lista todos os dispositivos em um grupo de dispositivos. Execute azsphere device update --device-group para mover o dispositivo para um grupo de dispositivos diferente.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -g, --grupo-dispositivo | String | Especifica o grupo de dispositivos a ser excluído. Você pode especificar o 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 | Description |
|---|---|---|
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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
implementação
Gerencia implantações para um grupo de dispositivos.
| Operation | Description |
|---|---|
| criar | Cria uma nova implantação para o grupo de dispositivos especificado. |
| list | Exibe as implantações para um grupo de dispositivos. |
criação de implantação
Cria uma nova implantação para um grupo de dispositivos com as imagens fornecidas.
Você pode identificar o grupo de dispositivos por identificador (ID) ou por um nome de produto e par de nomes de grupos de dispositivos.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -g, --grupo-dispositivo | String | Especifica o grupo de dispositivos no qual criar a implantação. Você pode especificar o 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ários IDs de imagem podem ser combinados em um único parâmetro em uma lista separada por espaço. Execute o comando azsphere image add para obter o ID da imagem. |
Parâmetros opcionais
| Parâmetro | Tipo | Description |
|---|---|---|
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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. O 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 nome do produto e o par de nomes do grupo de dispositivos no <formato product-name>/<device-group-name> . Este par de nomes identifica exclusivamente um grupo de dispositivos para um determinado produto.
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ários 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
Deverá ver um resultado como este:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
lista de implantação
Exibe o histórico de implantação de 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 pelas implantações mais recentes.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -g, --grupo-dispositivo | String | Especifica o grupo de dispositivos para o qual exibir a lista de histórico de implantação. Você pode especificar o 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 | Description |
|---|---|---|
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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
Deverá ver um resultado como este:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
device
Gerencia dispositivos para um grupo de dispositivos.
| Operation | Description |
|---|---|
| list | Exibe os dispositivos em um grupo de dispositivos. |
| contagem-espetáculo | Mostra o número de dispositivos em um grupo de dispositivos. |
Lista de dispositivos
Exibe os dispositivos em um grupo de dispositivos.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -g, --grupo-dispositivo | String | Especifica o grupo de dispositivos para o qual a lista de dispositivos deve ser exibida. Você pode especificar o 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 | Description |
|---|---|---|
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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
Deverá ver um resultado como este:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
show-count do dispositivo
Exibe o número de dispositivos em um grupo de dispositivos.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -g, --grupo-dispositivo | String | Especifica o grupo de dispositivos para o qual mostrar a contagem de dispositivos. Você pode especificar o 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 | Description |
|---|---|---|
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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
Deverá ver um resultado como este:
------
Result
======
1
------
mostrar
Retorna informações sobre um grupo de dispositivos.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -g, --grupo-dispositivo | String | Especifica o grupo de dispositivos para o qual exibir detalhes. Você pode especificar o 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 | Description |
|---|---|---|
| -t, --inquilino | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar o 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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
Deverá ver um resultado como este:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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 de produto e par de nomes de grupos de dispositivos.
Parâmetros obrigatórios
| Parâmetro | Tipo | Description |
|---|---|---|
| -g, --grupo-dispositivo | String | Especifica o grupo de dispositivos para o qual atualizar detalhes. Você pode especificar o 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 | Description |
|---|---|---|
| -c, --allow-crash-dumps-collection | String | Defina o consentimento para a coleta de despejos de memória pela Microsoft para o grupo de dispositivos. A predefiniçã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, --application-update | ApplicationUpdatePolicyType | Especifica a política de atualização de aplicativo para o grupo de dispositivos. Valores permitidos: No3rdPartyAppUpdates, UpdateAll, e NoUpdates. A predefinição é UpdateAll. Atualmente, 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 comprimento 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 incluir 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 dentro do produto. |
| -f, --os-alimentação | 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 selecionado padrão. Você pode especificar o ID do locatário ou o nome do locatário. |
| -r, --regional-data-boundary | String | Limite de dados regionais para esta imagem. Valores permitidos: EU, None. O valor predefinido é 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 | Description |
|---|---|
| --depuração | Aumenta a verbosidade do registro para mostrar todos os logs de depuração. Se detetar um erro, forneça o resultado gerado com o sinalizador --debug ativado quando enviar um relatório de erros. |
| -h, --ajuda | 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, --saída | Altera o formato de saída. Os formatos de saída disponíveis são json, jsonc (JSON colorido), tsv (Tab-Separated Values), table (tabelas ASCII legíveis por humanos) e yaml. Por predefinição, a CLI produz table. Para saber mais sobre os formatos de saída disponíveis, consulte Formato de saída para comandos da CLI do Azure Sphere. |
| --consulta | 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 Query Azure CLI para obter mais informações e exemplos. |
| --verborrágico | Imprime informações sobre recursos criados no Azure Sphere durante uma operação e outras informações úteis. Utilize --debug para os registos de depuração completos. |
Nota
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"
Deverá ver um resultado como este:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------