az iot dps

Referência

Nota

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerenciar o Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.

Comandos

Nome	Description	Tipo	Status
az iot dps certificate	Gerenciar certificados para uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps certificate create	Crie/carregue um certificado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps certificate delete	Exclua um certificado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps certificate generate-verification-code	Gere um código de verificação para um certificado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps certificate list	Liste todos os certificados contidos em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps certificate show	Mostrar informações sobre um certificado específico em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps certificate update	Atualize um certificado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps certificate verify	Verifique um certificado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps compute-device-key	Gerar uma chave SAS de dispositivo derivada.	Extensão	Deprecado
az iot dps connection-string	Gerenciar cadeias de conexão para uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps connection-string show	Mostrar as cadeias de conexão para os Serviços de Provisionamento de Dispositivos especificados usando o nome e a chave de política fornecidos.	Extensão	GA
az iot dps create	Crie uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps delete	Exclua uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps enrollment	Gerenciar registros individuais de dispositivo em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group	Gerenciar grupos de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group compute-device-key	Gere uma chave SAS de dispositivo derivada para um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group create	Crie um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group delete	Exclua um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group list	Listar grupos de registros em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group registration	Gerenciar registros de dispositivo do lado do serviço para um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group registration delete	Exclua um registro de dispositivo para um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group registration list	Listar registros de dispositivo para um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group registration show	Obtenha um registro de dispositivo para um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group show	Obtenha os detalhes de um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment-group update	Atualize um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment create	Crie um registro de dispositivo individual em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment delete	Exclua um registro de dispositivo individual em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment list	Listar registros de dispositivo individuais em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment registration	Gerenciar registros de dispositivo do lado do serviço para um registro individual em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment registration delete	Exclua um registro de dispositivo para um registro individual em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment registration show	Obtenha um registro de dispositivo para um registro individual em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment show	Obtenha detalhes de registro de dispositivo individual em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps enrollment update	Atualize um registro de dispositivo individual em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	GA
az iot dps linked-hub	Gerenciar Hubs IoT vinculados em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps linked-hub create	Crie um hub IoT vinculado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps linked-hub delete	Atualize um hub IoT vinculado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps linked-hub list	Liste todos os hubs IoT vinculados em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps linked-hub show	Mostrar detalhes de um hub IoT vinculado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps linked-hub update	Atualize um hub IoT vinculado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps list	Listar instâncias do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps policy	Gerenciar políticas de acesso compartilhado para uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps policy create	Crie uma nova política de acesso compartilhado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps policy delete	Exclua uma política de acesso compartilhado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps policy list	Liste todas as políticas de acesso compartilhado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps policy show	Mostrar detalhes de políticas de acesso compartilhado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps policy update	Atualize uma política de acesso compartilhado em uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps registration	Gerenciar registros de dispositivo para um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	Deprecado
az iot dps registration delete	Exclua um registro de dispositivo em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	Deprecado
az iot dps registration list	Listar registros de dispositivo para um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	Deprecado
az iot dps registration show	Obtenha um registro de dispositivo para um grupo de registro em um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Extensão	Deprecado
az iot dps show	Obtenha os detalhes de uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA
az iot dps update	Atualize uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.	Núcleo	GA

az iot dps compute-device-key

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use "iot dps enrollment-group compute-device-key".

Gerar uma chave SAS de dispositivo derivada.

Gere uma chave de dispositivo derivada para um grupo de registro DPS.

az iot dps compute-device-key --registration-id
                              [--auth-type {key, login}]
                              [--dps-name]
                              [--eid]
                              [--key]
                              [--login]
                              [--resource-group]

Exemplos

Compute a chave do dispositivo com a chave simétrica fornecida.

az iot dps compute-device-key --key {enrollement_group_symmetric_key} --registration-id {registration_id}

Compute a chave do dispositivo com o grupo de registro especificado.

az iot dps compute-device-key -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --registration-id {registration_id}

Parâmetros Exigidos

--registration-id

ID do registro do dispositivo.

Parâmetros Opcionais

--auth-type

Indica se a operação deve derivar automaticamente uma chave de política ou usar a sessão atual do Azure AD. Se o tipo de autenticação for logon e o nome do host do recurso for fornecido, a pesquisa de recursos será ignorada, a menos que seja necessário. Você pode configurar o padrão usando az configure --defaults iotdps-data-auth-type={auth-type-value}.

Valores aceitos: key, login

Valor padrão: key

--dps-name -n

Nome ou nome do host do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure. Necessário se --login não for fornecido.

--eid --enrollment-id --gid --group-id

ID do grupo de registro.

--key --symmetric-key

