Udostępnij za pośrednictwem


az iot device registration

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.46.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot device registration . Dowiedz się więcej o rozszerzeniach.

Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Zarządzanie rejestracjami urządzeń IoT dla usługi IoT Device Provisioning.

Użyj az iot dps enrollment registration lub az iot dps enrollment-group registration , aby wyświetlić i usunąć rejestracje.

Polecenia

Nazwa Opis Typ Stan
az iot device registration create

Zarejestruj urządzenie IoT w usłudze IoT Device Provisioning Service.

Numer wewnętrzny Wersja Preview

az iot device registration create

Wersja zapoznawcza

Grupa poleceń "rejestracja urządzenia iot" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Zarejestruj urządzenie IoT w usłudze IoT Device Provisioning Service.

Obsługiwane są następujące mechanizmy zaświadczania:

  • Klucz symetryczny
  • Certyfikat x509 W przypadku używania metod uwierzytelniania x509 należy podać pliki certyfikatu i klucza (i hasło, jeśli to konieczne).
az iot device registration create --registration-id
                                  [--auth-type {key, login}]
                                  [--certificate-file-path]
                                  [--ck]
                                  [--dps-name]
                                  [--enrollment-group-id]
                                  [--host]
                                  [--id-scope]
                                  [--key]
                                  [--key-file-path]
                                  [--login]
                                  [--pass]
                                  [--payload]
                                  [--resource-group]

Przykłady

Rejestrowanie urządzenia IoT przy użyciu rejestracji indywidualnej.

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

Rejestrowanie urządzenia IoT przy użyciu rejestracji grupowej.

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

Zarejestruj urządzenie IoT przy użyciu rejestracji indywidualnej, zakresu identyfikatora usługi Device Provisioning i podanego klucza symetrycznego. Spowoduje to obejście pobierania zakresu identyfikatorów i klucza symetrycznego rejestracji individal.

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

Zarejestruj urządzenie IoT przy użyciu rejestracji grupy, zakresu identyfikatora usługi Device Provisioning i podanego klucza symetrycznego grupy rejestracji. Spowoduje to obejście pobierania zakresu identyfikatorów i klucza symetrycznego grupy rejestracji. Klucz symetryczny używany do rejestracji urządzenia zostanie obliczony na podstawie danego klucza symetrycznego.

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

Zarejestruj urządzenie IoT przy użyciu rejestracji grupy, zakresu identyfikatora usługi Device Provisioning i podanego klucza symetrycznego. Spowoduje to obejście pobierania zakresu identyfikatorów. Należy pamiętać, że ponieważ klucz symetryczny powinien być obliczonym kluczem urządzenia, identyfikator grupy rejestracji nie jest wymagany.

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

Zarejestruj urządzenie IoT przy użyciu rejestracji indywidualnej, zakresu identyfikatora usługi Device Provisioning oraz podanego certyfikatu i plików kluczy. Spowoduje to obejście pobierania zakresu identyfikatorów.

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

Zarejestruj urządzenie IoT przy użyciu rejestracji indywidualnej, zakresu identyfikatora usługi Device Provisioning oraz podanego certyfikatu i plików kluczy oraz hasła dla pliku klucza. Spowoduje to obejście pobierania zakresu identyfikatorów.

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

Zarejestruj urządzenie IoT przy użyciu rejestracji grupowej, zakresu identyfikatora usługi Device Provisioning oraz danych plików certyfikatu i klucza. Spowoduje to obejście pobierania zakresu identyfikatorów. Należy pamiętać, że identyfikator rejestracji grupy nie jest wymagany w przypadku zaświadczeń x509, a temat pliku certyfikatu jest identyfikatorem rejestracji.

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

Parametry wymagane

--registration-id --rid

Identyfikator rejestracji urządzenia lub identyfikator rejestracji indywidualnej.

Parametry opcjonalne

--auth-type

Wskazuje, czy operacja powinna automatycznie utworzyć klucz zasad, czy użyć bieżącej sesji usługi Azure AD. Jeśli typ uwierzytelniania to identyfikator logowania i zostanie podana nazwa hosta zasobu, wyszukiwanie zasobów zostanie pominięte, chyba że będzie to konieczne. Wartość domyślną można skonfigurować przy użyciu polecenia az configure --defaults iothub-data-auth-type=<auth-type-value>.

Dopuszczalne wartości: key, login
Domyślna wartość: key
--certificate-file-path --cp

Ścieżka do pliku PEM certyfikatu. Wymagane do rejestracji x509.

--ck --compute-key

Flaga wskazująca, że klucz symetryczny rejestracji urządzenia powinien zostać obliczony z danego klucza z kluczem --symmetric-key.

Domyślna wartość: False
--dps-name -n

Nazwa usługi Azure IoT Hub Device Provisioning. Wymagane, jeśli nie podano argumentów --login lub nie podano argumentów authenticaton i --id-scope.

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

Identyfikator grupy rejestracji. Wymagane tylko do pobrania argumentów uwierzytelniania.

--host --provisioning-host

Punkt końcowy wskazujący host aprowizacji do użycia.

Domyślna wartość: global.azure-devices-provisioning.net
--id-scope --scope

Zakres identyfikatora usługi Azure IoT Hub Device Provisioning. W przypadku podania argumentów uwierzytelniania uniknie logowania do sesji.

--key --symmetric-key

Symetryczny klucz dostępu współdzielonego na potrzeby rejestracji urządzenia.

--key-file-path --kp

Ścieżka do pliku PEM klucza. Wymagane do rejestracji x509.

--login -l

To polecenie obsługuje jednostkę parametry połączenia z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli zarówno jednostka parametry połączenia, jak i nazwa są podane, parametry połączenia ma priorytet. Wymagane, jeśli nie podano argumentów --dps-name ani argumentów authenticaton i --id-scope.

--pass --passphrase

Hasło certyfikatu.

--payload

Niestandardowy ładunek alokacji jako JSON. Specjalnie do użycia z niestandardowymi zasadami alokacji przy użyciu usługi Azure Functions.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.