az connectedmachine extension

Note

Deze verwijzing maakt deel uit van de connectedmachine-extensie voor de Azure CLI (versie 2.75.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az connectedmachine extension opdracht uitvoert. Meer informatie over uitbreidingen.

Een VM-extensie beheren op een Azure Arc-Enabled Server.

Opdracht

Name	Description	Type	Status
az connectedmachine extension create	Maak een bewerking om de extensie te maken of bij te werken.	Extension	GA
az connectedmachine extension delete	Verwijderbewerking om de extensie te verwijderen.	Extension	GA
az connectedmachine extension image	Vm-extensiemetagegevens beheren die beschikbaar zijn voor Azure Arc-Enabled Servers.	Extension	GA
az connectedmachine extension image list	Geef alle extensieversies weer op basis van locatie, uitgever, extensionType.	Extension	GA
az connectedmachine extension image show	Haal een extensiemetagegevens op op basis van locatie, uitgever, extensionType en versie.	Extension	GA
az connectedmachine extension list	Haal alle extensies van een niet-Azure-machine op.	Extension	GA
az connectedmachine extension show	Haal de bewerking op om de extensie op te halen.	Extension	GA
az connectedmachine extension update	Updatebewerking voor het maken of bijwerken van de extensie.	Extension	GA
az connectedmachine extension wait	Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.	Extension	GA

az connectedmachine extension create

Maak een bewerking om de extensie te maken of bij te werken.

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]

Voorbeelden

voorbeeldopdracht voor het maken van extensies

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 }"'}"

Vereiste parameters

--extension-name --name -n

De naam van de computerextensie.

--machine-name

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

--resource-group -g

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

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

Eigenschap	Waarde
Parametergroep:	Properties Arguments
Geaccepteerde waarden:	0, 1, f, false, n, no, t, true, y, yes

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

Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie beschikbaar is.

Eigenschap	Waarde
Parametergroep:	Properties Arguments
Geaccepteerde waarden:	0, 1, f, false, n, no, t, true, y, yes

--force-update-tag

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

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--instance-view

De weergave van het exemplaar van de machineextensie. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--location -l

De geografische locatie waar de resource zich bevindt wanneer deze niet is opgegeven, wordt de locatie van de resourcegroep gebruikt.

Eigenschap	Waarde
Parametergroep:	ExtensionParameters Arguments

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Geaccepteerde waarden:	0, 1, f, false, n, no, t, true, y, yes

--protected-settings

De extensie kan protectedSettings of protectedSettingsFromKeyVault of helemaal geen beveiligde instellingen bevatten. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--publisher

De naam van de uitgever van de extensie-handler.

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--settings

In Json opgemaakte openbare instellingen voor de extensie. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--tags

Resourcetags. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap	Waarde
Parametergroep:	ExtensionParameters Arguments

--type

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

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--type-handler-version

Hiermee geeft u de versie van de scripthandler.

Eigenschap	Waarde
Parametergroep:	Properties Arguments

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedmachine extension delete

Verwijderbewerking om de extensie te verwijderen.

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]

Voorbeelden

voorbeeldopdracht voor verwijderen van extensie

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--extension-name --name -n

De naam van de computerextensie.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. U moet ofwel --id's of andere 'Resource Id'-argumenten opgeven.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--machine-name

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

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Geaccepteerde waarden:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--yes -y

Niet vragen om bevestiging.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedmachine extension list

Haal alle extensies van een niet-Azure-machine op.

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

Voorbeelden

Voorbeeldopdracht voor extensielijst

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

Vereiste parameters

--machine-name

De naam van de computer die de extensie bevat.

--resource-group -g

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--expand

De uitvouwexpressie die moet worden toegepast op de bewerking.

--max-items

Totaal aantal items dat moet worden geretourneerd in de uitvoer van de opdracht. Als het totale aantal beschikbare items groter is dan de opgegeven waarde, wordt een token opgegeven in de uitvoer van de opdracht. Als u paginering wilt hervatten, geeft u de tokenwaarde op in --next-token argument van een volgende opdracht.

Eigenschap	Waarde
Parametergroep:	Pagination Arguments

--next-token

Token om op te geven waar paginering moet worden gestart. Dit is de tokenwaarde van een eerder afgekapt antwoord.

Eigenschap	Waarde
Parametergroep:	Pagination Arguments

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedmachine extension show

Haal de bewerking op om de extensie op te halen.

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

Voorbeelden

voorbeeldopdracht voor extensievoorstelling

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--extension-name --name -n

De naam van de computerextensie.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--machine-name

De naam van de computer die de extensie bevat.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--resource-group -g

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

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedmachine extension update

Updatebewerking voor het maken of bijwerken van de extensie.

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]

Voorbeelden

voorbeeldopdracht voor extensie-update

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

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

Eigenschap	Waarde
Parametergroep:	Properties Arguments
Geaccepteerde waarden:	0, 1, f, false, n, no, t, true, y, yes

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

Geeft aan of de extensie automatisch moet worden bijgewerkt door het platform als er een nieuwere versie beschikbaar is.

Eigenschap	Waarde
Parametergroep:	Properties Arguments
Geaccepteerde waarden:	0, 1, f, false, n, no, t, true, y, yes

--extension-name --name -n

De naam van de computerextensie.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--force-update-tag

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

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--machine-name

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

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Geaccepteerde waarden:	0, 1, f, false, n, no, t, true, y, yes

--protected-settings

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--publisher

De naam van de uitgever van de extensie-handler.

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--resource-group -g

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

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--settings

In Json opgemaakte openbare instellingen voor de extensie. Ondersteuning voor shorthand-syntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--tags

Resourcetags ondersteunen afkortingsyntaxis, json-file en yaml-file. Probeer '??' om meer weer te geven.

Eigenschap	Waarde
Parametergroep:	ExtensionParameters Arguments

--type

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

Eigenschap	Waarde
Parametergroep:	Properties Arguments

--type-handler-version

Hiermee geeft u de versie van de scripthandler.

Eigenschap	Waarde
Parametergroep:	Properties Arguments

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az connectedmachine extension wait

Plaats de CLI in een wachtstatus totdat aan een voorwaarde is voldaan.

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

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	False

--custom

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

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments

--deleted

Wacht totdat deze is verwijderd.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	False

--exists

Wacht tot de resource bestaat.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	False

--extension-name --name -n

De naam van de computerextensie.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--ids

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--interval

Polling-interval in seconden.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	30

--machine-name

De naam van de computer die de extensie bevat.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--resource-group -g

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

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Eigenschap	Waarde
Parametergroep:	Resource Id Arguments

--timeout

Maximale wachttijd in seconden.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	3600

--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

Feedback

Is deze pagina nuttig?

Delen via

az connectedmachine extension

Opdracht

az connectedmachine extension create

Voorbeelden

Vereiste parameters

Optionele parameters

az connectedmachine extension delete

Voorbeelden

Optionele parameters

az connectedmachine extension list

Voorbeelden

Vereiste parameters

Optionele parameters

az connectedmachine extension show

Voorbeelden

Optionele parameters

az connectedmachine extension update

Voorbeelden

Optionele parameters

az connectedmachine extension wait

Optionele parameters

Feedback