az iot du instance

Note

Ez a hivatkozás az Azure CLI azure-iot bővítményének része (2.67.0-s vagy újabb verzió). A bővítmény automatikusan telepíti az az iot du instance parancs első futtatásakor. További információ a bővítményekről.

Eszközfrissítési példányok kezelése.

Parancsok

Name	Description	Típus	Állapot
az iot du instance create	Eszközfrissítési példány létrehozása.	Extension	GA
az iot du instance delete	Eszközfrissítési példány törlése.	Extension	GA
az iot du instance list	Eszközfrissítési példányok listázása.	Extension	GA
az iot du instance show	Eszközfrissítési példány megjelenítése.	Extension	GA
az iot du instance update	Eszközfrissítési példány frissítése.	Extension	GA
az iot du instance wait	Tiltsa le, amíg a kívánt példány erőforrásállapota be nem teljesül.	Extension	GA

az iot du instance create

Eszközfrissítési példány létrehozása.

Ez a parancs egy meglévő példány állapotának frissítésére is használható.

az iot du instance create --account
                          --instance
                          --iothub-ids
                          [--acquire-policy-token]
                          [--change-reference]
                          [--diagnostics-storage-id]
                          [--enable-diagnostics {false, true}]
                          [--no-wait]
                          [--resource-group]
                          [--tags]

Példák

Hozzon létre egy minimális konfigurációval rendelkező példányt.

az iot du instance create -n {account_name} -i {instance_name} --iothub-ids {iothub_resource_id}

Hozzon létre egy példányt, amelyen engedélyezve van a diagnosztika, és párosítva van egy felhasználó által megadott tárfiókkal. Címkék belefoglalása.

