Udostępnij za pośrednictwem

az iot ops asset

  • Odwołanie

Uwaga

Ta dokumentacja jest częścią rozszerzenia azure-iot-ops dla interfejsu wiersza polecenia platformy Azure (wersja 2.53.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az iot ops asset . Dowiedz się więcej o rozszerzeniach.

Zarządzanie zasobami.

Aby uzyskać więcej informacji na temat zarządzania zasobami, zobacz aka.ms/asset-overview.

Polecenia

Nazwa Opis Typ Stan
az iot ops asset create

Utwórz zasób.

 Numer wewnętrzny GA
az iot ops asset dataset

Zarządzanie zestawami danych w zasobie.

 Numer wewnętrzny GA
az iot ops asset dataset list

Wyświetlanie listy zestawów danych w ramach elementu zawartości.

 Numer wewnętrzny GA
az iot ops asset dataset point

Zarządzanie punktami danych w zestawie danych zasobów.

 Numer wewnętrzny GA
az iot ops asset dataset point add

Dodaj punkt danych do zestawu danych elementu zawartości.

 Numer wewnętrzny GA
az iot ops asset dataset point export

Eksportowanie punktów danych w zestawie danych zasobów.

 Numer wewnętrzny GA
az iot ops asset dataset point import

Zaimportuj punkty danych w zestawie danych zasobów.

 Numer wewnętrzny GA
az iot ops asset dataset point list

Wyświetlanie listy punktów danych w zestawie danych elementów zawartości.

 Numer wewnętrzny GA
az iot ops asset dataset point remove

Usuwanie punktu danych w zestawie danych elementu zawartości.

 Numer wewnętrzny GA
az iot ops asset dataset show

Pokaż zestaw danych w ramach elementu zawartości.

 Numer wewnętrzny GA
az iot ops asset delete

Usuwanie elementu zawartości.

 Numer wewnętrzny GA
az iot ops asset endpoint

Zarządzanie profilami punktów końcowych zasobów.

 Numer wewnętrzny GA
az iot ops asset endpoint create

Tworzenie profilów punktów końcowych zasobów.

 Numer wewnętrzny GA
az iot ops asset endpoint create opcua

Utwórz profil punktu końcowego zasobu za pomocą łącznika OPCUA.

 Numer wewnętrzny GA
az iot ops asset endpoint delete

Usuń profil punktu końcowego zasobu.

 Numer wewnętrzny GA
az iot ops asset endpoint query

Wykonaj zapytanie względem wykresu zasobów dla profilów punktów końcowych zasobów.

 Numer wewnętrzny GA
az iot ops asset endpoint show

Pokaż profil punktu końcowego zasobu.

 Numer wewnętrzny GA
az iot ops asset endpoint update

Aktualizowanie profilu punktu końcowego zasobu.

 Numer wewnętrzny GA
az iot ops asset event

Zarządzanie zdarzeniami w zasobie.

 Numer wewnętrzny GA
az iot ops asset event add

Dodaj zdarzenie do elementu zawartości.

 Numer wewnętrzny GA
az iot ops asset event export

Eksportowanie zdarzeń w zasobie.

 Numer wewnętrzny GA
az iot ops asset event import

Importowanie zdarzeń w zasobie.

 Numer wewnętrzny GA
az iot ops asset event list

Wyświetlanie listy zdarzeń w zasobie.

 Numer wewnętrzny GA
az iot ops asset event remove

Usuń zdarzenie w elemecie zawartości.

 Numer wewnętrzny GA
az iot ops asset query

Wykonywanie zapytań względem grafu zasobów dla zasobów.

 Numer wewnętrzny GA
az iot ops asset show

Pokaż zasób.

 Numer wewnętrzny GA
az iot ops asset update

Aktualizowanie elementu zawartości.

 Numer wewnętrzny GA

az iot ops asset create

Utwórz zasób.

Aby zapoznać się z przykładami formatów plików, zobacz aka.ms/aziotops-assets.

az iot ops asset create --endpoint-profile
                        --instance
                        --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--ig]
                        [--instance-subscription]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Przykłady

Utwórz zasób przy użyciu danego wystąpienia w tej samej grupie zasobów.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance

Utwórz zasób przy użyciu danego wystąpienia w innej grupie zasobów, ale tej samej subskrypcji. Należy pamiętać, że środowisko operacji cyfrowych może nie wyświetlać zasobu, jeśli znajduje się on w innej subskrypcji niż wystąpienie.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --instance-resource-group myinstanceresourcegroup

Utwórz wyłączony zasób przy użyciu pliku zawierającego zdarzenia.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event-file /path/to/myasset_events.csv --disable