A chave de acesso compartilhado simétrica para o grupo de registro. Isso ignora o registro do Serviço de Provisionamento de Dispositivos e gera o token SAS diretamente da chave simétrica fornecida sem validação adicional. Todos os outros parâmetros de comando além da ID de registro serão ignorados.

--login -l

Esse comando dá suporte a uma cadeia de conexão de entidade com direitos para executar a ação. Use para evitar o logon da sessão por meio de "az login". Se uma cadeia de conexão de entidade e o nome forem fornecidos, a cadeia de conexão tem prioridade. Obrigatório se --dps-name não for fornecido.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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.

az iot dps create

Editar

Crie uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.

Para obter uma introdução ao Serviço de Provisionamento de Dispositivos do Hub IoT do Azure, consulte https://learn.microsoft.com/azure/iot-dps/about-iot-dps.

az iot dps create --name
                  --resource-group
                  [--edr {false, true}]
                  [--location]
                  [--sku {S1}]
                  [--tags]
                  [--unit]

Exemplos

Crie um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure com o tipo de preço padrão S1, na região do grupo de recursos.

az iot dps create --name MyDps --resource-group MyResourceGroup

Crie um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure com o tipo de preço padrão S1, na região 'eastus'.

az iot dps create --name MyDps --resource-group MyResourceGroup --location eastus

Crie um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure com a residência de dados imposta. Isso desabilitará a recuperação de desastre entre regiões.

az iot dps create --name MyDps --resource-group MyResourceGroup --edr

Parâmetros Exigidos

--name -n

Nome do Serviço de Provisionamento de Dispositivos do Hub IoT.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--edr --enforce-data-residency

Imponha a residência de dados para esse Serviço de Provisionamento de Dispositivos do Hub IoT desabilitando a recuperação de desastre entre pares geográficos. Essa propriedade é imutável uma vez definida no recurso. Disponível apenas em regiões selecionadas. Saiba mais em https://aka.ms/dpsdr.

Valores aceitos: false, true

--location -l

Local do serviço de provisionamento de dispositivos do Hub IoT. O padrão é o local do grupo de recursos de destino.

--sku

Tipo de preço para o Serviço de Provisionamento de Dispositivos do Hub IoT.

Valores aceitos: S1

Valor padrão: S1

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--unit

Unidades no serviço de provisionamento de dispositivos do Hub IoT.

Valor padrão: 1

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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.

az iot dps delete

Editar

Exclua uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.

az iot dps delete [--ids]
                  [--name]
                  [--resource-group]
                  [--subscription]

Exemplos

Excluir um serviço de provisionamento de dispositivos do Hub IoT do Azure 'MyDps'

az iot dps delete --name MyDps --resource-group MyResourceGroup

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

Nome do Serviço de Provisionamento de Dispositivos do Hub IoT.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

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

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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.

az iot dps list

Editar

Listar instâncias do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.

az iot dps list [--resource-group]

Exemplos

Liste todos os Serviços de Provisionamento de Dispositivos do Hub IoT do Azure em uma assinatura.

az iot dps list

Listar todos os Serviços de Provisionamento de Dispositivos do Hub IoT do Azure no grupo de recursos 'MyResourceGroup'

az iot dps list --resource-group MyResourceGroup

Parâmetros Opcionais

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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.

az iot dps show

Editar

Obtenha os detalhes de uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.

az iot dps show [--ids]
                [--name]
                [--resource-group]
                [--subscription]

Exemplos

Mostrar detalhes de um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure 'MyDps'

az iot dps show --name MyDps --resource-group MyResourceGroup

Parâmetros Opcionais

--ids

--name -n

Nome do Serviço de Provisionamento de Dispositivos do Hub IoT.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

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

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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.

az iot dps update

Editar

Atualize uma instância do Serviço de Provisionamento de Dispositivos do Hub IoT do Azure.

az iot dps update [--add]
                  [--force-string]
                  [--ids]
                  [--name]
                  [--remove]
                  [--resource-group]
                  [--set]
                  [--subscription]
                  [--tags]

Exemplos

Atualizar a Política de Alocação para 'GeoLatency' de um Serviço de Provisionamento de Dispositivos do Hub IoT do Azure 'MyDps'

az iot dps update --name MyDps --resource-group MyResourceGroup --set properties.allocationPolicy="GeoLatency"

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Valor padrão: []

--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Valor padrão: False

--ids

--name -n

Nome do Serviço de Provisionamento de Dispositivos do Hub IoT.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Valor padrão: []

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Valor padrão: []

--subscription

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

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais

--debug

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

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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.

Compartilhar via

az iot dps

Comandos

az iot dps compute-device-key

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az iot dps create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az iot dps delete

Exemplos

Parâmetros Opcionais

az iot dps list

Exemplos

Parâmetros Opcionais

az iot dps show

Exemplos

Parâmetros Opcionais

az iot dps update

Exemplos

Parâmetros Opcionais

Recursos adicionais