grupo de dispositivos
Cria e gerencia grupos de dispositivos.
Os grupos de dispositivos são endereçados por identificador (ID) ou por um par de nomes de grupo de dispositivos e nome do produto.
Operação | Descrição |
---|---|
Criar | Cria um novo grupo de dispositivos. |
Lista | Liste todos os grupos de dispositivos no locatário do Azure Sphere. |
Excluir | Exclui um grupo de dispositivos existente. |
Implantação | Gerencia implantações em um grupo de dispositivos. |
Dispositivo | Lista dispositivos em um grupo de dispositivos. |
programa | Exibe informações sobre um grupo de dispositivos. |
Atualização | 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 necessários
Parâmetro | Tipo | Descrição |
---|---|---|
-p, --product | 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 incluir espaços, inclua-o entre aspas. O nome do grupo de dispositivos não pode exceder 50 caracteres, é insensível ao caso, deve ser exclusivo dentro do produto. |
Parâmetros opcionais
Parâmetro | Tipo | Descrição |
---|---|---|
-a, --application-update | Enum | Especifica a política de atualização do aplicativo a ser aplicada a esse grupo de dispositivos. Valores aceitos: No3rdPartyAppUpdates , UpdateAll e NoUpdates . O padrão é UpdateAll . Atualmente, a NoUpdates política é 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, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar a ID do locatário ou o nome do locatário. |
-d, --description | 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, inclua-o entre aspas. |
-r, --regional-data-boundary | String | Limite de dados regional para essa imagem. Valores permitidos: EU , 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 falha – considerações de Pivacy |
Parâmetros globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
Parâmetro | Descrição |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Lista
Liste todos os grupos de dispositivos no locatário do Azure Sphere.
Parâmetros opcionais
Parâmetro | Tipo | Descrição |
---|---|---|
-t, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. 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 |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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
------------------------------------ ------------------------ --------------------------------------------- ------------------------------------ ---------- ---------------------------------------------------------------------- --------------------------------------------------
Excluir
Exclui o grupo de dispositivos especificado no 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 nele. 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 necessários
Parâmetro | Tipo | Descrição |
---|---|---|
-g, --device-group | 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 do dispositivo no <product-name/device-group-name> formato. |
Parâmetros opcionais
Parâmetro | Tipo | Descrição |
---|---|---|
-t, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. 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 |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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
Implantação
Gerencia implantações para um grupo de dispositivos.
Operação | Descrição |
---|---|
Criar | Cria uma nova implantação para o grupo de dispositivos especificado. |
Lista | Exibe as implantações de um grupo de dispositivos. |
implantação criar
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 par de nomes de grupo de dispositivos e nome do produto.
Parâmetros necessários
Parâmetro | Tipo | Descrição |
---|---|---|
-g, --device-group | 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 do dispositivo no <product-name/device-group-name> formato. |
-i, --images | 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ço. Execute o comando azsphere image add para obter a ID da imagem. |
Parâmetros opcionais
Parâmetro | Tipo | Descrição |
---|---|---|
-t, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. 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 |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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. 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 nome do produto e o par de nomes do grupo de dispositivos no <formato nome> do produto/<dispositivo-grupo-nome> . Esse 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 pelo 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 esta:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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 necessários
Parâmetro | Tipo | Descrição |
---|---|---|
-g, --device-group | 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 do dispositivo no <product-name/device-group-name> formato. |
Parâmetros opcionais
Parâmetro | Tipo | Descrição |
---|---|---|
-t, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. 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 |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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 pelo nome:
azsphere device-group deployment list --device-group DW100/Development
Você deve ver uma saída como esta:
------------------------------------ ------------------------------------ ------------------------------------ ------------------------------------
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 em um grupo de dispositivos. |
lista de dispositivos
Exibe os dispositivos em um grupo de dispositivos.
Parâmetros necessários
Parâmetro | Tipo | Descrição |
---|---|---|
-g, --device-group | 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 do dispositivo no <product-name/device-group-name> formato. |
Parâmetros opcionais
Parâmetro | Tipo | Descrição |
---|---|---|
-t, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. 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 |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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 pelo nome:
azsphere device-group device list --device-group DW100/Marketing
Você deve ver uma saída como esta:
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
DeviceId TenantId ProductId DeviceGroupId
===================================================================================================================================================================================================================================================
352FE1F59E40EF8A9266415E81AF32B5B07D8F2BBD6B5650CEF4A70B86C7FCBC70B129A41FBC6D02F8BB4AAABC52CD5740C85427D205E46A166B7E41135EB968 143adbc9-1bf0-4be2-84a2-084a331d81cb 6f52bead-700d-4289-bdc2-2f11f774270e 7f860cc1-4949-4000-a541-9a988ba4c3cd
-------------------------------------------------------------------------------------------------------------------------------- ------------------------------------ ------------------------------------ ----------------------------------------
contagem de exibição de dispositivo
Exibe o número de dispositivos em um grupo de dispositivos.
Parâmetros necessários
Parâmetro | Tipo | Descrição |
---|---|---|
-g, --device-group | 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 do dispositivo no <product-name/device-group-name> formato. |
Parâmetros opcionais
Parâmetro | Tipo | Descrição |
---|---|---|
-t, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. 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 |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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 pelo nome:
azsphere device-group device show-count --device-group DW100/Marketing
Você deve ver uma saída como esta:
------
Result
======
1
------
programa
Retorna informações sobre um grupo de dispositivos.
Parâmetros necessários
Parâmetro | Tipo | Descrição |
---|---|---|
-g, --device-group | 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 do dispositivo no <product-name/device-group-name> formato. |
Parâmetros opcionais
Parâmetro | Tipo | Descrição |
---|---|---|
-t, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. 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 |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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 pelo nome:
azsphere device-group show --device-group DW100/Marketing
Você deve ver uma saída como esta:
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ --------- ---------------------- ------------------------------------ ------------------------------------ ---------- ---------------------------------------------------------- ----------------------------- --------------------
Atualização
Atualizações um grupo de dispositivos existente, identificado pela ID ou pelo nome do produto e pelo par de nomes do grupo de dispositivos.
Parâmetros necessários
Parâmetro | Tipo | Descrição |
---|---|---|
-g, --device-group | String | Especifica o grupo de dispositivos para o qual atualizar 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 do dispositivo 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 falhas 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 falhas devem ser armazenados. Para obter mais informações, consulte Configurar despejos de falha. |
-a, --application-update | ApplicationUpdatePolicyType | Especifica a política de atualização do aplicativo para o grupo de dispositivos. Valores permitidos: No3rdPartyAppUpdates , UpdateAll e NoUpdates . O padrão é UpdateAll . Atualmente, a NoUpdates política é reservada apenas para uso interno. |
-d, --new-description | String | Especifica texto opcional para descrever o grupo de dispositivos. O comprimento máximo é de 100 caracteres. |
-n, --new-name | String | Especifica um novo nome para o grupo de dispositivos. O nome só pode incluir caracteres alfanuméricos. Se o nome incluir espaços, inclua-o entre aspas. O nome do grupo de dispositivos não pode exceder 50 caracteres, é insensível ao caso e deve ser exclusivo dentro do 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, --locatário | GUID ou nome | Especifica o locatário no qual executar essa operação. Substitui o locatário selecionado padrão. Você pode especificar a ID do locatário ou o nome do locatário. |
-r, --regional-data-boundary | String | Limite de dados regional para essa imagem. Valores permitidos: EU , 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 falha – considerações de Pivacy |
Parâmetros globais
Os seguintes parâmetros globais estão disponíveis para a CLI do Azure Sphere:
Parâmetro | Descrição |
---|---|
--Depurar | Aumenta a verbosidade de log para mostrar todos os logs de depuração. Se você encontrar um bug, forneça a saída gerada com o --debug sinalizador ativado 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 Guia), tabela (tabelas ASCII legíveis pelo homem) e yaml. Por padrão, a CLI gera table . Para saber mais sobre os formatos de saída disponíveis, confira 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 de comando da 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. |
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 pelo nome:
azsphere device-group update --device-group DW100/Marketing --new-description "Marketing device group"
Você deve ver uma saída como esta:
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------
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
------------------------------------ ------------------------------------ ---------- ------------------------------------ --------- ---------------------- ---------------------------------------------------------- ----------------------------- --------------------