Utwórz zasób z podanymi wstępnie wypełnionymi wartościami.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event event_notifier=EventNotifier1 name=myEvent1 observability_mode=log sampling_interval=10 queue_size=2 --event event_notifier=EventNotifier2 name=myEvent2 --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50 --description 'Description for a test asset.' --documentation-uri www.contoso.com --external-asset-id 000-000-1234 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10 --custom-attribute work_location=factory

Parametry wymagane

--endpoint-profile --ep

Nazwa profilu punktu końcowego zasobu.

--instance

Nazwa wystąpienia, z którą ma być skojarzony utworzony zasób.

--name -n

Nazwa zasobu.

--resource-group -g

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

Parametry opcjonalne

--attr --custom-attribute

Pary klucz=wartość rozdzielane spacjami odpowiadające dodatkowym atrybutom niestandardowym zasobu. Tego parametru można używać więcej niż raz.

--dataset-publish-int --dpi

Domyślny interwał publikowania zestawów danych.

Domyślna wartość: 1000
--dataset-queue-size --dqs

Domyślny rozmiar kolejki dla zestawów danych.

Domyślna wartość: 1
--dataset-sample-int --dsi

Domyślny interwał próbkowania (w milisekundach) dla zestawów danych.

Domyślna wartość: 500
--description -d

Opis.

--disable

Wyłącz zasób.

Dopuszczalne wartości: false, true
Domyślna wartość: False
--display-name --dn

Nazwa wyświetlana

--documentation-uri --du

Identyfikator URI dokumentacji.

--eai --external-asset-id

Identyfikator zewnętrznego zasobu.

--ef --event-file

Ścieżka pliku zawierającego zdarzenia. Obsługiwane są następujące typy plików: json, csv, yaml.

--epi --event-publish-int

Domyślny interwał publikowania zdarzeń.

Domyślna wartość: 1000
--eqs --event-queue-size

Domyślny rozmiar kolejki dla zdarzeń.

Domyślna wartość: 1
--esi --event-sample-int

Domyślny interwał próbkowania (w milisekundach) dla zdarzeń.

Domyślna wartość: 500
--event

Oddzielone spacją pary klucz=wartość odpowiadające właściwościom zdarzenia do utworzenia. Obsługiwane są następujące wartości klucza: event_notifier (wymagane), name (wymagane), observability_mode (brak lub dziennik), sampling_interval (int), queue_size (int). --zdarzenie może być używane 1 lub więcej razy. Zapoznaj się z przykładami pomocy dotyczącymi pełnego użycia parametrów.

--hardware-revision --hr

Poprawka sprzętu.

--ig --instance-resource-group

Grupa zasobów wystąpienia. Jeśli nie zostanie podana, zostanie użyta grupa zasobów zasobów.

--instance-subscription --is
Przestarzałe

Argument "instance_subscription" został wycofany i zostanie usunięty w przyszłej wersji.

Identyfikator subskrypcji wystąpienia. Jeśli nie zostanie podany, zostanie użyty identyfikator subskrypcji zasobu.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--manufacturer

Producent.

--manufacturer-uri --mu

Identyfikator URI producenta.

--model

Model.

--pc --product-code

Kod produktu.

--serial-number --sn

Numer seryjny.

--software-revision --sr

Poprawka oprogramowania.

--tags

Tagi zasobów zasobów. Torba właściwości w parach klucz-wartość z następującym formatem: a=b c=d.

--topic-path --tp

Domyślna ścieżka tematu.

--topic-retain --tr

Domyślne zasady zachowania tematu.

Dopuszczalne wartości: Keep, Never
Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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.

az iot ops asset delete

Usuwanie elementu zawartości.

az iot ops asset delete --name
                        --resource-group

Przykłady

Usuwanie elementu zawartości.

az iot ops asset delete --name myasset -g myresourcegroup

Parametry wymagane

--name -n

Nazwa zasobu.

--resource-group -g

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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.

az iot ops asset query

Wykonywanie zapytań względem grafu zasobów dla zasobów.

az iot ops asset query [--cq]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint-profile]
                       [--hardware-revision]
                       [--ig]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--name]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]
                       [--topic-path]
                       [--topic-retain {Keep, Never}]

Przykłady

Wykonywanie zapytań dotyczących zasobów, które są wyłączone w ramach danej grupy zasobów.

az iot ops asset query -g myresourcegroup --disabled

Wykonaj zapytanie dotyczące zasobów, które mają dany model, producent i numer seryjny.

az iot ops asset query --model model1 --manufacturer contoso --serial-number 000-000-ABC10

Parametry opcjonalne

--cq --custom-query

Zapytanie niestandardowe do użycia. Wszystkie inne argumenty zapytania zostaną zignorowane.

--description -d

Opis.

--disabled

Stan zasobu.

