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
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
Identyfikator rejestracji urządzenia lub identyfikator rejestracji indywidualnej.
Parametry opcjonalne
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>
.
Ścieżka do pliku PEM certyfikatu. Wymagane do rejestracji x509.
Flaga wskazująca, że klucz symetryczny rejestracji urządzenia powinien zostać obliczony z danego klucza z kluczem --symmetric-key.
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.
Identyfikator grupy rejestracji. Wymagane tylko do pobrania argumentów uwierzytelniania.
Punkt końcowy wskazujący host aprowizacji do użycia.
Zakres identyfikatora usługi Azure IoT Hub Device Provisioning. W przypadku podania argumentów uwierzytelniania uniknie logowania do sesji.
Symetryczny klucz dostępu współdzielonego na potrzeby rejestracji urządzenia.
Ścieżka do pliku PEM klucza. Wymagane do rejestracji x509.
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.
Hasło certyfikatu.
Niestandardowy ładunek alokacji jako JSON. Specjalnie do użycia z niestandardowymi zasadami alokacji przy użyciu usługi Azure Functions.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>
.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
Format danych wyjściowych.
Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.
Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia az account set -s NAME_OR_ID
.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.