az iot adr ns link
Note
To odwołanie jest częścią rozszerzenia azure-iot dla Azure CLI (wersja 2.73.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot adr ns link . Dowiedz się więcej o rozszerzeniach.
Grupa poleceń "iot adr ns" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Zarządzaj łączami między przestrzenią nazw rejestru urządzeń a zasobami podrzędnym.
Najpierw połącz usługę DPS, a następnie połącz swoje usługi IoT Hubs. Użyj aktualizacji, aby zmienić tożsamość przychodzącą łącza lub ponowić próbę punktu końcowego Niepowodzenie z zapisaną tożsamością i ustawieniami. Użyj polecenia show, list i wait, aby sprawdzić linkState. Łącza należą do przestrzeni nazw. Aby odłączyć, najpierw usuń połączony zasób, a następnie uruchom polecenie link hub/dps/su remove, aby usunąć punkt końcowy z przestrzeni nazw. Usunięcie nie powoduje usunięcia ani sprawdzenia połączonego zasobu i nie czeka na zakończenie odłączeń. Dodaj/aktualizuj poczekaj, aż link zakończy się powodzeniem (--limit czasu domyślny 600 sekund, --interval 30). Po --no-wait użyj link hub/dps/su wait, aby śledzić ukończenie.
Polecenia
| Nazwisko | Opis | Typ | Stan |
|---|---|---|---|
| az iot adr ns link add |
Najpierw połącz usługę DPS, a następnie centrum z przestrzenią nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link dps |
Zarządzaj linkami usługi DPS (punktami końcowymi aprowizacji) w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link dps add |
Połącz usługę Device Provisioning Service (DPS) z przestrzenią nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link dps list |
Wyświetlanie listy punktów końcowych aprowizacji usługi DPS w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link dps remove |
Usuń punkt końcowy usługi DPS z przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link dps show |
Pokaż pojedynczy punkt końcowy aprowizacji usługi DPS w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link dps update |
Zaktualizuj istniejący punkt końcowy aprowizacji usługi DPS w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link dps wait |
Poczekaj na pomyślne połączenie punktu końcowego usługi DPS. |
Extension | Preview |
| az iot adr ns link hub |
Zarządzaj linkami IoT Hub (punktami końcowymi obsługi komunikatów) w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link hub add |
Łączenie IoT Hub z przestrzenią nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link hub list |
Wyświetl listę IoT Hub punktów końcowych obsługi komunikatów w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link hub remove |
Usuń punkt końcowy IoT Hub z przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link hub show |
Pokaż pojedynczy punkt końcowy obsługi komunikatów IoT Hub w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link hub update |
Zaktualizuj istniejący punkt końcowy obsługi komunikatów IoT Hub w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link hub wait |
Poczekaj na pomyślne połączenie punktu końcowego IoT Hub. |
Extension | Preview |
| az iot adr ns link su |
Zarządzanie linkami aktualizacji oprogramowania (aktualizowanie punktów końcowych) w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link su add |
Połącz wystąpienie aktualizacji z przestrzenią nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link su list |
Wyświetlanie listy aktualizacji oprogramowania aktualizacji punktów końcowych w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link su remove |
Usuń punkt końcowy wystąpienia aktualizacji oprogramowania z przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link su show |
Pokaż pojedynczy punkt końcowy aktualizacji oprogramowania w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link su update |
Aktualizowanie istniejącego punktu końcowego aktualizacji oprogramowania w przestrzeni nazw rejestru urządzeń. |
Extension | Preview |
| az iot adr ns link su wait |
Poczekaj na pomyślne połączenie punktu końcowego aktualizacji oprogramowania. |
Extension | Preview |
| az iot adr ns link wait |
Poczekaj na pomyślne zakończenie działania wybranych lub wszystkich łączy przestrzeni nazw. |
Extension | Preview |
az iot adr ns link add
Grupa poleceń "iot adr ns link" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Najpierw połącz usługę DPS, a następnie centrum z przestrzenią nazw rejestru urządzeń.
Sprawdza poprawność obu obiektów docelowych, nazw punktów końcowych, wyborów tożsamości i wymaganej kontroli dostępu opartej na rolach przed zmianą punktów końcowych przestrzeni nazw. Przesyła aktualizację przestrzeni nazw tylko dla usługi DPS i oczekuje, aż dokładny punkt końcowy usługi DPS osiągnie połączenieState Powodzenie przed przesłaniem oddzielnej aktualizacji centrum. --no-wait nadal czeka na tę zależność DPS; Pomija oczekiwanie tylko na ostateczną operację centrum. Oba etapy oczekiwania odzyskały tylko potwierdzoną wartość AdrMiNotAuthorized w niezmienionym punkcie końcowym po zweryfikowaniu wymaganych przypisań ról usługi. Odzyskiwanie używa aktualizacji punktu końcowego, nigdy innego dodatku. --timeout (600 sekund) to jeden wspólny budżet mutacji/odzyskiwania dla obu etapów po początkowym przedlotu RBAC, w tym RPC, sondowanie i ograniczone 30/60/120-sekundowe wycofywanie. Wartość domyślna --interval to 30 sekund. Oba muszą być pozytywne. Nie jest dodawane opóźnienie, gdy autoryzacja już działa. W przypadku opcji --no-wait użyj funkcji oczekiwania na koncentrator linków, aby śledzić etap centrum. Odrzucono, jeśli przestrzeń nazw ma już połączoną usługę DPS. Błąd lub przekroczenie limitu czasu usługi DPS uniemożliwia przesyłanie centrum. Częściowe uzupełnianie nie jest wycofane. Sprawdź nieudane punkty końcowe z linkiem dps show lub link hub show and repair persisted failures with the odpowiedni link update, zachowując istniejącą tożsamość. Po pomyślnym zakończeniu działania usługi DPS użyj dodatku koncentratora linków tylko wtedy, gdy punkt końcowy centrum jest nieobecny; Użyj centrum linków czekaj, jeśli oczekuje. Nie uruchamiaj ponownie połączonego łącza dodaj, gdy punkt końcowy usługi DPS już istnieje. Wymagane role usługi do usługi: przestrzeń nazw wychodząca mi —> współautor w usłudze DPS; Usługa DPS wybrała przychodzące wystąpienie zarządzane —> współautor w przestrzeni nazw; przypisana przez system przestrzeni nazw mi —> Azure administrator rejestru urządzeń w przestrzeni nazw; wychodzący punkt MI przestrzeni nazw —> współautor w centrum; przestrzeń nazw wychodząca mi —> IoT Hub Współautor danych w centrum; gdy wybrano tożsamość przychodzącą, wybrano przychodzące wystąpienie ZARZĄDZANE —> współautor w przestrzeni nazw.
az iot adr ns link add --den --dps-endpoint-name
--dps-id --dps-resource-id
--hen --hub-endpoint-name
--hub-id --hub-resource-id
--namespace --ns
--resource-group
[--acquire-policy-token]
[--change-reference]
[--dps-mi-sa --dps-system-assigned-mi {false, true}]
[--dps-mi-ua --dps-user-assigned-mi]
[--hub-allocation-weight --hub-weight]
[--hub-availability {Available, Disabled}]
[--hub-mi-sa --hub-system-assigned-mi {false, true}]
[--hub-mi-ua --hub-user-assigned-mi]
[--interval]
[--no-wait]
[--timeout]
Przykłady
Łączenie zarówno centrum, jak i usługi DPS przy użyciu tożsamości przypisanej przez system dla obu wywołań przychodzących
az iot adr ns link add --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --hub-id /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.Devices/IotHubs/<hub> --hub-system-assigned-mi \
--dps-endpoint-name primary-dps --dps-id /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.Devices/provisioningServices/<dps> --dps-system-assigned-mi
Łączenie obu zasobów bez konfigurowania tożsamości modułu wywołującego przychodzące centrum
az iot adr ns link add --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --hub-id <hub-id> \
--dps-endpoint-name primary-dps --dps-id <dps-id> --dps-system-assigned-mi
Łączenie obu z niestandardową dostępnością i wagą koncentratora
az iot adr ns link add --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --hub-id <hub-id> --hub-system-assigned-mi \
--hub-availability Available --hub-allocation-weight 1 \
--dps-endpoint-name primary-dps --dps-id <dps-id> --dps-system-assigned-mi
Zaczekaj na usługę DPS, prześlij centrum bez oczekiwania, a następnie obserwuj link Centrum
az iot adr ns link add --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --hub-id <hub-id> \
--dps-endpoint-name primary-dps --dps-id <dps-id> --dps-system-assigned-mi --no-wait
az iot adr ns link hub wait -n primary-hub --ns myNamespace -g myResourceGroup
Parametry wymagane
Logiczna nazwa wpisu punktu końcowego aprowizacji usługi DPS w przestrzeni nazw.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | DPS Arguments |
Azure identyfikator zasobu usługi Device Provisioning Service, aby połączyć.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | DPS Arguments |
Logiczna nazwa wpisu punktu końcowego obsługi komunikatów centrum w przestrzeni nazw.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Hub Arguments |
Azure identyfikator zasobu IoT Hub do połączenia.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Hub Arguments |
Nazwa przestrzeni nazw rejestru urządzeń, która będzie właścicielem obu nowych łączy.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.
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.
Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Użyj tożsamości przypisanej przez system połączonego zasobu usługi DPS jako tożsamości wywołującej dla ruchu przychodzącego.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | DPS Arguments |
| Domyślna wartość: | False |
| Dopuszczalne wartości: | false, true |
Identyfikator zasobu tożsamości przypisanej przez użytkownika dołączony do połączonego zasobu usługi DPS.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | DPS Arguments |
Waga alokacji punktu końcowego obsługi komunikatów koncentratora.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Hub Arguments |
Dostępność punktu końcowego obsługi komunikatów w centrum.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Hub Arguments |
| Dopuszczalne wartości: | Available, Disabled |
Użyj tożsamości przypisanej przez system połączonej IoT Hub jako tożsamości obiektu wywołującego dla ruchu przychodzącego.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Hub Arguments |
| Domyślna wartość: | False |
| Dopuszczalne wartości: | false, true |
Identyfikator zasobu tożsamości przypisanej przez użytkownika dołączony do połączonej IoT Hub.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Hub Arguments |
Interwał sondowania w sekundach. Musi być większy niż zero.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | 30 |
Poczekaj na pomyślne połączenie z usługą DPS, a następnie wróć bez oczekiwania na ostateczną operację centrum.
| Właściwość | Wartość |
|---|---|
| Domyślna wartość: | False |
Dodatnie współużytkowane mutacje/budżet odzyskiwania w sekundach dla usług DPS i Hub po początkowym wstępnym RBAC. Wartość domyślna: 600.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | 600 |
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 polecenia 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 adr ns link wait
Grupa poleceń "iot adr ns link" jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus
Poczekaj na pomyślne zakończenie działania wybranych lub wszystkich łączy przestrzeni nazw.
Bez jawnego predykatu oczekiwania czeka, aż każdy wybrany punkt końcowy ma połączenieState Powodzenie i natychmiast zakończy się niepowodzeniem, jeśli wystąpi niepowodzenie. Określanie zakresu oczekiwania przy użyciu parametru --hub-endpoint-name, --dps-endpoint-name i/lub --su-endpoint-name. Jeśli żadna z nich nie zostanie podana, zostaną dołączone wszystkie aktualnie skonfigurowane łącza koncentratora, usługi DPS i aktualizacji oprogramowania. Jawne Azure CLI predykaty oczekiwania sprawdzają zasób przestrzeni nazw i zachowują swoje standardowe zachowanie.
az iot adr ns link wait --namespace --ns
--resource-group
[--acquire-policy-token]
[--change-reference]
[--created]
[--custom]
[--deleted]
[--den --dps-endpoint-name]
[--exists]
[--hen --hub-endpoint-name]
[--interval]
[--sen --su-endpoint-name]
[--timeout]
[--updated]
Przykłady
Zaczekaj na pomyślne zakończenie wszystkich skonfigurowanych łączy przestrzeni nazw
az iot adr ns link wait --ns myNamespace -g myResourceGroup
Zaczekaj na dodanie linku Hub i DPS utworzonego przez połączony link DPS-first
az iot adr ns link wait --ns myNamespace -g myResourceGroup \
--hub-endpoint-name primary-hub --dps-endpoint-name primary-dps
Parametry wymagane
Nazwa przestrzeni nazw rejestru urządzeń, która jest właścicielem linku.
Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.
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.
Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Global Policy Arguments |
Zaczekaj, aż stan provisioningState ma wartość Powodzenie.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | False |
Poczekaj, aż niestandardowe wyrażenie JMESPath zwróci wartość true.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
Zaczekaj na usunięcie zasobu.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | False |
Punkt końcowy usługi DPS do uwzględnienia w zakresie oczekiwania.
Zaczekaj, aż zasób istnieje.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | False |
Punkt końcowy koncentratora do uwzględnienia w zakresie oczekiwania.
Interwał sondowania w sekundach.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | 30 |
Punkt końcowy aktualizacji oprogramowania do uwzględnienia w zakresie oczekiwania. Jeśli nie zostanie podana żadna nazwa punktu końcowego o określonym zakresie, zostaną dołączone wszystkie skonfigurowane łącza przestrzeni nazw.
Budżet sondowania w sekundach, w tym czas GET. Lot GET jest ograniczony przez przekroczenia limitu czasu transportu i nie może zostać przerwany przez ten termin głosowania.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | 3600 |
Zaczekaj, aż stan provisioningState ma wartość Powodzenie.
| Właściwość | Wartość |
|---|---|
| Grupa parametrów: | Wait Condition Arguments |
| Domyślna wartość: | False |
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 polecenia 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 |