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
Název rozšíření počítače.
Název počítače, ve kterém se má rozšíření vytvořit nebo aktualizovat.
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.
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 |
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 |
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 |
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 |
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 |
Nečekejte na dokončení dlouhotrvající operace.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | 0, 1, f, false, n, no, t, true, y, yes |
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 |
Název vydavatele obslužné rutiny rozšíření.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
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 |
Značky prostředků Podpora zkratky syntaxe, json-file a yaml-file Zkuste "??" zobrazit více.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | ExtensionParameters Arguments |
Určuje typ rozšíření; Příkladem je CustomScriptExtension.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Určuje verzi obslužné rutiny skriptu.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
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.
Název rozšíření počítače.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
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 |
Název počítače, na kterém má být rozšíření odstraněno.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Nečekejte na dokončení dlouhotrvající operace.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | 0, 1, f, false, n, no, t, true, y, yes |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
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 |
Nevyzývejte k potvrzení.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
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
Název počítače obsahujícího rozšíření.
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.
Výraz rozbalení, který se má použít pro operaci.
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 |
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
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.
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.
Název rozšíření počítače.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
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 |
Název počítače obsahujícího rozšíření.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
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
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
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.
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 |
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 |
Název rozšíření počítače.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
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 |
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 |
Název počítače, ve kterém se má rozšíření vytvořit nebo aktualizovat.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Nečekejte na dokončení dlouhotrvající operace.
| Vlastnost | Hodnota |
|---|---|
| Přípustné hodnoty: | 0, 1, f, false, n, no, t, true, y, yes |
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 |
Název vydavatele obslužné rutiny rozšíření.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
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 |
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 |
Značky prostředků podporují zkratkovou syntaxi, json-file a yaml-file. Zkuste "??" zobrazit více.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | ExtensionParameters Arguments |
Určuje typ rozšíření; Příkladem je CustomScriptExtension.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Určuje verzi obslužné rutiny skriptu.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Properties Arguments |
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
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.
Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | False |
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 |
Počkejte na odstranění.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | False |
Počkejte, až prostředek existuje.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | False |
Název rozšíření počítače.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
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 dotazování v sekundách
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | 30 |
Název počítače obsahujícího rozšíření.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Resource Id Arguments |
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 |
Maximální čekání v sekundách.
| Vlastnost | Hodnota |
|---|---|
| Skupina parametrů: | Wait Condition Arguments |
| Default value: | 3600 |
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
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazit pouze chyby, potlačit upozornění.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |
Výstupní formát
| Vlastnost | Hodnota |
|---|---|
| Default value: | json |
| Přípustné hodnoty: | json, jsonc, none, table, tsv, yaml, yamlc |
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
| Vlastnost | Hodnota |
|---|---|
| Default value: | False |