Sdílet prostřednictvím


az connectedmachine extension

Note

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

Správa rozšíření virtuálního počítače na Azure Arc-Enabled Serveru

Příkazy

Name Description Typ Stav
az connectedmachine extension create

Vytvořte operaci pro vytvoření nebo aktualizaci rozšíření.

Extension GA
az connectedmachine extension delete

Operace odstranění rozšíření.

Extension GA
az connectedmachine extension image

Správa metadat rozšíření virtuálního počítače dostupná pro servery Azure Arc-Enabled

Extension GA
az connectedmachine extension image list

Zobrazí seznam všech verzí rozšíření na základě umístění, vydavatele, extensionType.

Extension GA
az connectedmachine extension image show

Získejte metadata rozšíření na základě umístění, vydavatele, extensionType a verze.

Extension GA
az connectedmachine extension list

Získejte všechna rozšíření počítače mimo Azure.

Extension GA
az connectedmachine extension show

Získání operace pro získání rozšíření

Extension GA
az connectedmachine extension update

Operace aktualizace pro vytvoření nebo aktualizaci rozšíření

Extension GA
az connectedmachine extension wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.

Extension GA

az connectedmachine extension create

Vytvořte operaci pro vytvoření nebo aktualizaci rozšíření.

az connectedmachine extension create --extension-name --name
                                     --machine-name
                                     --resource-group
                                     [--auto-upgrade-min --auto-upgrade-minor-version {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--enable-auto-upgrade --enable-automatic-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--force-update-tag]
                                     [--instance-view]
                                     [--location]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Příklady

sample command for extension create

az connectedmachine extension create --resource-group myResourceGroup --machine-name myMachine --extension-name CustomScriptExtension --location eastus2euap --publisher Microsoft.Compute --type-handler-version 1.10 --type CustomScriptExtension --settings "{commandToExecute:'powershell.exe -c "Get-Process | Where-Object { $_.CPU -gt 10000 }"'}"

Povinné parametry

--extension-name --name -n

Název rozšíření počítače.

--machine-name

Název počítače, ve kterém se má rozšíření vytvořit nebo aktualizovat.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

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.

--auto-upgrade-min --auto-upgrade-minor-version

Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--enable-auto-upgrade --enable-automatic-upgrade

Označuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--force-update-tag

Způsob vynucení aktualizace obslužné rutiny rozšíření i v případě, že se konfigurace rozšíření nezměnila.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--instance-view

Zobrazení instance rozšíření počítače. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--location -l

Geografické umístění, ve kterém se prostředek nachází, pokud není zadaný, se použije umístění skupiny prostředků.

Vlastnost Hodnota
Skupina parametrů: ExtensionParameters Arguments
--no-wait

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

Vlastnost Hodnota
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--protected-settings

Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--publisher

Název vydavatele obslužné rutiny rozšíření.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--settings

Veřejná nastavení formátovaná json pro rozšíření Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--tags

Značky prostředků Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: ExtensionParameters Arguments
--type

Určuje typ rozšíření; Příkladem je CustomScriptExtension.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--type-handler-version

Určuje verzi obslužné rutiny skriptu.

Vlastnost Hodnota
Skupina parametrů: Properties 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 connectedmachine extension delete

Operace odstranění rozšíření.

az connectedmachine extension delete [--extension-name --name]
                                     [--ids]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--resource-group]
                                     [--subscription]
                                     [--yes]

Příklady

ukázkový příkaz pro odstranění rozšíření

az connectedmachine extension delete --resource-group myResourceGroup --machine-name myMachine --extension-name MMA

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.

--extension-name --name -n

Název rozšíření počítače.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--machine-name

Název počítače, na kterém má být rozšíření odstraněno.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--no-wait

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

Vlastnost Hodnota
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--subscription

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

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--yes -y

Nevyzývejte k potvrzení.

Vlastnost Hodnota
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.

--verbose

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

Vlastnost Hodnota
Default value: False

az connectedmachine extension list

Získejte všechna rozšíření počítače mimo Azure.

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]
                                   [--max-items]
                                   [--next-token]

Příklady

Ukázkový příkaz pro seznam rozšíření

az connectedmachine extension list --machine-name myMachine --resource-group myResourceGroup

Povinné parametry

--machine-name

Název počítače obsahujícího rozšíření.

--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

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.

--expand

Výraz rozbalení, který se má použít pro operaci.

--max-items

