Compartilhar via


az sphere device-group

Note

Essa referência faz parte da extensão do azure-sphere para a CLI do Azure (versão 2.45.0 ou superior). A extensão instalará automaticamente na primeira vez que você executar um comando az sphere device-group. Saiba mais sobre extensões.

Gerenciar grupos de dispositivos em seu grupo de recursos e catálogo.

Comandos

Nome Description Tipo Status
az sphere device-group create

Criar um grupo de dispositivos.

Extension GA
az sphere device-group create-defaults

Crie grupos de dispositivos padrão direcionados a um produto.

Extension GA
az sphere device-group delete

Exclua o grupo de dispositivos especificado.

Extension GA
az sphere device-group list

Listar todos os grupos de dispositivos em um catálogo.

Extension GA
az sphere device-group show

Mostrar os detalhes de um grupo de dispositivos.

Extension GA
az sphere device-group update

Atualize os detalhes de um grupo de dispositivos.

Extension GA

az sphere device-group create

Criar um grupo de dispositivos.

az sphere device-group create --catalog
                              --description
                              --name
                              --product
                              --resource-group
                              [--allow-crash-dumps-collection {Disabled, Enabled}]
                              [--application-update {No3rdPartyAppUpdates, UpdateAll}]
                              [--os-feed {Retail, RetailEval}]
                              [--regional-data-boundary {EU, None}]

Exemplos

Crie um novo grupo de dispositivos "MyDeviceGroup" no grupo de recursos "MyResourceGroup", catálogo "MyCatalog", produto "MyProduct", descrição "MyDescription" e limite de dados regionais padrão.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --name MyDeviceGroup --description MyDescription

Crie um novo grupo de dispositivos "MyDeviceGroup" no grupo de recursos "MyResourceGroup", catálogo "MyCatalog", produto "MyProduct", descrição "MyDescription" e especifique um limite de dados regional.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --name MyDeviceGroup --description MyDescription --regional-data-boundary EU

Parâmetros Exigidos

--catalog -c

O Catálogo do Azure Sphere no qual executar essa operação. Especifique o nome do Catálogo do Azure Sphere. Você pode configurar o Catálogo do Azure Sphere padrão usando az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--description -d

Descrição do grupo de dispositivos.

--name -n

Nome alfanumérico do grupo de dispositivos.

--product -p

O nome do produto.

Propriedade Valor
Valor de: az sphere product list
--resource-group -g

Nome do grupo de recursos do Azure. Você pode configurar o grupo padrão usando az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--allow-crash-dumps-collection -cd

Forneça consentimento para a coleta de despejos de memória da Microsoft para esse grupo de dispositivos. Para obter mais informações, consulte https://aka.ms/AzureSphereCrashDumpsCollection.

Propriedade Valor
Valor padrão: Disabled
Valores aceitos: Disabled, Enabled
--application-update -a

Política de atualização de aplicativo para este grupo de dispositivos.

Propriedade Valor
Valor padrão: UpdateAll
Valores aceitos: No3rdPartyAppUpdates, UpdateAll
--os-feed -f

O tipo de feed do sistema operacional a ser usado para atualizações do sistema operacional.

Propriedade Valor
Valor padrão: Retail
Valores aceitos: Retail, RetailEval
--regional-data-boundary -r

Limite de dados regional para esse grupo de dispositivos.

Propriedade Valor
Valor padrão: None
Valores aceitos: EU, None
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sphere device-group create-defaults

Crie grupos de dispositivos padrão direcionados a um produto.

az sphere device-group create-defaults --catalog
                                       --product
                                       --resource-group

Exemplos

Crie grupos de dispositivos padrão no grupo de recursos "MyResourceGroup", catálogo "MyCatalog" e produto "MyProduct".

az sphere device-group create-defaults --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Parâmetros Exigidos

--catalog -c

O Catálogo do Azure Sphere no qual executar essa operação. Especifique o nome do Catálogo do Azure Sphere. Você pode configurar o Catálogo do Azure Sphere padrão usando az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--product -p

O nome do produto.

Propriedade Valor
Valor de: az sphere product list
--resource-group -g

Nome do grupo de recursos do Azure. Você pode configurar o grupo padrão usando az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sphere device-group delete

Exclua o grupo de dispositivos especificado.

az sphere device-group delete --catalog
                              --device-group
                              --product
                              --resource-group

Exemplos

Exclua um grupo de dispositivos usando o grupo de recursos, o nome do catálogo, o nome do produto e o nome do grupo de dispositivos.

az sphere device-group delete --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

Parâmetros Exigidos

--catalog -c

