Udostępnij przez


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

--at --attestation-type

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
--eid --enrollment-id

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.

--allocation-policy --ap

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
--api-version --av

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
--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 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
--certificate-path --cp

Ś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
--cpn --credential-policy-name

Nazwa zasad poświadczeń przestrzeni nazw ADR.

Właściwość Wartość
Grupa parametrów: ADR Credential Policy Arguments
--device-id -d

Identyfikator urządzenia zarejestrowany w usłudze IoT Hub.

--device-information --info

Opcjonalne informacje o urządzeniu.

--dps-name -n

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
--edge-enabled --ee

Flaga wskazująca włączenie krawędzi.

Właściwość Wartość
Domyślna wartość: False
Dopuszczalne wartości: false, true
--ek --endorsement-key

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
--ih --iot-hubs

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
--initial-twin-properties --props

Początkowe właściwości bliźniaczej reprezentacji urządzenia.

--initial-twin-tags --tags

Początkowe tagi bliźniaczej reprezentacji urządzenia.

--login -l

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
--pk --primary-key

Podstawowy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.

Właściwość Wartość
Grupa parametrów: Authentication Arguments
--provisioning-status --ps

Włącz lub wyłącz wpis rejestracji.

Właściwość Wartość
Dopuszczalne wartości: disabled, enabled
--reprovision-policy --rp

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
--resource-group -g

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

--scp --secondary-certificate-path

Ś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
--secondary-key --sk

Pomocniczy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.

Właściwość Wartość
Grupa parametrów: Authentication Arguments
--webhook-url --wh

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

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

--eid --enrollment-id

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.

--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 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
--dps-name -n

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

Etag lub tag jednostki odpowiadający ostatniemu stanowi zasobu. Jeśli nie podano elementu etag, zostanie użyta wartość "*".

--login -l

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
--resource-group -g

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

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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.

--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 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
--dps-name -n

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
--login -l

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
--resource-group -g

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

--top

Maksymalna liczba elementów do zwrócenia. Użyj -1 dla nieograniczonego.

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

--eid --enrollment-id

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.

--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 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
--dps-name -n

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
--keys --show-keys

Uwzględnij klucze zaświadczania i informacje w wynikach rejestracji.

Właściwość Wartość
Dopuszczalne wartości: false, true
--login -l

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
--resource-group -g

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

Parametry globalne
--debug

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

--eid --enrollment-id

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.

--allocation-policy --ap

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
--api-version --av

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
--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 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
--certificate-path --cp

Ścieżka do pliku zawierającego certyfikat podstawowy.

Właściwość Wartość
Grupa parametrów: Authentication Arguments
--cpn --credential-policy-name

Nazwa zasad poświadczeń przestrzeni nazw ADR.

Właściwość Wartość
Grupa parametrów: ADR Credential Policy Arguments
--device-id -d

Identyfikator urządzenia zarejestrowany w usłudze IoT Hub.

--device-information --info

Opcjonalne informacje o urządzeniu.

--dps-name -n

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
--edge-enabled --ee

Flaga wskazująca włączenie krawędzi.

Właściwość Wartość
Dopuszczalne wartości: false, true
--ek --endorsement-key

Klucz poręczenia modułu TPM dla urządzenia TPM.

--etag -e

Etag lub tag jednostki odpowiadający ostatniemu stanowi zasobu. Jeśli nie podano elementu etag, zostanie użyta wartość "*".

--ih --iot-hubs

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
--initial-twin-properties --props

Początkowe właściwości bliźniaczej reprezentacji urządzenia.

--initial-twin-tags --tags

Początkowe tagi bliźniaczej reprezentacji urządzenia.

--login -l

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
--pk --primary-key

Podstawowy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.

Właściwość Wartość
Grupa parametrów: Authentication Arguments
--provisioning-status --ps

Włącz lub wyłącz wpis rejestracji.

Właściwość Wartość
Dopuszczalne wartości: disabled, enabled
--rc --remove-certificate

Flaga usuwania bieżącego certyfikatu podstawowego.

Właściwość Wartość
Grupa parametrów: Authentication Arguments
Dopuszczalne wartości: false, true
--remove-secondary-certificate --rsc

Flaga usuwania bieżącego certyfikatu pomocniczego.

Właściwość Wartość
Grupa parametrów: Authentication Arguments
Dopuszczalne wartości: false, true
--reprovision-policy --rp

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
--resource-group -g

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

--scp --secondary-certificate-path

Ścieżka do pliku zawierającego certyfikat pomocniczy.

Właściwość Wartość
Grupa parametrów: Authentication Arguments
--secondary-key --sk

Pomocniczy symetryczny klucz dostępu współdzielonego przechowywany w formacie base64.

Właściwość Wartość
Grupa parametrów: Authentication Arguments
--webhook-url --wh

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

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

Właściwość Wartość
Domyślna wartość: False
--help -h

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

--only-show-errors

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

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--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 az account set -s NAME_OR_ID.

--verbose

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

Właściwość Wartość
Domyślna wartość: False