az iot dps enrollment
Note
Ta dokumentacja jest częścią rozszerzenia azure-iot dla interfejsu wiersza polecenia platformy Azure (wersja 2.67.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot dps enrollment. Dowiedz się więcej o rozszerzeniach.
Zarządzanie rejestracjami poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service.
Polecenia
| Nazwa | Opis | Typ | Stan |
|---|---|---|---|
| az iot dps enrollment create |
Utwórz rejestrację poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service. |
Extension | ogólna dostępność |
| az iot dps enrollment delete |
Usuń rejestrację poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service. |
Extension | ogólna dostępność |
| az iot dps enrollment list |
Wyświetlanie listy rejestracji poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service. |
Extension | ogólna dostępność |
| az iot dps enrollment registration |
Zarządzanie rejestracjami urządzeń po stronie usługi na potrzeby rejestracji indywidualnej w usłudze Azure IoT Hub Device Provisioning Service. |
Extension | ogólna dostępność |
| az iot dps enrollment registration delete |
Usuń rejestrację urządzenia dla rejestracji indywidualnej w usłudze Azure IoT Hub Device Provisioning Service. |
Extension | ogólna dostępność |
| az iot dps enrollment registration show |
Uzyskaj rejestrację urządzenia dla rejestracji indywidualnej w usłudze Azure IoT Hub Device Provisioning Service. |
Extension | ogólna dostępność |
| az iot dps enrollment show |
Pobierz szczegóły rejestracji poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning. |
Extension | ogólna dostępność |
| az iot dps enrollment update |
Zaktualizuj rejestrację poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service. |
Extension | ogólna dostępność |
az iot dps enrollment create
Utwórz rejestrację poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service.
Podaj format certyfikatu przy użyciu kodowania Base64 ASCII, a certyfikat powinien mieć pasujące segmenty BEGIN i END, na przykład: zacznij od "-----BEGIN CERTIFICATE-----" i zakończ ciągiem "-----END CERTIFICATE-----".
az iot dps enrollment create --at --attestation-type {symmetricKey, tpm, x509}
--eid --enrollment-id
[--allocation-policy --ap {custom, geoLatency, hashed, static}]
[--api-version --av]
[--auth-type {key, login}]
[--certificate-path --cp]
[--cpn --credential-policy-name]
[--device-id]
[--device-information --info]
[--dps-name]
[--edge-enabled --ee {false, true}]
[--ek --endorsement-key]
[--ih --iot-hubs]
[--initial-twin-properties --props]
[--initial-twin-tags --tags]
[--login]
[--pk --primary-key]
[--provisioning-status --ps {disabled, enabled}]
[--reprovision-policy --rp {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scp --secondary-certificate-path]
[--secondary-key --sk]
[--webhook-url --wh]
Przykłady
Utwórz rejestrację "{enrollment_id}" z typem zaświadczania "x509" w usłudze Azure IoT Device Provisioning Service "{dps_name}" w grupie zasobów {resource_group_name}" ze stanem aprowizacji "disabled", identyfikator urządzenia "{device_id}", właściwości początkowej reprezentacji bliźniaczej "{"location":{"region":"US"}}", początkowe tagi bliźniaczej reprezentacji "{"version":"1"}" i informacje o urządzeniu "{"color":"red"}".
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type x509 --certificate-path /certificates/Certificate.pem --provisioning-status disabled --initial-twin-properties "{'location':{'region':'US'}}" --initial-twin-tags "{'version':'1'}" --device-information "{'color':'red'}" --device-id {device_id}
Utwórz rejestrację "MyEnrollment" z typem zaświadczania "tpm" w usłudze Azure IoT Device Provisioning Service "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89
Utwórz rejestrację "MyEnrollment" z typem zaświadczania "symmetrickey" w usłudze Azure IoT Device Provisioning "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --primary-key {primary_key} --secondary-key {secondary_key}
Utwórz rejestrację "MyEnrollment" z ponownym aprowizowaniem w usłudze Azure IoT Device Provisioning "{dps_name}" w grupie zasobów "{resource_group_name}".
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --reprovision-policy {reprovision_type} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89
Utwórz rejestrację "MyEnrollment" ze statycznymi zasadami alokacji w usłudze Azure IoT Device Provisioning "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy static --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs {iot_hub_host_name}
Utwórz rejestrację "MyEnrollment" z zasadami alokacji skrótów i wieloma centrami w usłudze Azure IoT Device Provisioning "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type tpm --allocation-policy hashed --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --iot-hubs {iot_hub_host_name1} {iot_hub_host_name2}
Utwórz rejestrację "MyEnrollment" przy użyciu niestandardowych zasad alokacji,
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --allocation-policy custom --webhook-url {webhook_url} --api-version {api_version}
Utwórz rejestrację z określonymi niestandardowymi zasadami poświadczeń przestrzeni nazw ADR.
az iot dps enrollment create -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --attestation-type symmetrickey --credential-policy-name {policy_name}
Parametry wymagane
Mechanizm zaświadczania używany do uwierzytelniania w usłudze DPS.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
| Dopuszczalne wartości: | symmetricKey, tpm, x509 |
Identyfikator rejestracji poszczególnych urządzeń.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Typ zasad alokacji w celu określenia, jak urządzenie jest przypisane do usługi IoT Hub. Jeśli nie zostanie podana, zasady alokacji będą domyślnymi zasadami alokacji ustawionymi dla wystąpienia usługi Device Provisioning Service.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Allocation Policy Arguments |
| Dopuszczalne wartości: | custom, geoLatency, hashed, static |
Wersja interfejsu API typów usług aprowizacji wysyłanych w żądaniu alokacji niestandardowej. Minimalna obsługiwana wersja: 2018-09-01-preview.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Allocation Policy Arguments |
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 az configure --defaults iotdps-data-auth-type={auth-type-value}.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Access Control Arguments |
| Domyślna wartość: | key |
| Dopuszczalne wartości: | key, login |
Ścieżka do pliku zawierającego certyfikat podstawowy. Wymagane podczas wybierania x509 jako typu zaświadczania i nie podano pomocniczej ścieżki certyfikatu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Nazwa zasad poświadczeń przestrzeni nazw ADR.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | ADR Credential Policy Arguments |
Identyfikator urządzenia zarejestrowany w usłudze IoT Hub.
Opcjonalne informacje o urządzeniu.
Nazwa lub nazwa hosta usługi Azure IoT Hub Device Provisioning. Wymagane, jeśli nie podano opcji --login.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Flaga wskazująca włączenie krawędzi.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
| Dopuszczalne wartości: | false, true |
Klucz poręczenia modułu TPM dla urządzenia TPM. Podczas wybierania modułu tpm jako typu zaświadczania wymagany jest klucz poręczenia.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Nazwa hosta docelowego centrum IoT Hub skojarzonego z zasadami alokacji. Użyj listy rozdzielanej spacjami dla wielu centrów IoT Hub.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Allocation Policy Arguments |
Początkowe właściwości bliźniaczej reprezentacji urządzenia.
Początkowe tagi bliźniaczej reprezentacji urządzenia.
To polecenie obsługuje parametry połączenia jednostki z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli parametry połączenia jednostki i nazwa są podane parametry połączenia mają priorytet. Wymagane, jeśli nie podano --dps-name.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Podstawowy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Włącz lub wyłącz wpis rejestracji.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | disabled, enabled |
Zasady umożliwiające określenie sposobu obsługi danych urządzenia podczas ponownej aprowizacji w innej usłudze IoT Hub.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | never, reprovisionandmigratedata, reprovisionandresetdata |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Ścieżka do pliku zawierającego certyfikat pomocniczy. Wymagane podczas wybierania x509 jako typu zaświadczania i nie podano podstawowej ścieżki certyfikatu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Pomocniczy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Adres URL elementu webhook funkcji platformy Azure używany na potrzeby niestandardowych żądań alokacji.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Allocation Policy Arguments |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az iot dps enrollment delete
Usuń rejestrację poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service.
az iot dps enrollment delete --eid --enrollment-id
[--auth-type {key, login}]
[--dps-name]
[--etag]
[--login]
[--resource-group]
Parametry wymagane
Identyfikator rejestracji poszczególnych urządzeń.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
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 az configure --defaults iotdps-data-auth-type={auth-type-value}.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Access Control Arguments |
| Domyślna wartość: | key |
| Dopuszczalne wartości: | key, login |
Nazwa lub nazwa hosta usługi Azure IoT Hub Device Provisioning. Wymagane, jeśli nie podano opcji --login.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Etag lub tag jednostki odpowiadający ostatniemu stanowi zasobu. Jeśli nie podano elementu etag, zostanie użyta wartość "*".
To polecenie obsługuje parametry połączenia jednostki z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli parametry połączenia jednostki i nazwa są podane parametry połączenia mają priorytet. Wymagane, jeśli nie podano --dps-name.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az iot dps enrollment list
Wyświetlanie listy rejestracji poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service.
az iot dps enrollment list [--auth-type {key, login}]
[--dps-name]
[--login]
[--resource-group]
[--top]
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
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 az configure --defaults iotdps-data-auth-type={auth-type-value}.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Access Control Arguments |
| Domyślna wartość: | key |
| Dopuszczalne wartości: | key, login |
Nazwa lub nazwa hosta usługi Azure IoT Hub Device Provisioning. Wymagane, jeśli nie podano opcji --login.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
To polecenie obsługuje parametry połączenia jednostki z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli parametry połączenia jednostki i nazwa są podane parametry połączenia mają priorytet. Wymagane, jeśli nie podano --dps-name.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Maksymalna liczba elementów do zwrócenia. Użyj -1 dla nieograniczonego.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az iot dps enrollment show
Pobierz szczegóły rejestracji poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning.
az iot dps enrollment show --eid --enrollment-id
[--auth-type {key, login}]
[--dps-name]
[--keys --show-keys {false, true}]
[--login]
[--resource-group]
Przykłady
Podstawowy sposób użycia
az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {enrollment_id}
Uwzględnij pełne informacje o zaświadczeniu w wynikach rejestracji klucza symetrycznego
az iot dps enrollment show --dps-name {dps_name} -g {resource_group} --enrollment-id {symmetric_key_enrollment_id} --show-keys
Parametry wymagane
Identyfikator rejestracji poszczególnych urządzeń.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
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 az configure --defaults iotdps-data-auth-type={auth-type-value}.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Access Control Arguments |
| Domyślna wartość: | key |
| Dopuszczalne wartości: | key, login |
Nazwa lub nazwa hosta usługi Azure IoT Hub Device Provisioning. Wymagane, jeśli nie podano opcji --login.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Uwzględnij klucze zaświadczania i informacje w wynikach rejestracji.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | false, true |
To polecenie obsługuje parametry połączenia jednostki z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli parametry połączenia jednostki i nazwa są podane parametry połączenia mają priorytet. Wymagane, jeśli nie podano --dps-name.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
az iot dps enrollment update
Zaktualizuj rejestrację poszczególnych urządzeń w usłudze Azure IoT Hub Device Provisioning Service.
Podaj format certyfikatu przy użyciu kodowania Base64 ASCII, a certyfikat powinien mieć pasujące segmenty BEGIN i END, na przykład: zacznij od "-----BEGIN CERTIFICATE-----" i zakończ ciągiem "-----END CERTIFICATE-----".
az iot dps enrollment update --eid --enrollment-id
[--allocation-policy --ap {custom, geoLatency, hashed, static}]
[--api-version --av]
[--auth-type {key, login}]
[--certificate-path --cp]
[--cpn --credential-policy-name]
[--device-id]
[--device-information --info]
[--dps-name]
[--edge-enabled --ee {false, true}]
[--ek --endorsement-key]
[--etag]
[--ih --iot-hubs]
[--initial-twin-properties --props]
[--initial-twin-tags --tags]
[--login]
[--pk --primary-key]
[--provisioning-status --ps {disabled, enabled}]
[--rc --remove-certificate {false, true}]
[--remove-secondary-certificate --rsc {false, true}]
[--reprovision-policy --rp {never, reprovisionandmigratedata, reprovisionandresetdata}]
[--resource-group]
[--scp --secondary-certificate-path]
[--secondary-key --sk]
[--webhook-url --wh]
Przykłady
Zaktualizuj rejestrację "{enrollment_id}" przy użyciu nowego certyfikatu x509 w usłudze Azure IoT Device Provisioning Service "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --certificate-path /certificates/NewCertificate.pem --etag AAAAAAAAAAA=
Zaktualizuj rejestrację "{enrollment_id}" przy użyciu nowego klucza poręczenia w usłudze Azure IoT Device Provisioning Service "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --endorsement-key 14963E8F3BA5B3984110B3C1CA8E8B89 --etag AAAAAAAAAAA=
Zaktualizuj rejestrację "{enrollment_id}" przy użyciu nowego klucza podstawowego w usłudze Azure IoT Device Provisioning Service "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --primary-key {new_primary_key} --etag AAAAAAAAAAA=
Zaktualizuj rejestrację "{enrollment_id}" przy użyciu nowego typu ponownej aprowizacji w usłudze Azure IoT Device Provisioning Service "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --reprovision-policy {reprovision_type} --etag AAAAAAAAAAA=
Zaktualizuj rejestrację "{enrollment_id}" przy użyciu nowych zasad alokacji w usłudze Azure IoT Device Provisioning Service "{dps_name}" w grupie zasobów {resource_group_name}.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --allocation-policy geolatency --etag AAAAAAAAAAA= --iot-hubs {iot_hub_host_name1} {iot_hub_host_name2} {iot_hub_host_name3}
Zaktualizuj rejestrację "{enrollment_id}" w usłudze Azure IoT Device Provisioning Service "{dps_name}" w grupie zasobów "{resource_group_name}" z początkowymi właściwościami bliźniaczej reprezentacji {"location":{"region":"USA"}}", początkowymi tagami bliźniaczych reprezentacji "{"version":"2"}" i informacjami o urządzeniu "{"color":"red"}".
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --initial-twin-properties "{'location':{'region':'USA'}}" --initial-twin-tags "{'version1':'2'}" --device-information "{'color':'red'}"
Zaktualizuj rejestrację "{enrollment_id}" w usłudze Azure IoT Device Provisioning Service "{dps_name}", aby użyć niestandardowych zasad poświadczeń przestrzeni nazw ADR.
az iot dps enrollment update -g {resource_group_name} --dps-name {dps_name} --enrollment-id {enrollment_id} --credential-policy-name {my_policy}
Parametry wymagane
Identyfikator rejestracji poszczególnych urządzeń.
Parametry opcjonalne
Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.
Typ zasad alokacji w celu określenia, jak urządzenie jest przypisane do usługi IoT Hub. Jeśli nie zostanie podana, zasady alokacji będą domyślnymi zasadami alokacji ustawionymi dla wystąpienia usługi Device Provisioning Service.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Allocation Policy Arguments |
| Dopuszczalne wartości: | custom, geoLatency, hashed, static |
Wersja interfejsu API typów usług aprowizacji wysyłanych w żądaniu alokacji niestandardowej. Minimalna obsługiwana wersja: 2018-09-01-preview.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Allocation Policy Arguments |
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 az configure --defaults iotdps-data-auth-type={auth-type-value}.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Access Control Arguments |
| Domyślna wartość: | key |
| Dopuszczalne wartości: | key, login |
Ścieżka do pliku zawierającego certyfikat podstawowy.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Nazwa zasad poświadczeń przestrzeni nazw ADR.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | ADR Credential Policy Arguments |
Identyfikator urządzenia zarejestrowany w usłudze IoT Hub.
Opcjonalne informacje o urządzeniu.
Nazwa lub nazwa hosta usługi Azure IoT Hub Device Provisioning. Wymagane, jeśli nie podano opcji --login.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Flaga wskazująca włączenie krawędzi.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | false, true |
Klucz poręczenia modułu TPM dla urządzenia TPM.
Etag lub tag jednostki odpowiadający ostatniemu stanowi zasobu. Jeśli nie podano elementu etag, zostanie użyta wartość "*".
Nazwa hosta docelowego centrum IoT Hub skojarzonego z zasadami alokacji. Użyj listy rozdzielanej spacjami dla wielu centrów IoT Hub.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Allocation Policy Arguments |
Początkowe właściwości bliźniaczej reprezentacji urządzenia.
Początkowe tagi bliźniaczej reprezentacji urządzenia.
To polecenie obsługuje parametry połączenia jednostki z uprawnieniami do wykonania akcji. Użyj polecenia , aby uniknąć logowania do sesji za pomocą polecenia "az login". Jeśli parametry połączenia jednostki i nazwa są podane parametry połączenia mają priorytet. Wymagane, jeśli nie podano --dps-name.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Device Provisioning Service Identifier Arguments |
Podstawowy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Włącz lub wyłącz wpis rejestracji.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | disabled, enabled |
Flaga usuwania bieżącego certyfikatu podstawowego.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
| Dopuszczalne wartości: | false, true |
Flaga usuwania bieżącego certyfikatu pomocniczego.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
| Dopuszczalne wartości: | false, true |
Zasady umożliwiające określenie sposobu obsługi danych urządzenia podczas ponownej aprowizacji w innej usłudze IoT Hub.
| Właściwość | Wartość |
|---|---|
| Dopuszczalne wartości: | never, reprovisionandmigratedata, reprovisionandresetdata |
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.
Ścieżka do pliku zawierającego certyfikat pomocniczy.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Pomocniczy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Authentication Arguments |
Adres URL elementu webhook funkcji platformy Azure używany na potrzeby niestandardowych żądań alokacji.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Allocation Policy Arguments |
Parametry globalne
Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Pokaż ten komunikat pomocy i zakończ pracę.
Pokaż tylko błędy, pomijając ostrzeżenia.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Format danych wyjściowych.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | json |
| Dopuszczalne wartości: | json, jsonc, none, table, tsv, yaml, yamlc |
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 az account set -s NAME_OR_ID.
Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |