az connectedmachine extension

Notitie

Deze verwijzing maakt deel uit van de extensie connectedmachine voor Azure CLI en vereist versie 2.11.0 of hoger. De extensie wordt automatisch geïnstalleerd wanneer u voor het eerst een opdracht az connectedmachine extension hebt uitgevoerd. Meer informatie over extensies.

Extensie van verbondenmachine.

Opdracht

az connectedmachine extension create

De bewerking voor het maken of bijwerken van de extensie.

az connectedmachine extension delete

De bewerking voor het verwijderen van de extensie.

az connectedmachine extension list

De bewerking om alle extensies van een niet-Azure-machine op te halen.

az connectedmachine extension show

De bewerking om de extensie op te halen.

az connectedmachine extension update

De bewerking voor het bijwerken van de extensie.

az connectedmachine extension wait

Plaats de CLI in een wachttoestand totdat aan een voorwaarde van de extensie connectedmachine wordt voldaan.

az connectedmachine extension create

De bewerking voor het maken of bijwerken van de extensie.

az connectedmachine extension create --extension-name
                                     --location
                                     --machine-name
                                     --resource-group
                                     [--auto-upgrade-minor {false, true}]
                                     [--force-update-tag]
                                     [--no-wait]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Voorbeelden

Een machine-extensie maken (PUT)

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

Vereiste parameters

--extension-name --name -n

De naam van de machine-extensie.

--location -l

Locatie. Waarden van: az account list-locations . U kunt de standaardlocatie configureren met az configure --defaults location=<location> behulp van .

--machine-name

De naam van de machine waarop de extensie moet worden gemaakt of bijgewerkt.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--auto-upgrade-minor

Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als er een beschikbaar is tijdens de implementatie. Zodra de extensie is geïmplementeerd, worden er echter geen secundaire versies geupgraded, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.

geaccepteerde waarden: false, true
--force-update-tag

Hoe de extensie-handler moet worden geforceerd om bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--protected-settings

De extensie kan protectedSettings of protectedSettingsFromKeyVault bevatten of helemaal geen beveiligde instellingen. Verwachte waarde: json-string/@json-file .

--publisher

De naam van de uitgever van de extensie-handler.

--settings

Openbare instellingen in JSON-indeling voor de extensie. Verwachte waarde: json-string/@json-file .

--tags

Door spatie gescheiden tags: sleutel[=waarde] [sleutel[=waarde] ...]. Gebruik '' om bestaande tags te verwijderen.

--type

Hiermee geeft u het type van de extensie; Een voorbeeld is CustomScriptExtension.

--type-handler-version

Hiermee geeft u de versie van de script-handler op.

az connectedmachine extension delete

De bewerking voor het verwijderen van de extensie.

az connectedmachine extension delete --extension-name
                                     --machine-name
                                     --resource-group
                                     [--no-wait]
                                     [--yes]

Voorbeelden

Een machine-extensie verwijderen

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

Vereiste parameters

--extension-name --name -n

De naam van de machine-extensie.

--machine-name

De naam van de computer waarop de extensie moet worden verwijderd.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--yes -y

Niet vragen om bevestiging.

az connectedmachine extension list

De bewerking om alle extensies van een niet-Azure-machine op te halen.

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

Voorbeelden

Alle machine-extensies downloaden

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

Vereiste parameters

--machine-name

De naam van de machine die de extensie bevat.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--expand

De expressie voor uitbreiden die moet worden toegepast op de bewerking.

az connectedmachine extension show

De bewerking om de extensie op te halen.

az connectedmachine extension show --extension-name
                                   --machine-name
                                   --resource-group

Voorbeelden

Machine-extensie op halen

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

Vereiste parameters

--extension-name --name -n

De naam van de machine-extensie.

--machine-name

De naam van de machine die de extensie bevat.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

az connectedmachine extension update

De bewerking voor het bijwerken van de extensie.

az connectedmachine extension update --extension-name
                                     --machine-name
                                     --resource-group
                                     [--auto-upgrade-minor {false, true}]
                                     [--force-update-tag]
                                     [--no-wait]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Voorbeelden

Een machine-extensie bijwerken (PATCH)

az connectedmachine extension update --machine-name "myMachine" --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version "1.10" --resource-group "myResourceGroup"

Vereiste parameters

--extension-name --name -n

De naam van de machine-extensie.

--machine-name

De naam van de machine waarop de extensie moet worden gemaakt of bijgewerkt.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--auto-upgrade-minor

Geeft aan of de extensie een nieuwere secundaire versie moet gebruiken als er een beschikbaar is tijdens de implementatie. Zodra de extensie is geïmplementeerd, worden er echter geen secundaire versies geupgraded, tenzij deze opnieuw wordt geïmplementeerd, zelfs niet als deze eigenschap is ingesteld op true.

geaccepteerde waarden: false, true
--force-update-tag

Hoe de extensie-handler moet worden geforceerd om bij te werken, zelfs als de extensieconfiguratie niet is gewijzigd.

--no-wait

Wacht niet tot de langlopende bewerking is uitgevoerd.

--protected-settings

De extensie kan protectedSettings of protectedSettingsFromKeyVault bevatten of helemaal geen beveiligde instellingen. Verwachte waarde: json-string/@json-file .

--publisher

De naam van de uitgever van de extensie-handler.

--settings

Openbare instellingen in JSON-indeling voor de extensie. Verwachte waarde: json-string/@json-file .

--tags

Door spatie gescheiden tags: sleutel[=waarde] [sleutel[=waarde] ...]. Gebruik '' om bestaande tags te verwijderen.

--type

Hiermee geeft u het type van de extensie; Een voorbeeld is CustomScriptExtension.

--type-handler-version

Hiermee geeft u de versie van de script-handler op.

az connectedmachine extension wait

Plaats de CLI in een wachttoestand totdat aan een voorwaarde van de extensie connectedmachine wordt voldaan.

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

Voorbeelden

Onderbreep de uitvoering van de volgende regel VAN HET CLI-script totdat de extensie connectedmachine is gemaakt.

az connectedmachine extension wait --machine-name "myMachine" --name "CustomScriptExtension" --resource-group "myResourceGroup" --created

Onderbreep de uitvoering van de volgende regel CLI-script totdat de extensie connectedmachine is bijgewerkt.

az connectedmachine extension wait --machine-name "myMachine" --name "CustomScriptExtension" --resource-group "myResourceGroup" --updated

Onderbreep de uitvoering van de volgende regel VAN HET CLI-script totdat de extensie connectedmachine is verwijderd.

az connectedmachine extension wait --machine-name "myMachine" --name "CustomScriptExtension" --resource-group "myResourceGroup" --deleted

Vereiste parameters

--extension-name --name -n

De naam van de machine-extensie.

--machine-name

De naam van de machine die de extensie bevat.

--resource-group -g

De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .

Optionele parameters

--created

Wacht totdat u met provisioningState bij Succeeded hebt gemaakt.

--custom

Wacht totdat de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Wacht totdat u deze hebt verwijderd.

--exists

Wacht totdat de resource bestaat.

--interval

Pollinginterval in seconden.

standaardwaarde: 30
--timeout

Maximale wachttijd in seconden.

standaardwaarde: 3600
--updated

Wacht totdat de provisioningState is bijgewerkt op 'Succeeded'.