Freigeben über

az guestconfig guest-configuration-assignment

  • Experimentell
  • Referenz

Hinweis

Diese Referenz ist Teil der Guestconfig-Erweiterung für die Azure CLI (Version 2.3.1 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az guestconfig-guest-configuration-assignment-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Diese Befehlsgruppe ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Guestconfig-Gastkonfigurationszuweisung.

Befehle

Name Beschreibung Typ Status
az guestconfig guest-configuration-assignment create

Erstellt eine Zuordnung zwischen einer VM und einer Gastkonfiguration.

 Durchwahl Experimentell
az guestconfig guest-configuration-assignment delete

Löschen einer Gastkonfigurationszuweisung.

 Durchwahl Experimentell
az guestconfig guest-configuration-assignment list

Listet alle Gastkonfigurationszuweisungen für einen virtuellen Computer auf.

 Durchwahl Experimentell
az guestconfig guest-configuration-assignment show

Abrufen von Informationen zu einer Gastkonfigurationszuweisung.

 Durchwahl Experimentell
az guestconfig guest-configuration-assignment update

Erstellt eine Zuordnung zwischen einer VM und einer Gastkonfiguration.

 Durchwahl Experimentell
az guestconfig guest-configuration-assignment wait

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Guestconfig-Gastkonfigurationszuweisung erfüllt ist.

 Durchwahl Experimentell

az guestconfig guest-configuration-assignment create

Experimentell

Die Befehlsgruppe "guestconfig guest-configuration-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellt eine Zuordnung zwischen einer VM und einer Gastkonfiguration.

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]

Beispiele

Erstellen oder Aktualisieren der Gastkonfigurationszuweisung

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"

Erforderliche Parameter

--guest-configuration-assignment-name

Name der Gastkonfigurationszuweisung.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--vm-name

Der Name des virtuellen Computers.

Optionale Parameter

--context

Die Quelle, die die Gastkonfigurationszuweisung initiiert hat. Beispiel: Azure-Richtlinie.

--guest-configuration-configuration-parameter

Die Konfigurationsparameter für die Gastkonfiguration.

Verwendung: --guest-configuration-configuration-parameter name=XX value=XX

name: Name des Konfigurationsparameters. wert: Wert des Konfigurationsparameters.

Mehrere Aktionen können mit mehreren Argumenten --guest-configuration-configuration-configuration-parameter angegeben werden.

--guest-configuration-configuration-setting

Die Konfigurationseinstellung für die Gastkonfiguration.

Verwendung: --guest-configuration-setting 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

Konfigurationsmodus: Gibt an, wie der LCM(Local Configuration Manager) die Konfiguration tatsächlich auf die Zielknoten anwendet. Mögliche Werte sind ApplyOnly, ApplyAndMonitor und ApplyAndAutoCorrect. allow-module-overwrite: If true – neue Konfigurationen, die vom Pulldienst heruntergeladen wurden, dürfen die alten im Zielknoten überschreiben. Andernfalls " false action-after-reboot: Gibt an, was nach einem Neustart während der Anwendung einer Konfiguration passiert. Die möglichen Werte sind ContinueConfiguration und StopConfiguration refresh-frequency-min: Das Zeitintervall in Minuten, in dem das LCM einen Pulldienst überprüft, um aktualisierte Konfigurationen abzurufen. Dieser Wert wird ignoriert, wenn der LCM nicht im Pullmodus konfiguriert ist. Der Standardwert ist 30. reboot-if-needed: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Andernfalls müssen Sie den Knoten für jede Konfiguration manuell neu starten, die dies erfordert. Der Standardwert ist „FALSE“. Um diese Einstellung zu verwenden, wenn eine Neustartbedingung von einer anderen Komponente als von DSC in Kraft gesetzt wird (z.B. Windows Installer), kombinieren Sie diese Einstellung mit dem Modul xPendingReboot. Configuration-mode-frequency-mins: Wie oft, in Minuten, die aktuelle Konfiguration überprüft und angewendet wird. Diese Eigenschaft wird ignoriert, wenn die Eigenschaft ConfigurationMode auf ApplyOnly festgelegt ist. Der Standardwert ist 15.

--guest-configuration-name

Name der Gastkonfiguration.

--guest-configuration-version

Version der Gastkonfiguration.

--latest-assignment-report-assignment

Konfigurationsdetails der Gastkonfigurationszuweisung. Erwarteter Wert: json-string/@json-file.

--location -l

Position Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name

Name der Gastkonfigurationszuweisung.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az guestconfig guest-configuration-assignment delete

Experimentell

Die Befehlsgruppe "guestconfig guest-configuration-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen einer Gastkonfigurationszuweisung.

az guestconfig guest-configuration-assignment delete [--ids]
                                                     [--name]
                                                     [--no-wait]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--vm-name]

Beispiele

Löschen einer Gastkonfigurationszuweisung

az guestconfig guest-configuration-assignment delete --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name der Gastkonfigurationszuweisung.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--vm-name

Der Name des virtuellen Computers.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az guestconfig guest-configuration-assignment list

Experimentell

