az iot ops live-data

Note

To odwołanie jest częścią rozszerzenia azure-iot-ops dla Azure CLI (wersja 2.70.0 lub nowsza). Rozszerzenie automatycznie zainstaluje polecenie az iot ops live-data po raz pierwszy. Dowiedz się więcej o rozszerzeniach.

Ta grupa poleceń jest w wersji zapoznawczej i jest opracowywana. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Konfiguracja infrastruktury danych na żywo dla wystąpienia operacji IoT.

Wymaga środowiska uruchomieniowego w wersji zapoznawczej. Włącz wymaga gotowego środowiska uruchomieniowego; wyświetlanie i wyłączanie pozostałych dostępnych do diagnozowania i czyszczenia w złej kondycji środowisk uruchomieniowych w wersji zapoznawczej.

Polecenia

Nazwisko Opis Typ Stan
az iot ops live-data disable

Wyłącz dane na żywo dla wystąpienia operacji IoT.

Extension Preview
az iot ops live-data enable

Włącz dane na żywo dla wystąpienia operacji IoT.

Extension Preview
az iot ops live-data show

Pokaż konfigurację danych na żywo dla wystąpienia operacji IoT.

Extension Preview

az iot ops live-data disable

Wersja Preview

Grupa poleceń "iot ops live-data" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Wyłącz dane na żywo dla wystąpienia operacji IoT.

Usuwa dedykowany profil przepływu danych, punkt końcowy przepływu danych EG i obszar tematu możliwości obserwacji, a następnie usuwa wpis punktu końcowego z możliwości obserwowania tego wystąpienia z przestrzeni nazw rejestru urządzeń, dzięki czemu przerwane wyłączenie można bezpiecznie ponownie uruchomić. Zachowuje flagę włączoną dla całej przestrzeni nazw i wpisy punktu końcowego należące do innych wystąpień, nawet jeśli wpis tego wystąpienia jest ostatnim usuniętym. Identyfikatory zasobów lokalizacji niestandardowej są dopasowywane bez uwzględniania wielkości liter.

Czyszczenie jest kontynuowane dla zasobów należących do wystąpienia, jeśli brakuje odwołania ADR lub przestrzeni nazw. Jeśli nie można znaleźć przestrzeni nazw usługi Event Grid, ostrzeżenie identyfikuje przestrzeń tematu, która może wymagać ręcznego czyszczenia.

Przypisania ról tożsamości zarządzanej w zakresie usługi Event Grid są zachowywane; Przypisania tożsamości zarządzanej o zakresie przestrzeni tematu są usuwane wraz z obszarem tematu. Przypisania czytelnika utworzone dla identyfikatorów --user-object-id są zawsze ograniczone do przestrzeni nazw rejestru urządzeń, nie mają wpływu na zakres --ra i są zachowywane. Użyj identyfikatorów przydziałów zwracanych przez włączenie, jeśli wymagane jest jawne czyszczenie.

az iot ops live-data disable --instance
                             --resource-group
                             [--acquire-policy-token]
                             [--change-reference]
                             [--no-progress {false, true}]
                             [--yes {false, true}]

Przykłady

Wyłącz dane na żywo dla wystąpienia.

az iot ops live-data disable --instance myinstance -g myresourcegroup

Wyłącz dane na żywo bez monitu o potwierdzenie.

az iot ops live-data disable --instance myinstance -g myresourcegroup --yes

Parametry wymagane

--instance -i -n

Nazwa wystąpienia operacji IoT.

--resource-group -g

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.

--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
--no-progress

Wyłącz wizualną reprezentację pracy.

Właściwość Wartość
Dopuszczalne wartości: false, true
--yes -y

Potwierdź [y]es bez monitu. Przydatne w scenariuszach ciągłej integracji i automatyzacji.

Właściwość Wartość
Dopuszczalne wartości: false, true
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

az iot ops live-data enable

Wersja Preview

Grupa poleceń "iot ops live-data" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Włącz dane na żywo dla wystąpienia operacji IoT.