Celkový počet položek, které se mají vrátit ve výstupu příkazu Pokud je celkový počet dostupných položek větší než zadaná hodnota, zobrazí se ve výstupu příkazu token. Pokud chcete pokračovat ve stránkování, zadejte hodnotu tokenu v --next-token argumentu následného příkazu.

Vlastnost Hodnota
Skupina parametrů: Pagination Arguments
--next-token

Token určující, kde se má stránkování spustit. Toto je hodnota tokenu z dříve zkrácené odpovědi.

Vlastnost Hodnota
Skupina parametrů: Pagination 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 connectedmachine extension show

Získání operace pro získání rozšíření

az connectedmachine extension show [--extension-name --name]
                                   [--ids]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]

Příklady

ukázkový příkaz pro rozšíření show

az connectedmachine extension show --resource-group myResourceGroup --machine-name myMachine --extension-name CustomScriptExtension

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.

--extension-name --name -n

Název rozšíření počítače.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--machine-name

Název počítače obsahujícího rozšíření.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--subscription

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

Vlastnost Hodnota
Skupina parametrů: Resource Id 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.

--verbose

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

Vlastnost Hodnota
Default value: False

az connectedmachine extension update

Operace aktualizace pro vytvoření nebo aktualizaci rozšíření

az connectedmachine extension update [--auto-upgrade-min --auto-upgrade-minor-version {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--enable-auto-upgrade --enable-automatic-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--extension-name --name]
                                     [--force-update-tag]
                                     [--ids]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--resource-group]
                                     [--settings]
                                     [--subscription]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Příklady

ukázkový příkaz pro aktualizaci rozšíření

az connectedmachine extension update --name CustomScriptExtension --type CustomScriptExtension --publisher Microsoft.Compute --type-handler-version 1.10 --machine-name myMachine --resource-group myResourceGroup

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.

--auto-upgrade-min --auto-upgrade-minor-version

Určuje, jestli má rozšíření používat novější podverzi, pokud je k dispozici v době nasazení. Po nasazení však rozšíření neupgraduje podverze, pokud se znovu nenasadí, a to ani s touto vlastností nastavenou na true.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--enable-auto-upgrade --enable-automatic-upgrade

Označuje, jestli má být rozšíření automaticky upgradováno platformou, pokud je k dispozici novější verze.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--extension-name --name -n

Název rozšíření počítače.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--force-update-tag

Způsob vynucení aktualizace obslužné rutiny rozšíření i v případě, že se konfigurace rozšíření nezměnila.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--machine-name

Název počítače, ve kterém se má rozšíření vytvořit nebo aktualizovat.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--no-wait

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

Vlastnost Hodnota
Přípustné hodnoty: 0, 1, f, false, n, no, t, true, y, yes
--protected-settings

Rozšíření může obsahovat buď protectedSettings, nebo protectedSettingsFromKeyVault, nebo vůbec žádná chráněná nastavení. Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--publisher

Název vydavatele obslužné rutiny rozšíření.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--settings

Veřejná nastavení formátovaná json pro rozšíření Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--subscription

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

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--tags

Značky prostředků podporují zkratkovou syntaxi, json-file a yaml-file. Zkuste "??" zobrazit více.

Vlastnost Hodnota
Skupina parametrů: ExtensionParameters Arguments
--type

Určuje typ rozšíření; Příkladem je CustomScriptExtension.

Vlastnost Hodnota
Skupina parametrů: Properties Arguments
--type-handler-version

Určuje verzi obslužné rutiny skriptu.

Vlastnost Hodnota
Skupina parametrů: Properties 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.

--verbose

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

Vlastnost Hodnota
Default value: False

az connectedmachine extension wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud není splněna podmínka.

az connectedmachine extension wait [--created]
                                   [--custom]
                                   [--deleted]
                                   [--exists]
                                   [--extension-name --name]
                                   [--ids]
                                   [--interval]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]
                                   [--timeout]
                                   [--updated]

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
--extension-name --name -n

Název rozšíření počítače.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--ids

Jedno nebo více ID prostředků (oddělené mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat buď argumenty --ids, nebo jiné argumenty 'ID prostředku'.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--interval

Interval dotazování v sekundách

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

Název počítače obsahujícího rozšíření.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--resource-group -g

Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

Vlastnost Hodnota
Skupina parametrů: Resource Id Arguments
--subscription

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

Vlastnost Hodnota
Skupina parametrů: Resource Id 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.

--verbose

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

Vlastnost Hodnota
Default value: False