Dopuszczalne wartości: false, true
--display-name --dn

Nazwa wyświetlana

--documentation-uri --du

Identyfikator URI dokumentacji.

--eai --external-asset-id

Identyfikator zewnętrznego zasobu.

--endpoint-profile --ep

Nazwa profilu punktu końcowego zasobu.

--hardware-revision --hr

Poprawka sprzętu.

--ig --instance-resource-group

Grupa zasobów wystąpienia. Jeśli nie zostanie podana, zostanie użyta grupa zasobów zasobów.

--instance

Nazwa wystąpienia, z którą ma być skojarzony utworzony zasób.

--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--manufacturer

Producent.

--manufacturer-uri --mu

Identyfikator URI producenta.

--model

Model.

--name -n

Nazwa zasobu.

--pc --product-code

Kod produktu.

--resource-group -g

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

--serial-number --sn

Numer seryjny.

--software-revision --sr

Poprawka oprogramowania.

--topic-path --tp

Domyślna ścieżka tematu.

--topic-retain --tr

Domyślne zasady zachowania tematu.

Dopuszczalne wartości: Keep, Never
Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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.

az iot ops asset show

Pokaż zasób.

az iot ops asset show --name
                      --resource-group

Przykłady

Pokaż szczegóły zasobu.

az iot ops asset show --name myasset -g myresourcegroup

Parametry wymagane

--name -n

Nazwa zasobu.

--resource-group -g

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

Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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.

az iot ops asset update

Aktualizowanie elementu zawartości.

Aby zaktualizować zestawy danych i zdarzenia, użyj odpowiednio grup poleceń az iot ops asset dataset i az iot ops asset event.

az iot ops asset update --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Przykłady

Aktualizowanie domyślnego zestawu danych i zdarzeń elementu zawartości.

az iot ops asset update --name myasset -g myresourcegroup --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50

Zaktualizuj opis zasobu, identyfikator URI dokumentacji, poprawkę sprzętu, kod produktu i poprawkę oprogramowania.

az iot ops asset update --name myasset -g myresourcegroup --description "Updated test asset description." --documentation-uri www.contoso.com --hardware-revision 11.0 --product-code XXX102 --software-revision 0.2

Zaktualizuj producenta zasobu, identyfikator URI producenta, model, numer seryjny i atrybut niestandardowy.

az iot ops asset update --name myasset -g myresourcegroup --manufacturer Contoso --manufacturer-uri constoso2.com --model NewAssetModel --serial-number 000-000-ABC11 --custom-attribute work_location=new_factory --custom-attribute secondary_work_location=factory

Wyłącz zasób i usuń atrybut niestandardowy o nazwie "work_site".

az iot ops asset update --name myasset -g myresourcegroup --disable --custom-attribute work_site=""

Parametry wymagane

--name -n

Nazwa zasobu.

--resource-group -g

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

Parametry opcjonalne

--attr --custom-attribute

Pary klucz=wartość rozdzielane spacjami odpowiadające dodatkowym atrybutom niestandardowym zasobu. Tego parametru można używać więcej niż raz. Aby usunąć atrybut niestandardowy, ustaw wartość atrybutu na "".

--dataset-publish-int --dpi

Domyślny interwał publikowania zestawów danych.

--dataset-queue-size --dqs

Domyślny rozmiar kolejki dla zestawów danych.

--dataset-sample-int --dsi

Domyślny interwał próbkowania (w milisekundach) dla zestawów danych.

--description -d

Opis.

--disable

Wyłącz zasób.

Dopuszczalne wartości: false, true
--display-name --dn

Nazwa wyświetlana

--documentation-uri --du

Identyfikator URI dokumentacji.

--epi --event-publish-int

Domyślny interwał publikowania zdarzeń.

--eqs --event-queue-size

Domyślny rozmiar kolejki dla zdarzeń.

--esi --event-sample-int

Domyślny interwał próbkowania (w milisekundach) dla zdarzeń.

--hardware-revision --hr

Poprawka sprzętu.

--manufacturer

Producent.

--manufacturer-uri --mu

Identyfikator URI producenta.

--model

Model.

--pc --product-code

Kod produktu.

--serial-number --sn

Numer seryjny.

--software-revision --sr

Poprawka oprogramowania.

--tags

Tagi zasobów zasobów. Torba właściwości w parach klucz-wartość z następującym formatem: a=b c=d.

--topic-path --tp

Domyślna ścieżka tematu.

--topic-retain --tr

Domyślne zasady zachowania tematu.

Dopuszczalne wartości: Keep, Never
Parametry globalne
--debug

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

--help -h

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

--only-show-errors

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

--output -o

Format danych wyjściowych.

Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
Domyślna wartość: json
--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.