O Catálogo do Azure Sphere no qual executar essa operação. Especifique o nome do Catálogo do Azure Sphere. Você pode configurar o Catálogo do Azure Sphere padrão usando az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--device-group -dg

O nome do grupo de dispositivos.

Propriedade Valor
Valor de: az sphere device-group list
--product -p

O produto para o qual excluir os grupos de dispositivos.

Propriedade Valor
Valor de: az sphere product list
--resource-group -g

Nome do grupo de recursos do Azure. Você pode configurar o grupo padrão usando az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sphere device-group list

Listar todos os grupos de dispositivos em um catálogo.

az sphere device-group list --catalog
                            --resource-group
                            [--device-group]
                            [--product]

Exemplos

Listar todos os grupos de dispositivos em um grupo de recursos e catálogo.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog

Liste todos os grupos de dispositivos com o nome especificado em um grupo de recursos e catálogo.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog --device-group Development

Liste todos os grupos de dispositivos em um grupo de recursos, catálogo e produto.

az sphere device-group list --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct

Parâmetros Exigidos

--catalog -c

O Catálogo do Azure Sphere no qual executar essa operação. Especifique o nome do Catálogo do Azure Sphere. Você pode configurar o Catálogo do Azure Sphere padrão usando az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--resource-group -g

Nome do grupo de recursos do Azure. Você pode configurar o grupo padrão usando az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--device-group -dg

Listar todos os grupos de dispositivos que têm um nome especificado.

--product -p

Listar todos os grupos de dispositivos em um produto.

Propriedade Valor
Valor de: az sphere product list
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sphere device-group show

Mostrar os detalhes de um grupo de dispositivos.

az sphere device-group show --catalog
                            --device-group
                            --product
                            --resource-group

Exemplos

Mostrar detalhes de um grupo de dispositivos usando o grupo de recursos, o nome do catálogo, o nome do produto e o nome do grupo de dispositivos.

az sphere device-group show --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup

Parâmetros Exigidos

--catalog -c

O Catálogo do Azure Sphere no qual executar essa operação. Especifique o nome do Catálogo do Azure Sphere. Você pode configurar o Catálogo do Azure Sphere padrão usando az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--device-group -dg

O grupo de dispositivos a ser mostrado.

Propriedade Valor
Valor de: az sphere device-group list
--product -p

O nome do produto para o qual mostrar o grupo de dispositivos.

Propriedade Valor
Valor de: az sphere product list
--resource-group -g

Nome do grupo de recursos do Azure. Você pode configurar o grupo padrão usando az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az sphere device-group update

Atualize os detalhes de um grupo de dispositivos.

az sphere device-group update --catalog
                              --device-group
                              --product
                              --resource-group
                              [--allow-crash-dumps-collection {Disabled, Enabled}]
                              [--application-update {No3rdPartyAppUpdates, UpdateAll}]
                              [--description]
                              [--os-feed {Retail, RetailEval}]
                              [--regional-data-boundary {EU, None}]

Exemplos

Atualize as propriedades de um grupo de dispositivos.

az sphere device-group update --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --description NewDescription

Parâmetros Exigidos

--catalog -c

O Catálogo do Azure Sphere no qual executar essa operação. Especifique o nome do Catálogo do Azure Sphere. Você pode configurar o Catálogo do Azure Sphere padrão usando az config set defaults.sphere.catalog=<name>. Valores de: az sphere catalog list.

--device-group -dg

O nome do grupo de dispositivos.

Propriedade Valor
Valor de: az sphere device-group list
--product -p

O nome do produto.

Propriedade Valor
Valor de: az sphere product list
--resource-group -g

Nome do grupo de recursos do Azure. Você pode configurar o grupo padrão usando az config set defaults.group=<name>. Valores de: az group list.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--allow-crash-dumps-collection -cd

Forneça consentimento para a coleta de despejos de memória da Microsoft para esse grupo de dispositivos. Para obter mais informações, consulte https://aka.ms/AzureSphereCrashDumpsCollection.

Propriedade Valor
Valores aceitos: Disabled, Enabled
--application-update -a

Política de atualização de aplicativo para este grupo de dispositivos.

Propriedade Valor
Valores aceitos: No3rdPartyAppUpdates, UpdateAll
--description -d

Uma nova descrição do grupo de dispositivos.

--os-feed -f

O tipo de feed do sistema operacional a ser usado para atualizações do sistema operacional.

Propriedade Valor
Valores aceitos: Retail, RetailEval
--regional-data-boundary -r

Limite de dados regional para esse grupo de dispositivos.

Propriedade Valor
Valores aceitos: EU, None
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False