az automation configuration

Referenz

Hinweis

Diese Referenz ist Teil der Automatisierungserweiterung für die Azure CLI (Version 2.55.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az-Automatisierungskonfigurationsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten der Dsc-Konfiguration.

Befehle

Name	Beschreibung	Typ	Status
az automation configuration create	Erstellen Sie die durch den Konfigurationsnamen identifizierte Konfiguration.	Erweiterung	Allgemein verfügbar
az automation configuration delete	Löschen Sie die durch den Konfigurationsnamen identifizierte dsc-Konfiguration.	Erweiterung	Allgemein verfügbar
az automation configuration list	Liste der Konfigurationen auf.	Erweiterung	Allgemein verfügbar
az automation configuration show	Rufen Sie die durch den Konfigurationsnamen identifizierte Konfiguration ab.	Erweiterung	Allgemein verfügbar
az automation configuration show-content	Rufen Sie das vom Konfigurationsnamen identifizierte Konfigurationsskript ab.	Erweiterung	Allgemein verfügbar
az automation configuration update	Aktualisieren Sie die durch den Konfigurationsnamen identifizierte Konfiguration.	Erweiterung	Allgemein verfügbar

az automation configuration create

Erstellen Sie die durch den Konfigurationsnamen identifizierte Konfiguration.

az automation configuration create --account
                                   --configuration-name
                                   --resource-group
                                   [--description]
                                   [--location]
                                   [--log-progress {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--log-verbose {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--parameters]
                                   [--source]
                                   [--source-hash]
                                   [--source-type {embeddedContent, uri}]
                                   [--source-version]
                                   [--tags]

Beispiele

Erstellen einer DSC-Konfiguration, die einen Server eingerichtet

az automation configuration create -g rg --automation-account-name myAutomationAccount -n SetupServer --location westus2 --source-type embeddedContent --source "Configuration SetupServer {
Node localhost {
WindowsFeature IIS {
Name = "Web-Server";
Ensure = "Present"
}
}
}"

Erforderliche Parameter

--account --automation-account-name

Der Name des Automatisierungskontos.

--configuration-name --name -n

Die Erstellungs- oder Aktualisierungsparameter für die Konfiguration.

--resource-group -g

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

Optionale Parameter

--description

Ruft die Beschreibung der Konfiguration ab oder legt sie fest.

--location

Ruft den Speicherort der Ressource ab oder legt ihn fest.

--log-progress

Ruft die Statusprotokolloption ab oder legt sie fest.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes

--log-verbose

Ruft die ausführliche Protokolloption ab oder legt sie fest.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes

--parameters

Ruft die Konfigurationsparameter ab oder legt sie fest. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--source

Dient zum Abrufen oder Festlegen des Werts des Inhalts. Dies basiert auf dem Inhaltsquellentyp.

--source-hash

Ruft den Hash ab oder legt den Hash fest. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--source-type

Dient zum Abrufen oder Festlegen des Inhaltsquellentyps.

Zulässige Werte: embeddedContent, uri

--source-version

Ruft die Version des Inhalts ab oder legt sie fest.

--tags

Ruft die tags ab, die der Ressource zugeordnet sind, oder legt sie fest. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

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 automation configuration delete

Löschen Sie die durch den Konfigurationsnamen identifizierte dsc-Konfiguration.

az automation configuration delete [--account]
                                   [--configuration-name]
                                   [--ids]
                                   [--resource-group]
                                   [--subscription]
                                   [--yes]

Beispiele

Löschen der DSC-Konfiguration

az automation configuration list -g rg --automation-account-name myAutomationAccount

Optionale Parameter

--account --automation-account-name

Der Name des Automatisierungskontos.

--configuration-name --name -n

Der Konfigurationsname.

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

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

--yes -y

Nicht zur Bestätigung auffordern

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 automation configuration list

Liste der Konfigurationen auf.

az automation configuration list --account
                                 --resource-group
                                 [--filter]
                                 [--inlinecount]
                                 [--max-items]
                                 [--next-token]
                                 [--skip]
                                 [--top]

Beispiele

Alle DSC-Konfigurationen auflisten

az automation configuration list -g rg --automation-account-name myAutomationAccount

Erforderliche Parameter

--account --automation-account-name

Der Name des Automatisierungskontos.

--resource-group -g

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

Optionale Parameter

--filter

Der auf den Vorgang anzuwendende Filter.

--inlinecount

Ergebniszeilen zurückgeben.

--max-items

Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtanzahl der verfügbaren Elemente größer als der angegebene Wert ist, wird ein Token in der Ausgabe des Befehls bereitgestellt. Um die Paginierung fortzusetzen, geben Sie den Tokenwert im --next-token Argument eines nachfolgenden Befehls an.

--next-token

Token, das angibt, wo die Paginierung beginnen soll. Dies ist der Tokenwert aus einer zuvor abgeschnittenen Antwort.

--skip

Die Anzahl der zu überspringenden Zeilen.

--top

Die Anzahl der zu übernehmenden Zeilen.

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 automation configuration show

Rufen Sie die durch den Konfigurationsnamen identifizierte Konfiguration ab.

az automation configuration show [--account]
                                 [--configuration-name]
                                 [--ids]
                                 [--resource-group]
                                 [--subscription]

Beispiele

Abrufen der Konfiguration anhand des Namens

az automation configuration show -g rg --automation-account-name myAutomationAccount -n SetupServer

Optionale Parameter

--account --automation-account-name

Der Name des Automatisierungskontos.

--configuration-name --name -n

Der Konfigurationsname.

--ids

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

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 automation configuration show-content

Rufen Sie das vom Konfigurationsnamen identifizierte Konfigurationsskript ab.

az automation configuration show-content [--account]
                                         [--configuration-name]
                                         [--ids]
                                         [--resource-group]
                                         [--subscription]

Beispiele

Anzeigen des Skriptinhalts der DSC-Konfiguration

az automation configuration show-content -g rg --automation-account-name myAutomationAccount -n SetupServer

Optionale Parameter

--account --automation-account-name

Der Name des Automatisierungskontos.

--configuration-name --name -n

Der Konfigurationsname.

--ids

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

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 automation configuration update

Aktualisieren Sie die durch den Konfigurationsnamen identifizierte Konfiguration.

az automation configuration update [--account]
                                   [--add]
                                   [--configuration-name]
                                   [--description]
                                   [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--ids]
                                   [--location]
                                   [--log-progress {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--log-verbose {0, 1, f, false, n, no, t, true, y, yes}]
                                   [--parameters]
                                   [--remove]
                                   [--resource-group]
                                   [--set]
                                   [--source]
                                   [--source-hash]
                                   [--source-type {embeddedContent, uri}]
                                   [--source-version]
                                   [--subscription]
                                   [--tags]

Beispiele

Aktualisieren des Skripts in der DSC-Konfiguration

az automation configuration update -g rg --automation-account-name myAutomationAccount -n SetupServer --location westus2 --source-type embeddedContent --source "Configuration SetupServer {
Node localhostServer {
WindowsFeature IIS {
Name = "Web-Server";
Ensure = "Present"
}
}
}"

Optionale Parameter

--account --automation-account-name

Der Name des Automatisierungskontos.

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--configuration-name --name -n

Der Konfigurationsname.

--description

Ruft die Beschreibung der Konfiguration ab oder legt sie fest.

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes

--ids

--location

Ruft den Speicherort der Ressource ab oder legt ihn fest.

--log-progress

Ruft die Statusprotokolloption ab oder legt sie fest.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes

--log-verbose

Ruft die ausführliche Protokolloption ab oder legt sie fest.

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes

--parameters

Ruft die Konfigurationsparameter ab oder legt sie fest. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=.

--source

Dient zum Abrufen oder Festlegen des Werts des Inhalts. Dies basiert auf dem Inhaltsquellentyp.

--source-hash

Ruft den Hash ab oder legt den Hash fest. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--source-type

Dient zum Abrufen oder Festlegen des Inhaltsquellentyps.

Zulässige Werte: embeddedContent, uri

--source-version

Ruft die Version des Inhalts ab oder legt sie fest.

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

--tags

Ruft die tags ab, die der Ressource zugeordnet sind, oder legt sie fest. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

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.

Freigeben über

az automation configuration

Befehle

az automation configuration create

Beispiele

Erforderliche Parameter

Optionale Parameter

az automation configuration delete

Beispiele

Optionale Parameter

az automation configuration list

Beispiele

Erforderliche Parameter

Optionale Parameter

az automation configuration show

Beispiele

Optionale Parameter

az automation configuration show-content

Beispiele

Optionale Parameter

az automation configuration update

Beispiele

Optionale Parameter

Zusätzliche Ressourcen