az guestconfig guest-configuration-assignment

Hinweis

Dieser Verweis ist Teil der Gastconfig-Erweiterung für die Azure CLI (Version 2.3.1 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie zum ersten Mal einen Az guestconfig-gastkonfigurationszuweisungsbefehl ausführen. Weitere Informationen zu Erweiterungen

Gastconfig-Gastkonfigurationszuweisung.

Befehle

az guestconfig guest-configuration-assignment create	Erstellt eine Zuordnung zwischen einer VM und einer Gastkonfiguration.
az guestconfig guest-configuration-assignment delete	Löschen einer Gastkonfigurationszuweisung.
az guestconfig guest-configuration-assignment list	Listet alle Gastkonfigurationszuweisungen für einen virtuellen Computer auf.
az guestconfig guest-configuration-assignment show	Erhalten Sie Informationen zu einer Gastkonfigurationszuweisung.
az guestconfig guest-configuration-assignment update	Erstellt eine Zuordnung zwischen einer VM und einer Gastkonfiguration.
az guestconfig guest-configuration-assignment wait	Platzieren Sie die CLI in einem Wartezeitzustand, bis eine Bedingung der Gastkonfigurationszuweisung erfüllt ist.

az guestconfig guest-configuration-assignment create

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. Ex: Azure Policy.

--guest-configuration-configuration-parameter

Die Konfigurationsparameter für die Gastkonfiguration.

--guest-configuration-configuration-setting

Die Konfigurationseinstellung für die Gastkonfiguration.

--guest-configuration-name

Name der Gastkonfiguration.

--guest-configuration-version

Version der Gastkonfiguration.

--latest-assignment-report-assignment

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

--location -l

Der Standort. 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

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.

--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

Löschen einer Gastkonfigurationszuweisung.

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

Beispiele

Löschen einer Gastkonfigurationszuweisung

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

Erforderliche Parameter

--name -n

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

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

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.

--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

Listet alle Gastkonfigurationszuweisungen für einen virtuellen Computer auf.

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

Beispiele

Alle Gastkonfigurationszuweisungen für einen virtuellen Computer auflisten

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.

--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

Erhalten Sie Informationen zu einer Gastkonfigurationszuweisung.

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

Beispiele

Abrufen einer Gastkonfigurationszuweisung

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

Erforderliche Parameter

--name -n

Der 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.

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.

--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

Erstellt eine Zuordnung zwischen einer VM und einer Gastkonfiguration.

az guestconfig guest-configuration-assignment update --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 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"

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. Ex: Azure Policy.

--guest-configuration-configuration-parameter

Die Konfigurationsparameter für die Gastkonfiguration.

--guest-configuration-configuration-setting

Die Konfigurationseinstellung für die Gastkonfiguration.

--guest-configuration-name

Name der Gastkonfiguration.

--guest-configuration-version

Version der Gastkonfiguration.

--latest-assignment-report-assignment

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

--location -l

Der Standort. 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

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.

--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

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

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

Beispiele

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

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

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

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

Erforderliche Parameter

--name -n

Der 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

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

--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.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600

--updated

Warten Sie, bis sie mit provisioningState unter "Erfolgreich" aktualisiert wurde.

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.

--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.