Aprowizuje i konfiguruje udostępnioną infrastrukturę na poziomie wystąpienia wymaganą dla danych na żywo w trzech domenach:

  • Przestrzeń nazw usługi Event Grid: obszar tematu z obserwacją.
  • Wystąpienie operacji IoT: dedykowany profil przepływu danych i punkt końcowy przepływu danych EG MQTT.
  • Przestrzeń nazw rejestru urządzeń: tożsamość ruchu wychodzącego i wpis punktu końcowego obserwacji dla poszczególnych wystąpień (kluczem lokalizacji niestandardowej wystąpienia).

Polecenie jest idempotentne. Ponowne uruchomienie zbieżności z żądanym stanem bez zastępowania niepowiązanych wpisów. Ustawia możliwość obserwowania przestrzeni nazw włączoną na wartość true i dodaje wpis punktu końcowego do obserwacji wystąpienia. Włączenie poszczególnych wystąpień jest określane przez ten wpis i obsługę konfiguracji zasobów, a nie flagę całej przestrzeni nazw. Wymagania wstępne ADR są weryfikowane przed utworzeniem zasobów. Istniejące szablony tematów danych na żywo i ustawienia profilu przepływu danych są uzgadniane po ponownym włączeniu. Tożsamość ruchu wychodzącego ADR jest przestrzeń nazw dla całej przestrzeni nazw. Jeśli inne punkty końcowe lub punkty końcowe zarządzania współużytkuje przestrzeń nazw, użyj jej istniejącej tożsamości; zmiana jest odrzucana, aby uniknąć zakłócania działania tych punktów końcowych.

Domyślnie przypisania ról (Event Grid TopicSpaces Publisher dla tożsamości wystąpienia i subskrybenta tożsamości przestrzeni nazw ADR) są tworzone w zakresie przestrzeni nazw usługi Event Grid. Użyj --ra-scope topic-space dla przypisań o najmniejszych uprawnieniach w zakresie do obszaru tematu lub --skip-ra, aby pominąć tworzenie przypisań ról.

Użyj --user-object-ids, aby przyznać czytelnikowi bezpośredni dostęp do co najmniej jednego użytkownika Microsoft Entra z dzierżawy zasobów w zakresie przestrzeni nazw rejestru urządzeń. Te przypisania są addytywne, idempotentne, bez wpływu na --ra-scope i zachowywane po wyłączeniu. Polecenie zwraca identyfikatory przydziałów do jawnego czyszczenia. --skip-ra ma pierwszeństwo i pomija te przypisania. Poszczególne przypisania użytkowników są wymagane w publicznej wersji zapoznawczej, gdy autoryzacja oparta na grupach jest niedostępna.

az iot ops live-data enable --eg-resource-id
                            --instance
                            --resource-group
                            [--acquire-policy-token]
                            [--adr-role-ids]
                            [--change-reference]
                            [--mi-user-assigned]
                            [--no-progress {false, true}]
                            [--ops-role-ids]
                            [--ra-scope {namespace, topic-space}]
                            [--skip-ra {false, true}]
                            [--user-object-ids]

Przykłady

Włącz dane na żywo przy użyciu tożsamości zarządzanej przypisanej przez system i ról domyślnych.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID

Włącz dane na żywo przy użyciu tożsamości zarządzanej przypisanej przez użytkownika na potrzeby uwierzytelniania wychodzącego.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --mi-user-assigned $UA_MI_RESOURCE_ID

Włącz dane na żywo z przypisaniami ról o najmniejszym uprawnieniach, zakresem tematu.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --ra-scope topic-space

Włącz dane na żywo i przyznaj czytelnikowi bezpośredni dostęp do Microsoft Entra użytkowników.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --user-object-ids $USER_OBJECT_ID_1 $USER_OBJECT_ID_2

Włącz dynamiczne dane i pomiń przypisania ról.

az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --skip-ra

Parametry wymagane

--eg-resource-id

Identyfikator zasobu arm przestrzeni nazw usługi Event Grid.

--instance -i -n

Nazwa wystąpienia operacji IoT.

--resource-group -g

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.

--acquire-policy-token

Automatyczne uzyskiwanie tokenu Azure Policy dla tej operacji zasobu.

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

Identyfikatory ról niestandardowych dla tożsamości przestrzeni nazw ADR (subskrybent) względem przestrzeni nazw EG. Ustawienie domyślne: "Event Grid TopicSpaces Subscriber".

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

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

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

