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
Wersja Preview

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]

Łą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
--den --dps-endpoint-name

Logiczna nazwa wpisu punktu końcowego aprowizacji usługi DPS w przestrzeni nazw.

Właściwość Wartość
Grupa parametrów: DPS Arguments
--dps-id --dps-resource-id

Azure identyfikator zasobu usługi Device Provisioning Service, aby połączyć.

Właściwość Wartość
Grupa parametrów: DPS Arguments
--hen --hub-endpoint-name

Logiczna nazwa wpisu punktu końcowego obsługi komunikatów centrum w przestrzeni nazw.

Właściwość Wartość
Grupa parametrów: Hub Arguments
--hub-id --hub-resource-id

Azure identyfikator zasobu IoT Hub do połączenia.

Właściwość Wartość
Grupa parametrów: Hub Arguments
--namespace --ns

Nazwa przestrzeni nazw rejestru urządzeń, która będzie właścicielem obu nowych łączy.

--resource-group -g

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--dps-mi-sa --dps-system-assigned-mi

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
--dps-mi-ua --dps-user-assigned-mi

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
--hub-allocation-weight --hub-weight

Waga alokacji punktu końcowego obsługi komunikatów koncentratora.

Właściwość Wartość
Grupa parametrów: Hub Arguments
--hub-availability

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
--hub-mi-sa --hub-system-assigned-mi

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
--hub-mi-ua --hub-user-assigned-mi

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

Interwał sondowania w sekundach. Musi być większy niż zero.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: 30
--no-wait

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

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
--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 polecenia 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
Wersja Preview

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]

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
--namespace --ns

Nazwa przestrzeni nazw rejestru urządzeń, która jest właścicielem linku.

--resource-group -g

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

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--change-reference

Powiązany identyfikator odwołania do zmiany dla tej operacji zasobu.

Właściwość Wartość
Grupa parametrów: Global Policy Arguments
--created

Zaczekaj, aż stan provisioningState ma wartość Powodzenie.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--custom

Poczekaj, aż niestandardowe wyrażenie JMESPath zwróci wartość true.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
--deleted

Zaczekaj na usunięcie zasobu.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--den --dps-endpoint-name

Punkt końcowy usługi DPS do uwzględnienia w zakresie oczekiwania.

--exists

Zaczekaj, aż zasób istnieje.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
--hen --hub-endpoint-name

Punkt końcowy koncentratora do uwzględnienia w zakresie oczekiwania.

--interval

Interwał sondowania w sekundach.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: 30
--sen --su-endpoint-name

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.

--timeout

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

Zaczekaj, aż stan provisioningState ma wartość Powodzenie.

Właściwość Wartość
Grupa parametrów: Wait Condition Arguments
Domyślna wartość: False
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 polecenia 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