az iot du instance create -n {account_name} -i {instance_name} --iothub-ids {iothub_resource_id} --enable-diagnostics --diagnostics-storage-id {storage_account_resource_id} --tags a=b

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a az config set defaults.adu_instance={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--iothub-ids

Szóközzel elválasztott IoT Hub erőforrás-azonosítók.

Tulajdonság	Érték
Paramétercsoport:	IoT Hub Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--acquire-policy-token

Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.

Tulajdonság	Érték
Paramétercsoport:	Global Policy Arguments

--change-reference

Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.

Tulajdonság	Érték
Paramétercsoport:	Global Policy Arguments

--diagnostics-storage-id

A felhasználó megadta a tárfiók erőforrás-azonosítóját a diagnosztikai naplók gyűjteményében való használatra.

Tulajdonság	Érték
Paramétercsoport:	Storage Arguments

--enable-diagnostics

Engedélyezi a diagnosztikai naplók gyűjtését.

Tulajdonság	Érték
Elfogadott értékek:	false, true

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

Tulajdonság	Érték
Alapértelmezett érték:	False

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--tags

Erőforráscímkék. Tulajdonságzsák kulcs-érték párokban a következő formátumban: a=b c=d.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság	Érték
Alapértelmezett érték:	False

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság	Érték
Alapértelmezett érték:	False

--output -o

Kimeneti formátum.

Tulajdonság	Érték
Alapértelmezett érték:	json
Elfogadott értékek:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság	Érték
Alapértelmezett érték:	False

az iot du instance delete

Eszközfrissítési példány törlése.

az iot du instance delete --account
                          --instance
                          [--acquire-policy-token]
                          [--change-reference]
                          [--no-wait]
                          [--resource-group]
                          [--yes {false, true}]

Példák

Törölje a célfiókhoz társított példányt.

az iot du instance delete -n {account_name} -i {instance_name}

Törölje a célfiókhoz társított példányt, és hagyja ki a megerősítési kérést.

az iot du instance delete -n {account_name} -i {instance_name} -y

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a az config set defaults.adu_instance={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--acquire-policy-token

Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.

Tulajdonság	Érték
Paramétercsoport:	Global Policy Arguments

--change-reference

Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.

Tulajdonság	Érték
Paramétercsoport:	Global Policy Arguments

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

Tulajdonság	Érték
Alapértelmezett érték:	False

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--yes -y

Felhasználói kérések kihagyása. A művelet elfogadását jelzi. Elsősorban automatizálási forgatókönyvekhez használatos. Alapértelmezett: hamis.

Tulajdonság	Érték
Elfogadott értékek:	false, true

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság	Érték
Alapértelmezett érték:	False

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság	Érték
Alapértelmezett érték:	False

--output -o

Kimeneti formátum.

Tulajdonság	Érték
Alapértelmezett érték:	json
Elfogadott értékek:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság	Érték
Alapértelmezett érték:	False

az iot du instance list

Eszközfrissítési példányok listázása.

az iot du instance list --account
                        [--resource-group]

Példák

A célfiókhoz társított példányok listázása.

az iot du instance list -n {account_name}

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság	Érték
Alapértelmezett érték:	False

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság	Érték
Alapértelmezett érték:	False

--output -o

Kimeneti formátum.

Tulajdonság	Érték
Alapértelmezett érték:	json
Elfogadott értékek:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság	Érték
Alapértelmezett érték:	False

az iot du instance show

Eszközfrissítési példány megjelenítése.

az iot du instance show --account
                        --instance
                        [--resource-group]

Példák

A célfiókhoz társított példány részleteinek megjelenítése.

az iot du instance show -n {account_name} -i {instance_name}

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a az config set defaults.adu_instance={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság	Érték
Alapértelmezett érték:	False

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság	Érték
Alapértelmezett érték:	False

--output -o

Kimeneti formátum.

Tulajdonság	Érték
Alapértelmezett érték:	json
Elfogadott értékek:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság	Érték
Alapértelmezett érték:	False

az iot du instance update

Eszközfrissítési példány frissítése.

Jelenleg a következő példánytulajdonságok frissíthetők : iotHubs, enableDiagnostics, diagnosticStorageProperties és címkék.

az iot du instance update --account
                          --instance
                          [--acquire-policy-token]
                          [--add]
                          [--change-reference]
                          [--force-string]
                          [--no-wait]
                          [--remove]
                          [--resource-group]
                          [--set]

Példák

Adjon meg egy adott példánycímke-attribútumot.

az iot du instance update -n {account_name} -i {instance_name} --set tags.env='test'

Engedélyezze a diagnosztikát, és konfiguráljon egy tárfiókot a naplógyűjtéshez.

az iot du instance update -n {account_name} -i {instance_name} --set enableDiagnostics=true diagnosticStorageProperties.resourceId={storage_account_resource_id}

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a az config set defaults.adu_instance={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--acquire-policy-token

Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.

Tulajdonság	Érték
Paramétercsoport:	Global Policy Arguments

--add

Adjon hozzá egy objektumot az objektumok listájához egy elérési út és egy kulcsértékpár megadásával. Példa: --add property.listProperty <key=value, string or JSON string>.

Tulajdonság	Érték
Paramétercsoport:	Generic Update Arguments
Alapértelmezett érték:	[]

--change-reference

Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.

Tulajdonság	Érték
Paramétercsoport:	Global Policy Arguments

--force-string

A "set" vagy a "add" használata esetén a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.

Tulajdonság	Érték
Paramétercsoport:	Generic Update Arguments
Alapértelmezett érték:	False

--no-wait

Ne várja meg, amíg a hosszú ideig futó művelet befejeződik.

Tulajdonság	Érték
Alapértelmezett érték:	False

--remove

Tulajdonság vagy elem eltávolítása a listából. Példa: --remove property.list <indexToRemove> VAGY --remove propertyToRemove.

Tulajdonság	Érték
Paramétercsoport:	Generic Update Arguments
Alapértelmezett érték:	[]

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--set

Frissítsen egy objektumot egy beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=<value>.

Tulajdonság	Érték
Paramétercsoport:	Generic Update Arguments
Alapértelmezett érték:	[]

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság	Érték
Alapértelmezett érték:	False

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság	Érték
Alapértelmezett érték:	False

--output -o

Kimeneti formátum.

Tulajdonság	Érték
Alapértelmezett érték:	json
Elfogadott értékek:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság	Érték
Alapértelmezett érték:	False

az iot du instance wait

Tiltsa le, amíg a kívánt példány erőforrásállapota be nem teljesül.

az iot du instance wait --account
                        --instance
                        [--acquire-policy-token]
                        [--change-reference]
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--interval]
                        [--resource-group]
                        [--timeout]
                        [--updated]

Példák

Tiltsa le a célpéldány törlését.

az iot du instance wait -n {account_name} -i {instance_name} --deleted

Kötelező paraméterek

--account -n

Eszközfrissítési fiók neve. Az alapértelmezett fióknevet a az config set defaults.adu_account={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--instance -i

Eszközfrissítési példány neve. Az alapértelmezett példánynevet a az config set defaults.adu_instance={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

Opcionális paraméterek

Az alábbi paraméterek megadása nem kötelező, de a környezettől függően előfordulhat, hogy a parancs sikeres végrehajtásához egy vagy több is szükséges lehet.

--acquire-policy-token

Az erőforrásművelethez automatikusan beszerez egy Azure Policy-jogkivonatot.

Tulajdonság	Érték
Paramétercsoport:	Global Policy Arguments

--change-reference

Az erőforrásművelet kapcsolódó változáshivatkozás-azonosítója.

Tulajdonság	Érték
Paramétercsoport:	Global Policy Arguments

--created

Várjon, amíg létre nem jön a "provisioningState" a "Sikeres" helyen.

Tulajdonság	Érték
Paramétercsoport:	Wait Condition Arguments
Alapértelmezett érték:	False

--custom

Várjon, amíg a feltétel megfelel egy egyéni JMESPath-lekérdezésnek. Pl. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running"?.

Tulajdonság	Érték
Paramétercsoport:	Wait Condition Arguments

--deleted

Várjon a törlésig.

Tulajdonság	Érték
Paramétercsoport:	Wait Condition Arguments
Alapértelmezett érték:	False

--exists

Várjon, amíg az erőforrás létezik.

Tulajdonság	Érték
Paramétercsoport:	Wait Condition Arguments
Alapértelmezett érték:	False

--interval

Lekérdezési időköz másodpercben.

Tulajdonság	Érték
Paramétercsoport:	Wait Condition Arguments
Alapértelmezett érték:	30

--resource-group -g

Eszközfrissítési fiók erőforráscsoportjának neve. Az alapértelmezett csoportot a az config set defaults.adu_group={name}használatával konfigurálhatja.

Tulajdonság	Érték
Paramétercsoport:	Account Identifier Arguments

--timeout

Maximális várakozás másodpercben.

Tulajdonság	Érték
Paramétercsoport:	Wait Condition Arguments
Alapértelmezett érték:	3600

--updated

Várjon, amíg frissül a provisioningState a következő helyen: "Sikeres".

Tulajdonság	Érték
Paramétercsoport:	Wait Condition Arguments
Alapértelmezett érték:	False

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

Tulajdonság	Érték
Alapértelmezett érték:	False

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

Tulajdonság	Érték
Alapértelmezett érték:	False

--output -o

Kimeneti formátum.

Tulajdonság	Érték
Alapértelmezett érték:	json
Elfogadott értékek:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a az account set -s NAME_OR_IDhasználatával konfigurálhatja.

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

Tulajdonság	Érték
Alapértelmezett érték:	False