Identyfikator zasobu tożsamości zarządzanej przypisanej przez użytkownika dla punktu końcowego przepływu danych EG i tożsamości wychodzącej przestrzeni nazw ADR. Ustawienie domyślne: tożsamość zarządzana przypisana przez system.

--no-progress

Wyłącz wizualną reprezentację pracy.

Właściwość Wartość
Dopuszczalne wartości: false, true
--ops-role-ids

Identyfikatory ról niestandardowych dla tożsamości wystąpienia AIO (Publisher) względem przestrzeni nazw EG. Ustawienie domyślne: "Event Grid TopicSpaces Publisher".

Właściwość Wartość
Grupa parametrów: Role Assignment Arguments
--ra-scope

Zakres przypisań ról usługi Event Grid. "Przestrzeń nazw" (domyślna) przypisuje w przestrzeni nazw EG i jest zachowywana po wyłączeniu; Element "topic-space" przypisuje zasób obszaru tematu (co najmniej uprawnienia) i jest usuwany z miejsca tematu po wyłączeniu.

Właściwość Wartość
Grupa parametrów: Role Assignment Arguments
Dopuszczalne wartości: namespace, topic-space
--skip-ra

W przypadku użycia kroku przypisania roli operacji zostanie pominięty.

Właściwość Wartość
Grupa parametrów: Role Assignment Arguments
Dopuszczalne wartości: false, true
--user-object-ids

Microsoft Entra identyfikatory obiektów użytkownika z dzierżawy zasobów, aby przyznać czytelnikowi w przestrzeni nazw rejestru urządzeń. Przypisania są addytywne i zachowywane po wyłączeniu. Ignorowane, gdy jest używany parametr --skip-ra.

Właściwość Wartość
Grupa parametrów: Role Assignment 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 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

az iot ops live-data show

Wersja Preview

Grupa poleceń "iot ops live-data" jest w wersji zapoznawczej i jest w fazie projektowania. Poziomy odwołań i pomocy technicznej: https://aka.ms/CLI_refstatus

Pokaż konfigurację danych na żywo dla wystąpienia operacji IoT.

Raportuje konfigurację danych na żywo i stan zasobu w przestrzeni nazw rejestru urządzeń, usłudze Event Grid i zasobach przepływu danych operacji IoT. Flaga z obsługą najwyższego poziomu ma wartość true tylko wtedy, gdy ten wpis punktu końcowego z obserwacją wystąpienia jest obecny, a wszystkie zasoby pomocnicze są obecne. Flaga włączona do obserwacji całej przestrzeni nazw jest zgłaszana dla informacji i nie określa włączania poszczególnych wystąpień. Szablony tematów, ustawienia dedykowanego profilu i typ punktu końcowego, host, uwierzytelnianie, prefiks identyfikatora klienta i tryb TLS muszą być również zgodne z konfiguracją danych na żywo. Stan punktu końcowego zawiera skonfigurowaną flagę. W przypadku uwierzytelniania przypisanego przez użytkownika weryfikacja odczytuje również identyfikatory klienta i dzierżawy, do których odwołuje się tożsamość zarządzana. Stan przestrzeni nazw rejestru urządzeń obejmuje atrybuty userReaderAssignments z identyfikatorami podmiotów zabezpieczeń i przypisań dla przypisań czytelnika użytkowników bezpośrednich w zakresie przestrzeni nazw, w tym przypisań utworzonych poza włączoną funkcją Live Data. Przydziały dziedziczone i grupowe są wykluczone. Przeczytanie tej listy wymaga Microsoft. Autoryzacja/rolaPrzypisania/odczyt; Błędy autoryzacji lub usługi są wyświetlane, a nie zgłaszane jako pusta lista.

az iot ops live-data show --instance
                          --resource-group
                          [--no-progress {false, true}]

Przykłady

Pokaż konfigurację danych na żywo dla wystąpienia.

az iot ops live-data show --instance myinstance -g myresourcegroup

Parametry wymagane

--instance -i -n

Nazwa wystąpienia operacji IoT.

--resource-group -g

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.

--no-progress

Wyłącz wizualną reprezentację pracy.

Właściwość Wartość
Dopuszczalne wartości: false, true
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