az guestconfig guest-configuration-hcrp-assignment
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-hcrp-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 guest-configuration-hcrp-assignment.
Befehle
| Name | Beschreibung | Typ | Status |
|---|---|---|---|
| az guestconfig guest-configuration-hcrp-assignment create |
Erstellt eine Zuordnung zwischen einem ARC-Computer und einer Gastkonfiguration. |
Durchwahl | Experimentell |
| az guestconfig guest-configuration-hcrp-assignment delete |
Löschen einer Gastkonfigurationszuweisung. |
Durchwahl | Experimentell |
| az guestconfig guest-configuration-hcrp-assignment list |
Listet alle Gastkonfigurationszuweisungen für einen ARC-Computer auf. |
Durchwahl | Experimentell |
| az guestconfig guest-configuration-hcrp-assignment show |
Abrufen von Informationen zu einer Gastkonfigurationszuweisung. |
Durchwahl | Experimentell |
| az guestconfig guest-configuration-hcrp-assignment update |
Erstellt eine Zuordnung zwischen einem ARC-Computer und einer Gastkonfiguration. |
Durchwahl | Experimentell |
| az guestconfig guest-configuration-hcrp-assignment wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der gastconfig guest-configuration-hcrp-assignment erfüllt ist. |
Durchwahl | Experimentell |
az guestconfig guest-configuration-hcrp-assignment create
Die Befehlsgruppe "guestconfig guest-configuration-hcrp-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Erstellt eine Zuordnung zwischen einem ARC-Computer und einer Gastkonfiguration.
az guestconfig guest-configuration-hcrp-assignment create --guest-configuration-assignment-name
--machine-name
--resource-group
[--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-hcrp-assignment create --guest-configuration-assignment-name "WhitelistedApplication" --machine-name "myMachineName" --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"Erforderliche Parameter
Name der Gastkonfigurationszuweisung.
Der Name des ARC-Computers.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Optionale Parameter
Die Quelle, die die Gastkonfigurationszuweisung initiiert hat. Beispiel: Azure-Richtlinie.
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.
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.
Name der Gastkonfiguration.
Version der Gastkonfiguration.
Konfigurationsdetails der Gastkonfigurationszuweisung. Erwarteter Wert: json-string/@json-file.
Position Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.
Name der Gastkonfigurationszuweisung.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az guestconfig guest-configuration-hcrp-assignment delete
Die Befehlsgruppe "guestconfig guest-configuration-hcrp-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Löschen einer Gastkonfigurationszuweisung.
az guestconfig guest-configuration-hcrp-assignment delete [--guest-configuration-assignment-name]
[--ids]
[--machine-name]
[--no-wait]
[--resource-group]
[--subscription]Beispiele
Löschen einer Gastkonfigurationszuweisung
az guestconfig guest-configuration-hcrp-assignment delete --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName"Optionale Parameter
Name der Gastkonfigurationszuweisung.
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.
Der Name des ARC-Computers.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az guestconfig guest-configuration-hcrp-assignment list
Die Befehlsgruppe "guestconfig guest-configuration-hcrp-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Listet alle Gastkonfigurationszuweisungen für einen ARC-Computer auf.
az guestconfig guest-configuration-hcrp-assignment list --machine-name
--resource-groupBeispiele
Auflisten aller Gastkonfigurationszuweisungen für einen virtuellen Computer
az guestconfig guest-configuration-hcrp-assignment list --machine-name "myMachineName" --resource-group "myResourceGroupName"Erforderliche Parameter
Der Name des ARC-Computers.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az guestconfig guest-configuration-hcrp-assignment show
Die Befehlsgruppe "guestconfig guest-configuration-hcrp-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Abrufen von Informationen zu einer Gastkonfigurationszuweisung.
az guestconfig guest-configuration-hcrp-assignment show [--guest-configuration-assignment-name]
[--ids]
[--machine-name]
[--resource-group]
[--subscription]Beispiele
Abrufen einer Gastkonfigurationszuweisung
az guestconfig guest-configuration-hcrp-assignment show --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName"Optionale Parameter
Der Name der Gastkonfigurationszuweisung.
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.
Der Name des ARC-Computers.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az guestconfig guest-configuration-hcrp-assignment update
Die Befehlsgruppe "guestconfig guest-configuration-hcrp-assignment" ist experimentell und wird entwickelt. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Erstellt eine Zuordnung zwischen einem ARC-Computer und einer Gastkonfiguration.
az guestconfig guest-configuration-hcrp-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]
[--machine-name]
[--name]
[--no-wait]
[--resource-group]
[--subscription]Beispiele
Erstellen oder Aktualisieren der Gastkonfigurationszuweisung
az guestconfig guest-configuration-hcrp-assignment update --guest-configuration-assignment-name "WhitelistedApplication" --machine-name "myMachineName" --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"Optionale Parameter
Die Quelle, die die Gastkonfigurationszuweisung initiiert hat. Beispiel: Azure-Richtlinie.
Name der Gastkonfigurationszuweisung.
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.
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.
Name der Gastkonfiguration.
Version der Gastkonfiguration.
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.
Konfigurationsdetails der Gastkonfigurationszuweisung. Erwarteter Wert: json-string/@json-file.
Position Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.
Der Name des ARC-Computers.
Name der Gastkonfigurationszuweisung.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az guestconfig guest-configuration-hcrp-assignment wait
Die Befehlsgruppe "guestconfig guest-configuration-hcrp-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 gastconfig guest-configuration-hcrp-assignment erfüllt ist.
az guestconfig guest-configuration-hcrp-assignment wait [--created]
[--custom]
[--deleted]
[--exists]
[--guest-configuration-assignment-name]
[--ids]
[--interval]
[--machine-name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]Beispiele
Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die Guestconfig-guest-configuration-hcrp-assignment erfolgreich erstellt wurde.
az guestconfig guest-configuration-hcrp-assignment wait --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName" --createdAnhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die guestconfig guest-configuration-hcrp-assignment erfolgreich gelöscht wurde.
az guestconfig guest-configuration-hcrp-assignment wait --guest-configuration-assignment-name "SecureProtocol" --machine-name "myMachineName" --resource-group "myResourceGroupName" --deletedOptionale Parameter
Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.
Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Warten Sie, bis sie gelöscht wurde.
Warten Sie, bis die Ressource vorhanden ist.
Der Name der Gastkonfigurationszuweisung.
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.
Abrufintervall in Sekunden.
Der Name des ARC-Computers.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Maximale Wartezeit in Sekunden.
Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
