az connectedmachine extension

  • Referens

Kommentar

Den här referensen är en del av connectedmachine-tillägget för Azure CLI (version 2.49.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az connectedmachine-tilläggskommando . Läs mer om tillägg.

Hantera ett VM-tillägg på en Azure Arc-aktiverad server.

Kommandon

Name Description Typ Status
az connectedmachine extension create

Åtgärden för att skapa tillägget.

 Anknytning GA
az connectedmachine extension delete

Åtgärden för att ta bort tillägget.

 Anknytning GA
az connectedmachine extension image

Hantera metadata för VM-tillägg som är tillgängliga för Azure Arc-aktiverade servrar.

 Anknytning GA
az connectedmachine extension image list

Visa en lista över alla tilläggsversioner baserat på plats, utgivare, extensionType.

 Anknytning GA
az connectedmachine extension image show

Hämta ett tilläggsmetadata baserat på plats, utgivare, extensionType och version.

 Anknytning GA
az connectedmachine extension list

Åtgärden för att hämta alla tillägg för en icke-Azure-dator.

 Anknytning GA
az connectedmachine extension show

Åtgärden för att skapa eller uppdatera tillägget.

 Anknytning GA
az connectedmachine extension update

Uppdatera åtgärden för att uppdatera tillägget.

 Anknytning GA
az connectedmachine extension wait

Placera CLI i vänteläge tills ett villkor uppfylls.

 Anknytning GA

az connectedmachine extension create

Åtgärden för att skapa tillägget.

az connectedmachine extension create --extension-name
                                     --machine-name
                                     --resource-group
                                     [--auto-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--auto-upgrade-minor {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]

Exempel

Exempelkommando för att skapa tillägget

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

Obligatoriska parametrar

--extension-name --name -n

Namnet på datortillägget.

--machine-name

Namnet på den dator där tillägget ska skapas eller uppdateras.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--auto-upgrade --enable-auto-upgrade --enable-automatic-upgrade

Anger om tillägget ska uppgraderas automatiskt av plattformen om det finns en nyare version tillgänglig.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--auto-upgrade-minor --auto-upgrade-minor-version --upgrade-minor-ver

Anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionstillfället. När tillägget har distribuerats uppgraderas dock inte mindre versioner om de inte distribueras om, även med den här egenskapen inställd på true.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--force-update-tag

Hur tilläggshanteraren ska tvingas uppdatera även om tilläggskonfigurationen inte har ändrats.

--instance-view

Instansvyn för datortillägget. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--location -l

Den geo-plats där resursen finns När den inte anges används platsen för resursgruppen.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--protected-settings

Tillägget kan innehålla antingen skyddade Inställningar eller skyddade Inställningar FromKeyVault eller inga skyddade inställningar alls. Stöd för json-file och yaml-file.

--publisher

Namnet på tilläggshanterarens utgivare.

--settings

Json har formaterat offentliga inställningar för tillägget. Stöd för json-file och yaml-file.

--tags

Resurstaggar. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--type

Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension".

--type-handler-version

Anger versionen av skripthanteraren.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedmachine extension delete

Åtgärden för att ta bort tillägget.

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

Exempel

Exempelkommando för borttagning av tillägg

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

Valfria parametrar

--extension-name --name -n

Namnet på datortillägget.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--machine-name

Namnet på den dator där tillägget ska tas bort.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--yes -y

Fråga inte efter bekräftelse.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedmachine extension list

Åtgärden för att hämta alla tillägg för en icke-Azure-dator.

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]

Exempel

Exempelkommando för tilläggslista

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

Obligatoriska parametrar

--machine-name

Namnet på den dator som innehåller tillägget.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

Valfria parametrar

--expand

Det expanderingsuttryck som ska tillämpas på åtgärden.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedmachine extension show

Åtgärden för att skapa eller uppdatera tillägget.

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

Exempel

Exempelkommando för tilläggsvisning

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

Valfria parametrar

--extension-name --name -n

Namnet på datortillägget.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--machine-name

Namnet på den dator som innehåller tillägget.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedmachine extension update

Uppdatera åtgärden för att uppdatera tillägget.

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

Exempel

Exempelkommando för tilläggsuppdatering

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

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string eller JSON string>.

--auto-upgrade --enable-auto-upgrade --enable-automatic-upgrade

Anger om tillägget ska uppgraderas automatiskt av plattformen om det finns en nyare version tillgänglig.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--auto-upgrade-minor --auto-upgrade-minor-version --upgrade-minor-ver

Anger om tillägget ska använda en nyare delversion om en är tillgänglig vid distributionstillfället. När tillägget har distribuerats uppgraderas dock inte mindre versioner om de inte distribueras om, även med den här egenskapen inställd på true.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--extension-name --name -n

Namnet på datortillägget.

--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--force-update-tag

Hur tilläggshanteraren ska tvingas uppdatera även om tilläggskonfigurationen inte har ändrats.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--instance-view

Instansvyn för datortillägget. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--machine-name

Namnet på den dator som innehåller tillägget.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

accepterade värden: 0, 1, f, false, n, no, t, true, y, yes
--protected-settings

Tillägget kan innehålla antingen skyddade Inställningar eller skyddade Inställningar FromKeyVault eller inga skyddade inställningar alls. Stöd för json-file och yaml-file.

--publisher

Namnet på tilläggshanterarens utgivare.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=.

--settings

Json har formaterat offentliga inställningar för tillägget. Stöd för json-file och yaml-file.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--tags

Resurstaggar. Stöd för shorthand-syntax, json-file och yaml-file. Prova "??" för att visa mer.

--type

Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension".

--type-handler-version

Anger versionen av skripthanteraren.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az connectedmachine extension wait

Placera CLI i vänteläge tills ett villkor uppfylls.

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

Valfria parametrar

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Vänta tills den har tagits bort.

standardvärde: False
--exists

Vänta tills resursen finns.

standardvärde: False
--extension-name --name -n

Namnet på datortillägget.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--interval

Avsökningsintervall i sekunder.

standardvärde: 30
--machine-name

Namnet på den dator som innehåller tillägget.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--timeout

Maximal väntetid i sekunder.

standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

accepterade värden: json, jsonc, none, table, tsv, yaml, yamlc
standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.