az iot du instance

Note

Tento odkaz je součástí rozšíření azure-iot pro Azure CLI (verze 2.67.0 nebo vyšší). Rozšíření se automaticky nainstaluje při prvním spuštění příkazu az iot du instance. Přečtěte si další informace o rozšířeních.

Správa instancí služby Device Update

Příkazy

Name	Description	Typ	Stav
az iot du instance create	Vytvořte instanci služby Device Update.	Extension	GA
az iot du instance delete	Odstraňte instanci služby Device Update.	Extension	GA
az iot du instance list	Výpis instancí služby Device Update	Extension	GA
az iot du instance show	Zobrazí instanci služby Device Update.	Extension	GA
az iot du instance update	Aktualizujte instanci služby Device Update.	Extension	GA
az iot du instance wait	Blokovat, dokud nebude splněn stav požadovaného prostředku instance.	Extension	GA

az iot du instance create

Vytvořte instanci služby Device Update.

Tento příkaz lze také použít k aktualizaci stavu existující instance.

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

Příklady

Vytvořte instanci s minimální konfigurací.

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

Vytvořte instanci s povolenou diagnostikou spárovanou s uživatelským účtem úložiště. Zahrnout značky.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--iothub-ids

ID prostředků IoT Hubu odděleného mezerami

Vlastnost	Hodnota
Skupina parametrů:	IoT Hub Arguments

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--diagnostics-storage-id

Uživatel zadal ID prostředku účtu úložiště pro použití v kolekci diagnostických protokolů.

Vlastnost	Hodnota
Skupina parametrů:	Storage Arguments

--enable-diagnostics

Povolí shromažďování diagnostických protokolů.

Vlastnost	Hodnota
Přípustné hodnoty:	false, true

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost	Hodnota
Default value:	False

--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--tags

Značky prostředků Taška vlastností ve dvojicích klíč-hodnota s následujícím formátem: a=b c=d.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az iot du instance delete

Odstraňte instanci služby Device Update.

az iot du instance delete --account
                          --instance
                          [--no-wait]
                          [--resource-group]
                          [--yes {false, true}]

Příklady

Odstraňte instanci přidruženou k cílovému účtu.

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

Odstraňte instanci přidruženou k cílovému účtu a přeskočte potvrzovací výzvu.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost	Hodnota
Default value:	False

--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--yes -y

Přeskočte výzvy uživatele. Označuje přijetí akce. Používá se především pro scénáře automatizace. Výchozí hodnota: false.

Vlastnost	Hodnota
Přípustné hodnoty:	false, true

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az iot du instance list

Výpis instancí služby Device Update

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

Příklady

Zobrazí seznam instancí přidružených k cílovému účtu.

az iot du instance list -n {account_name}

Povinné parametry

--account -n

Název účtu aktualizace zařízení Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az iot du instance show

Zobrazí instanci služby Device Update.

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

Příklady

Zobrazí podrobnosti o instanci přidružené k cílovému účtu.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az iot du instance update

Aktualizujte instanci služby Device Update.

V současné době je možné aktualizovat následující vlastnosti instance – iotHubs, enableDiagnostics, diagnosticStorageProperties a značky.

az iot du instance update --account
                          --instance
                          [--add]
                          [--force-string]
                          [--no-wait]
                          [--remove]
                          [--resource-group]
                          [--set]

Příklady

Nastavte atribut značky konkrétní instance.

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

Povolte diagnostiku a nakonfigurujte účet úložiště pro shromažďování protokolů.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--add

Přidejte objekt do seznamu objektů zadáním párů cest a klíč-hodnota. Příklad: --add property.listProperty <key=value, string or JSON string>.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

--force-string

Při použití set nebo add zachovávejte řetězcové literály místo pokusu o převod na JSON.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	False

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Vlastnost	Hodnota
Default value:	False

--remove

Odeberte vlastnost nebo prvek ze seznamu. Příklad: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--set

Aktualizujte objekt zadáním cesty vlastnosti a hodnoty, která se má nastavit. Příklad: --set property1.property2=<value>.

Vlastnost	Hodnota
Skupina parametrů:	Generic Update Arguments
Default value:	[]

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False

az iot du instance wait

Blokovat, dokud nebude splněn stav požadovaného prostředku instance.

az iot du instance wait --account
                        --instance
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--interval]
                        [--resource-group]
                        [--timeout]
                        [--updated]

Příklady

Blokovat, dokud nedojde k odstranění cílové instance.

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

Povinné parametry

--account -n

Název účtu aktualizace zařízení Výchozí název účtu můžete nakonfigurovat pomocí az config set defaults.adu_account={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--instance -i

Název instance služby Device Update Výchozí název instance můžete nakonfigurovat pomocí az config set defaults.adu_instance={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

Volitelné parametry

Následující parametry jsou volitelné, ale v závislosti na kontextu se může stát, že se jeden nebo více vyžaduje, aby se příkaz úspěšně spustil.

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments

--deleted

Počkejte na odstranění.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--exists

Počkejte, až prostředek existuje.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

--interval

Interval dotazování v sekundách

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	30

--resource-group -g

Název skupiny prostředků účtu služby Device Update Výchozí skupinu můžete nakonfigurovat pomocí az config set defaults.adu_group={name}.

Vlastnost	Hodnota
Skupina parametrů:	Account Identifier Arguments

--timeout

Maximální čekání v sekundách.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	3600

--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Vlastnost	Hodnota
Skupina parametrů:	Wait Condition Arguments
Default value:	False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

Vlastnost	Hodnota
Default value:	False

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazit pouze chyby, potlačit upozornění.

Vlastnost	Hodnota
Default value:	False

--output -o

Výstupní formát

Vlastnost	Hodnota
Default value:	json
Přípustné hodnoty:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

Vlastnost	Hodnota
Default value:	False