Die Befehlsgruppe "guestconfig guest-configuration-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Listet alle Gastkonfigurationszuweisungen für einen virtuellen Computer auf.

az guestconfig guest-configuration-assignment list --resource-group
                                                   --vm-name

Beispiele

Auflisten aller Gastkonfigurationszuweisungen für einen virtuellen Computer

az guestconfig guest-configuration-assignment list --resource-group "myResourceGroupName" --vm-name "myVMName"

Erforderliche Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--vm-name

Der Name des virtuellen Computers.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az guestconfig guest-configuration-assignment show

Experimentell

Die Befehlsgruppe "guestconfig guest-configuration-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Abrufen von Informationen zu einer Gastkonfigurationszuweisung.

az guestconfig guest-configuration-assignment show [--ids]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--vm-name]

Beispiele

Abrufen einer Gastkonfigurationszuweisung

az guestconfig guest-configuration-assignment show --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Der Name der Gastkonfigurationszuweisung.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--vm-name

Der Name des virtuellen Computers.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az guestconfig guest-configuration-assignment update

Experimentell

Die Befehlsgruppe "guestconfig guest-configuration-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellt eine Zuordnung zwischen einer VM und einer Gastkonfiguration.

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]

Beispiele

Erstellen oder Aktualisieren der Gastkonfigurationszuweisung

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"

Optionale Parameter

--context

Die Quelle, die die Gastkonfigurationszuweisung initiiert hat. Beispiel: Azure-Richtlinie.

--guest-configuration-assignment-name

Name der Gastkonfigurationszuweisung.

--guest-configuration-configuration-parameter

Die Konfigurationsparameter für die Gastkonfiguration.

Verwendung: --guest-configuration-configuration-parameter name=XX value=XX

name: Name des Konfigurationsparameters. wert: Wert des Konfigurationsparameters.

Mehrere Aktionen können mit mehreren Argumenten --guest-configuration-configuration-configuration-parameter angegeben werden.

--guest-configuration-configuration-setting

Die Konfigurationseinstellung für die Gastkonfiguration.

Verwendung: --guest-configuration-setting 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

Konfigurationsmodus: Gibt an, wie der LCM(Local Configuration Manager) die Konfiguration tatsächlich auf die Zielknoten anwendet. Mögliche Werte sind ApplyOnly, ApplyAndMonitor und ApplyAndAutoCorrect. allow-module-overwrite: If true – neue Konfigurationen, die vom Pulldienst heruntergeladen wurden, dürfen die alten im Zielknoten überschreiben. Andernfalls " false action-after-reboot: Gibt an, was nach einem Neustart während der Anwendung einer Konfiguration passiert. Die möglichen Werte sind ContinueConfiguration und StopConfiguration refresh-frequency-min: Das Zeitintervall in Minuten, in dem das LCM einen Pulldienst überprüft, um aktualisierte Konfigurationen abzurufen. Dieser Wert wird ignoriert, wenn der LCM nicht im Pullmodus konfiguriert ist. Der Standardwert ist 30. reboot-if-needed: Set this to true to automatically reboot the node after a configuration that requires reboot is applied. Andernfalls müssen Sie den Knoten für jede Konfiguration manuell neu starten, die dies erfordert. Der Standardwert ist „FALSE“. Um diese Einstellung zu verwenden, wenn eine Neustartbedingung von einer anderen Komponente als von DSC in Kraft gesetzt wird (z.B. Windows Installer), kombinieren Sie diese Einstellung mit dem Modul xPendingReboot. Configuration-mode-frequency-mins: Wie oft, in Minuten, die aktuelle Konfiguration überprüft und angewendet wird. Diese Eigenschaft wird ignoriert, wenn die Eigenschaft ConfigurationMode auf ApplyOnly festgelegt ist. Der Standardwert ist 15.

--guest-configuration-name

Name der Gastkonfiguration.

--guest-configuration-version

Version der Gastkonfiguration.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--latest-assignment-report-assignment

Konfigurationsdetails der Gastkonfigurationszuweisung. Erwarteter Wert: json-string/@json-file.

--location -l

Position Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name

Name der Gastkonfigurationszuweisung.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--vm-name

Der Name des virtuellen Computers.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az guestconfig guest-configuration-assignment wait

Experimentell

Die Befehlsgruppe "guestconfig guest-configuration-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der Guestconfig-Gastkonfigurationszuweisung erfüllt ist.

az guestconfig guest-configuration-assignment wait [--created]
                                                   [--custom]
                                                   [--deleted]
                                                   [--exists]
                                                   [--ids]
                                                   [--interval]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--timeout]
                                                   [--updated]
                                                   [--vm-name]

Beispiele

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die Gastconfig-Gastkonfigurationszuweisung erfolgreich erstellt wurde.

az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --created

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die Gastconfig-Gastkonfigurationszuweisung erfolgreich gelöscht wurde.

az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --deleted

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--interval

Abrufintervall in Sekunden.

Standardwert: 30
--name -n

Der Name der Gastkonfigurationszuweisung.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
--vm-name

Der Name des virtuellen Computers.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.