az iot device registration

Pré-visualizar

Note

Esta referência faz parte da extensão azure-iot para o CLI do Azure (versão 2.70.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando de registro de dispositivo az iot. Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie registros de dispositivos IoT para o Serviço de Provisionamento de Dispositivos IoT.

Use az iot dps enrollment registration ou az iot dps enrollment-group registration para exibir e excluir registros.

Comandos

Name	Description	Tipo	Status
az iot device registration create	Registre um dispositivo IoT com o Serviço de Provisionamento de Dispositivo IoT.	Extension	Preview

az iot device registration create

Pré-visualizar

O grupo de comandos 'iot device registration' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Registre um dispositivo IoT com o Serviço de Provisionamento de Dispositivo IoT.

São suportados os seguintes mecanismos de certificação:

Chave simétrica
Certificado x509 Se estiver usando métodos de autenticação x509, o certificado e os arquivos de chave (e a frase secreta, se necessário) deverão ser fornecidos.

az iot device registration create --registration-id --rid
                                  [--acquire-policy-token]
                                  [--auth-type {key, login}]
                                  [--certificate-file-path --cp]
                                  [--change-reference]
                                  [--ck --compute-key]
                                  [--dps-name]
                                  [--enrollment-group-id --gid --group-id]
                                  [--host --provisioning-host]
                                  [--id-scope --scope]
                                  [--key --symmetric-key]
                                  [--key-file-path --kp]
                                  [--login]
                                  [--pass --passphrase]
                                  [--payload]
                                  [--resource-group]

Exemplos

Registre um dispositivo IoT usando uma inscrição individual.

az iot device registration create -n {dps_name} --rid {registration_id}

Registre um dispositivo IoT usando um registro de grupo.

az iot device registration create -n {dps_name} --rid {registration_id} --gid {group_enrollment_id}

Registre um dispositivo IoT usando um registro individual, o escopo do ID do Serviço de Provisionamento de Dispositivo e uma chave simétrica fornecida. Isso ignorará a recuperação do Escopo de ID e da chave simétrica de registro individal.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Registre um dispositivo IoT usando um registro de grupo, o escopo de ID do Serviço de Provisionamento de Dispositivo e uma chave simétrica de grupo de registro dada. Isso ignorará a recuperação do Escopo da ID e da chave simétrica do grupo de inscrição. A chave simétrica utilizada para o registo do dispositivo será calculada a partir da chave simétrica fornecida.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --gid {group_enrollment_id} --key {symmetric_key} --ck

Registre um dispositivo IoT usando um registro de grupo, o escopo do ID do Serviço de Provisionamento de Dispositivo e uma chave simétrica fornecida. Isso ignorará a recuperação do escopo da ID. Observe que, como a chave simétrica deve ser a chave do dispositivo computado, a ID do grupo de inscrição não é necessária.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --key {symmetric_key}

Registre um dispositivo IoT usando um registro individual, o escopo da ID do Serviço de Provisionamento de Dispositivo e determinados arquivos de certificado e chave. Isso ignorará a recuperação do escopo da ID.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Registre um dispositivo IoT usando um registro individual, o Escopo de ID do Serviço de Provisionamento de Dispositivo e arquivos de certificado e chave e senha para o arquivo de chave. Isso ignorará a recuperação do escopo da ID.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file} --pass {passphrase}

Registre um dispositivo IoT usando um registro de grupo, o escopo da ID do Serviço de Provisionamento de Dispositivo e determinados arquivos de certificado e chave. Isso ignorará a recuperação do escopo da ID. Observe que a ID de inscrição do grupo não é necessária para atestados x509 e o assunto do arquivo de certificado é a ID de registro.

az iot device registration create --id-scope {id_scope} --rid {registration_id} --cp {certificate_file} --kp {key_file}

Parâmetros Obrigatórios

--registration-id --rid

ID de registo do dispositivo ou ID de inscrição individual.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--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 login e o nome de host do recurso for fornecido, a pesquisa de recursos será ignorada, a menos que necessário. Você pode configurar o padrão usando az configure --defaults iothub-data-auth-type={auth-type-value}.

Propriedade	Valor
Grupo de parâmetros:	Access Control Arguments
Default value:	key
Valores aceites:	key, login

--certificate-file-path --cp

Caminho para o arquivo PEM do certificado. Necessário para registros x509.

Propriedade	Valor
Grupo de parâmetros:	x509 Authentication Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--ck --compute-key

Sinalizador para indicar que a chave simétrica para o registro do dispositivo deve ser calculada a partir da chave dada com --symmetric-key.

Propriedade	Valor
Grupo de parâmetros:	Symmetric Key Authentication Arguments
Default value:	False

--dps-name -n

Nome do Azure IoT Zoom Device Provisioning Service. Obrigatório se --login não for fornecido ou se os argumentos authenticaton e --id-scope não forem fornecidos.

Propriedade	Valor
Grupo de parâmetros:	DPS Identifier Arguments

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

ID do grupo de inscrição. Só é necessário recuperar argumentos de autenticação.

--host --provisioning-host

Ponto de extremidade apontando para o host de provisionamento a ser usado.

Propriedade	Valor
Default value:	global.azure-devices-provisioning.net

--id-scope --scope

ID Scope do Hub IoT do Azure Device Provisioning Service. Se fornecido com argumentos de autenticação, evitará o login da sessão.

Propriedade	Valor
Grupo de parâmetros:	DPS Identifier Arguments

--key --symmetric-key

A chave de acesso compartilhada simétrica para o registro do dispositivo.

Propriedade	Valor
Grupo de parâmetros:	Symmetric Key Authentication Arguments

--key-file-path --kp

Caminho para o arquivo PEM chave. Necessário para registros x509.

Propriedade	Valor
Grupo de parâmetros:	x509 Authentication Arguments

--login -l

Este comando suporta uma cadeia de ligação de entidade com direitos para executar ações. Use para evitar login de sessão via "az login". Se forem fornecidos tanto uma entidade, cadeia de ligação como o nome, a cadeia de ligação tem prioridade. Obrigatório se --dps-name não for fornecido ou se os argumentos authenticaton e --id-scope não forem fornecidos.

Propriedade	Valor
Grupo de parâmetros:	DPS Identifier Arguments

--pass --passphrase

Senha para o certificado.

Propriedade	Valor
Grupo de parâmetros:	x509 Authentication Arguments

--payload

Carga útil de alocação personalizada como JSON. Especificamente para uso com políticas de alocação personalizadas usando o Funções do Azure.

--resource-group -g

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

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

Comentários

Esta página foi útil?