az guestconfig guest-configuration-assignment
Note
This reference is part of the guestconfig extension for the Azure CLI (version 2.3.1 or higher). De extensie installeert automatisch de eerste keer dat u een az guestconfig guest-configuration-assignment opdracht uitvoert. Learn more about extensions.
Deze opdrachtgroep is experimenteel en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Guestconfig guest-configuration-assignment.
Opdracht
Name | Description | Type | Status |
---|---|---|---|
az guestconfig guest-configuration-assignment create |
Hiermee maakt u een koppeling tussen een VIRTUELE machine en een gastconfiguratie. |
Extension | Experimental |
az guestconfig guest-configuration-assignment delete |
Verwijder een toewijzing van een gastconfiguratie. |
Extension | Experimental |
az guestconfig guest-configuration-assignment list |
Geef alle gastconfiguratietoewijzingen voor een virtuele machine weer. |
Extension | Experimental |
az guestconfig guest-configuration-assignment show |
Informatie ophalen over een toewijzing van een gastconfiguratie. |
Extension | Experimental |
az guestconfig guest-configuration-assignment update |
Hiermee maakt u een koppeling tussen een VIRTUELE machine en een gastconfiguratie. |
Extension | Experimental |
az guestconfig guest-configuration-assignment wait |
Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de gastconfiguratie-toewijzing voor gastconfiguratie is voldaan. |
Extension | Experimental |
az guestconfig guest-configuration-assignment create
Opdrachtgroep 'guestconfig guest-configuration-assignment' is experimenteel en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Hiermee maakt u een koppeling tussen een VIRTUELE machine en een gastconfiguratie.
az guestconfig guest-configuration-assignment create --guest-configuration-assignment-name
--resource-group
--vm-name
[--context]
[--guest-configuration-configuration-parameter]
[--guest-configuration-configuration-setting]
[--guest-configuration-name]
[--guest-configuration-version]
[--latest-assignment-report-assignment]
[--location]
[--name]
[--no-wait]
Voorbeelden
Toewijzing van gastconfiguratie maken of bijwerken
az guestconfig guest-configuration-assignment create --guest-configuration-assignment-name "WhitelistedApplication" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName" --vm-name "myVMName"
Vereiste parameters
Naam van de toewijzing van de gastconfiguratie.
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
De naam van de virtuele machine.
Optionele parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
De bron waarmee de toewijzing van de gastconfiguratie is gestart. Bijvoorbeeld: Azure Policy.
De configuratieparameters voor de gastconfiguratie.
Gebruik: --guest-configuration-configuration-parameter name=XX value=XX
name: Naam van de configuratieparameter. waarde: Waarde van de configuratieparameter.
Meerdere acties kunnen worden opgegeven met behulp van meer dan één argument --guest-configuration-configuration-parameter.
De configuratie-instelling voor de gastconfiguratie.
Gebruik: --guest-configuration-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX
configuratiemodus: hiermee geeft u op hoe de LCM (Local Configuration Manager) de configuratie daadwerkelijk toepast op de doelknooppunten. Mogelijke waarden zijn ApplyOnly, ApplyAndMonitor en ApplyAndAutoCorrect. allow-module-overwrite: indien waar- nieuwe configuraties die zijn gedownload uit de pull-service, mogen de oude configuraties op het doelknooppunt overschrijven. Anders geeft u onwaar actie na opnieuw opstarten op: hiermee geeft u op wat er gebeurt na het opnieuw opstarten tijdens de toepassing van een configuratie. De mogelijke waarden zijn ContinueConfiguration- en StopConfiguration-vernieuwingsfrequentieminuten: het tijdsinterval, in minuten, waarbij de LCM een pull-service controleert om bijgewerkte configuraties op te halen. Deze waarde wordt genegeerd als de LCM niet is geconfigureerd in de pull-modus. De standaardwaarde is 30. opnieuw opstarten indien nodig: stel dit in op True om het knooppunt automatisch opnieuw op te starten nadat een configuratie waarvoor opnieuw opstarten is vereist, is toegepast. Anders moet u het knooppunt handmatig opnieuw opstarten voor elke configuratie die dit vereist. De standaardwaarde is onwaar. Als u deze instelling wilt gebruiken wanneer een voorwaarde voor opnieuw opstarten wordt uitgevoerd door iets anders dan DSC (zoals Windows Installer), combineert u deze instelling met de xPendingReboot-module. configuration-mode-frequency-mins: Hoe vaak, in minuten, de huidige configuratie wordt gecontroleerd en toegepast. Deze eigenschap wordt genegeerd als de eigenschap ConfigurationMode is ingesteld op ApplyOnly. De standaardwaarde is 15.
Naam van de gastconfiguratie.
Versie van de gastconfiguratie.
Configuratiedetails van de toewijzing van de gastconfiguratie. Verwachte waarde: json-string/@json-file.
Location. Waarden van: az account list-locations
. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>
.
Naam van de toewijzing van de gastconfiguratie.
Wacht niet totdat de langdurige bewerking is voltooid.
Eigenschap | Waarde |
---|---|
Default value: | False |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Eigenschap | Waarde |
---|---|
Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Eigenschap | Waarde |
---|---|
Default value: | False |
Output format.
Eigenschap | Waarde |
---|---|
Default value: | json |
Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
Eigenschap | Waarde |
---|---|
Default value: | False |
az guestconfig guest-configuration-assignment delete
Opdrachtgroep 'guestconfig guest-configuration-assignment' is experimenteel en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Verwijder een toewijzing van een gastconfiguratie.
az guestconfig guest-configuration-assignment delete [--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
[--vm-name]
Voorbeelden
Een toewijzing van een gastconfiguratie verwijderen
az guestconfig guest-configuration-assignment delete --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"
Optionele parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
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 |
---|---|
Parameter group: | Resource Id Arguments |
Naam van de toewijzing van de gastconfiguratie.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Wacht niet totdat de langdurige bewerking is voltooid.
Eigenschap | Waarde |
---|---|
Default value: | False |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
De naam van de virtuele machine.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Eigenschap | Waarde |
---|---|
Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Eigenschap | Waarde |
---|---|
Default value: | False |
Output format.
Eigenschap | Waarde |
---|---|
Default value: | json |
Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
Eigenschap | Waarde |
---|---|
Default value: | False |
az guestconfig guest-configuration-assignment list
Opdrachtgroep 'guestconfig guest-configuration-assignment' is experimenteel en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Geef alle gastconfiguratietoewijzingen voor een virtuele machine weer.
az guestconfig guest-configuration-assignment list --resource-group
--vm-name
Voorbeelden
Alle gastconfiguratietoewijzingen voor een virtuele machine weergeven
az guestconfig guest-configuration-assignment list --resource-group "myResourceGroupName" --vm-name "myVMName"
Vereiste parameters
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
De naam van de virtuele machine.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Eigenschap | Waarde |
---|---|
Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Eigenschap | Waarde |
---|---|
Default value: | False |
Output format.
Eigenschap | Waarde |
---|---|
Default value: | json |
Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
Eigenschap | Waarde |
---|---|
Default value: | False |
az guestconfig guest-configuration-assignment show
Opdrachtgroep 'guestconfig guest-configuration-assignment' is experimenteel en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Informatie ophalen over een toewijzing van een gastconfiguratie.
az guestconfig guest-configuration-assignment show [--ids]
[--name]
[--resource-group]
[--subscription]
[--vm-name]
Voorbeelden
Een toewijzing van een gastconfiguratie ophalen
az guestconfig guest-configuration-assignment show --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"
Optionele parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
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 |
---|---|
Parameter group: | Resource Id Arguments |
De naam van de toewijzing van de gastconfiguratie.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
De naam van de virtuele machine.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Eigenschap | Waarde |
---|---|
Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Eigenschap | Waarde |
---|---|
Default value: | False |
Output format.
Eigenschap | Waarde |
---|---|
Default value: | json |
Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
Eigenschap | Waarde |
---|---|
Default value: | False |
az guestconfig guest-configuration-assignment update
Opdrachtgroep 'guestconfig guest-configuration-assignment' is experimenteel en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Hiermee maakt u een koppeling tussen een VIRTUELE machine en een gastconfiguratie.
az guestconfig guest-configuration-assignment update [--context]
[--guest-configuration-assignment-name]
[--guest-configuration-configuration-parameter]
[--guest-configuration-configuration-setting]
[--guest-configuration-name]
[--guest-configuration-version]
[--ids]
[--latest-assignment-report-assignment]
[--location]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
[--vm-name]
Voorbeelden
Toewijzing van gastconfiguratie maken of bijwerken
az guestconfig guest-configuration-assignment update --guest-configuration-assignment-name "WhitelistedApplication" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName" --vm-name "myVMName"
Optionele parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
De bron waarmee de toewijzing van de gastconfiguratie is gestart. Bijvoorbeeld: Azure Policy.
Naam van de toewijzing van de gastconfiguratie.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
De configuratieparameters voor de gastconfiguratie.
Gebruik: --guest-configuration-configuration-parameter name=XX value=XX
name: Naam van de configuratieparameter. waarde: Waarde van de configuratieparameter.
Meerdere acties kunnen worden opgegeven met behulp van meer dan één argument --guest-configuration-configuration-parameter.
De configuratie-instelling voor de gastconfiguratie.
Gebruik: --guest-configuration-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX
configuratiemodus: hiermee geeft u op hoe de LCM (Local Configuration Manager) de configuratie daadwerkelijk toepast op de doelknooppunten. Mogelijke waarden zijn ApplyOnly, ApplyAndMonitor en ApplyAndAutoCorrect. allow-module-overwrite: indien waar- nieuwe configuraties die zijn gedownload uit de pull-service, mogen de oude configuraties op het doelknooppunt overschrijven. Anders geeft u onwaar actie na opnieuw opstarten op: hiermee geeft u op wat er gebeurt na het opnieuw opstarten tijdens de toepassing van een configuratie. De mogelijke waarden zijn ContinueConfiguration- en StopConfiguration-vernieuwingsfrequentieminuten: het tijdsinterval, in minuten, waarbij de LCM een pull-service controleert om bijgewerkte configuraties op te halen. Deze waarde wordt genegeerd als de LCM niet is geconfigureerd in de pull-modus. De standaardwaarde is 30. opnieuw opstarten indien nodig: stel dit in op True om het knooppunt automatisch opnieuw op te starten nadat een configuratie waarvoor opnieuw opstarten is vereist, is toegepast. Anders moet u het knooppunt handmatig opnieuw opstarten voor elke configuratie die dit vereist. De standaardwaarde is onwaar. Als u deze instelling wilt gebruiken wanneer een voorwaarde voor opnieuw opstarten wordt uitgevoerd door iets anders dan DSC (zoals Windows Installer), combineert u deze instelling met de xPendingReboot-module. configuration-mode-frequency-mins: Hoe vaak, in minuten, de huidige configuratie wordt gecontroleerd en toegepast. Deze eigenschap wordt genegeerd als de eigenschap ConfigurationMode is ingesteld op ApplyOnly. De standaardwaarde is 15.
Naam van de gastconfiguratie.
Versie van de gastconfiguratie.
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 |
---|---|
Parameter group: | Resource Id Arguments |
Configuratiedetails van de toewijzing van de gastconfiguratie. Verwachte waarde: json-string/@json-file.
Location. Waarden van: az account list-locations
. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>
.
Naam van de toewijzing van de gastconfiguratie.
Wacht niet totdat de langdurige bewerking is voltooid.
Eigenschap | Waarde |
---|---|
Default value: | False |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
De naam van de virtuele machine.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Eigenschap | Waarde |
---|---|
Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Eigenschap | Waarde |
---|---|
Default value: | False |
Output format.
Eigenschap | Waarde |
---|---|
Default value: | json |
Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
Eigenschap | Waarde |
---|---|
Default value: | False |
az guestconfig guest-configuration-assignment wait
Opdrachtgroep 'guestconfig guest-configuration-assignment' is experimenteel en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus
Plaats de CLI in een wachtstatus totdat aan een voorwaarde van de gastconfiguratie-toewijzing voor gastconfiguratie is voldaan.
az guestconfig guest-configuration-assignment wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
[--vm-name]
Voorbeelden
Pauzeer het uitvoeren van de volgende regel van het CLI-script totdat de gastconfiguratie-toewijzing is gemaakt.
az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --created
Pauzeer het uitvoeren van de volgende regel van het CLI-script totdat de gastconfiguratie-toewijzing is verwijderd.
az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --deleted
Optionele parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.
Eigenschap | Waarde |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Eigenschap | Waarde |
---|---|
Parameter group: | Wait Condition Arguments |
Wacht totdat deze is verwijderd.
Eigenschap | Waarde |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
Wacht tot de resource bestaat.
Eigenschap | Waarde |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
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 |
---|---|
Parameter group: | Resource Id Arguments |
Polling-interval in seconden.
Eigenschap | Waarde |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | 30 |
De naam van de toewijzing van de gastconfiguratie.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Maximale wachttijd in seconden.
Eigenschap | Waarde |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | 3600 |
Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.
Eigenschap | Waarde |
---|---|
Parameter group: | Wait Condition Arguments |
Default value: | False |
De naam van de virtuele machine.
Eigenschap | Waarde |
---|---|
Parameter group: | Resource Id Arguments |
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Eigenschap | Waarde |
---|---|
Default value: | False |
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Eigenschap | Waarde |
---|---|
Default value: | False |
Output format.
Eigenschap | Waarde |
---|---|
Default value: | json |
Geaccepteerde waarden: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
Eigenschap | Waarde |
---|---|
Default value: | False |