Udostępnij przez

az automation configuration

Note

Ta dokumentacja jest częścią rozszerzenia automatyzacji dla interfejsu wiersza polecenia platformy Azure (wersja 2.55.0 lub nowsza). Rozszerzenie zostanie automatycznie zainstalowane przy pierwszym uruchomieniu polecenia az automation configuration. Dowiedz się więcej o rozszerzeniach.

Zarządzanie konfiguracją dsc.

Polecenia

Nazwa Opis Typ Stan
az automation configuration create

Utwórz konfigurację zidentyfikowaną przez nazwę konfiguracji.

 Extension ogólna dostępność
az automation configuration delete

Usuń konfigurację dsc zidentyfikowaną przez nazwę konfiguracji.

 Extension ogólna dostępność
az automation configuration list

Lista konfiguracji.

 Extension ogólna dostępność
az automation configuration show

Pobierz konfigurację zidentyfikowaną przez nazwę konfiguracji.

 Extension ogólna dostępność
az automation configuration show-content

Pobierz skrypt konfiguracji zidentyfikowany przez nazwę konfiguracji.

 Extension ogólna dostępność
az automation configuration update

Zaktualizuj konfigurację zidentyfikowaną przez nazwę konfiguracji.

 Extension ogólna dostępność

az automation configuration create

Utwórz konfigurację zidentyfikowaną przez nazwę konfiguracji.

az automation configuration create --account --automation-account-name
                                   --configuration-name --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]

Przykłady

Tworzenie konfiguracji DSC, która konfiguruje serwer

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

Parametry wymagane

--account --automation-account-name

Nazwa konta usługi Automation.

--configuration-name --name -n

Parametry tworzenia lub aktualizowania konfiguracji.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--description

Pobiera lub ustawia opis konfiguracji.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--location

Pobiera lub ustawia lokalizację zasobu.

Właściwość Wartość
Grupa parametrów: Parameters Arguments
--log-progress

Pobiera lub ustawia opcję dziennika postępu.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Pobiera lub ustawia opcję pełnego dziennika.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Pobiera lub ustawia parametry konfiguracji. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--source

Pobiera lub ustawia wartość zawartości. Jest to oparte na typie źródła zawartości.

Właściwość Wartość
Grupa parametrów: Source Arguments
--source-hash

Pobiera lub ustawia skrót. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: Source Arguments
--source-type

Pobiera lub ustawia typ źródła zawartości.

Właściwość Wartość
Grupa parametrów: Source Arguments
Dopuszczalne wartości: embeddedContent, uri
--source-version

Pobiera lub ustawia wersję zawartości.

Właściwość Wartość
Grupa parametrów: Source Arguments
--tags

Pobiera lub ustawia tagi dołączone do zasobu. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: Parameters Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az automation configuration delete

Usuń konfigurację dsc zidentyfikowaną przez nazwę konfiguracji.

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

Przykłady

Usuwanie konfiguracji DSC

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account --automation-account-name

Nazwa konta usługi Automation.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--configuration-name --name -n

Nazwa konfiguracji.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--yes -y

Nie monituj o potwierdzenie.

Właściwość Wartość
Domyślna wartość: False
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az automation configuration list

Lista konfiguracji.

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

Przykłady

Wyświetlanie listy wszystkich konfiguracji DSC

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

Parametry wymagane

--account --automation-account-name

Nazwa konta usługi Automation.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--filter

Filtr do zastosowania w operacji.

--inlinecount

Zwraca łączną liczbę wierszy.

--max-items

Łączna liczba elementów do zwrócenia w danych wyjściowych polecenia. Jeśli łączna liczba dostępnych elementów jest większa niż określona wartość, token jest udostępniany w danych wyjściowych polecenia. Aby wznowić stronicowanie, podaj wartość tokenu w --next-token argumentu kolejnego polecenia.

Właściwość Wartość
Grupa parametrów: Pagination Arguments
--next-token

Token do określenia, gdzie rozpocząć stronicowanie. Jest to wartość tokenu z wcześniej obciętej odpowiedzi.

Właściwość Wartość
Grupa parametrów: Pagination Arguments
--skip

Liczba wierszy do pominięcia.

--top

Liczba wierszy do wykonania.

Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az automation configuration show

Pobierz konfigurację zidentyfikowaną przez nazwę konfiguracji.

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

Przykłady

Pobieranie konfiguracji według jej nazwy

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account --automation-account-name

Nazwa konta usługi Automation.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--configuration-name --name -n

Nazwa konfiguracji.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az automation configuration show-content

Pobierz skrypt konfiguracji zidentyfikowany przez nazwę konfiguracji.

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

Przykłady

Pokaż zawartość skryptu konfiguracji DSC

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account --automation-account-name

Nazwa konta usługi Automation.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--configuration-name --name -n

Nazwa konfiguracji.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False

az automation configuration update

Zaktualizuj konfigurację zidentyfikowaną przez nazwę konfiguracji.

az automation configuration update [--account --automation-account-name]
                                   [--add]
                                   [--configuration-name --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]

Przykłady

Aktualizowanie skryptu w konfiguracji DSC

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

Parametry opcjonalne

Poniższe parametry są opcjonalne, ale w zależności od kontekstu co najmniej jeden może być wymagany do pomyślnego wykonania polecenia.

--account --automation-account-name

Nazwa konta usługi Automation.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--add

Dodaj obiekt do listy obiektów, określając pary ścieżki i wartości klucza. Przykład: --add property.listProperty <key=value, string or JSON string>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
--configuration-name --name -n

Nazwa konfiguracji.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--description

Pobiera lub ustawia opis konfiguracji.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--force-string

W przypadku używania polecenia "set" lub "add" zachowaj literały ciągu zamiast próbować konwertować na format JSON.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacjami). Powinien to być kompletny identyfikator zasobu, zawierający wszystkie informacje dotyczące argumentów „Identyfikator zasobu”. Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--location

Pobiera lub ustawia lokalizację zasobu.

Właściwość Wartość
Grupa parametrów: Parameters Arguments
--log-progress

Pobiera lub ustawia opcję dziennika postępu.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Pobiera lub ustawia opcję pełnego dziennika.

Właściwość Wartość
Grupa parametrów: Properties Arguments
Dopuszczalne wartości: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Pobiera lub ustawia parametry konfiguracji. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: Properties Arguments
--remove

Usuń właściwość lub element z listy. Przykład: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu az configure --defaults group=<name>.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--set

Zaktualizuj obiekt, określając ścieżkę właściwości i wartość do ustawienia. Przykład: --set property1.property2=<value>.

Właściwość Wartość
Grupa parametrów: Generic Update Arguments
--source

Pobiera lub ustawia wartość zawartości. Jest to oparte na typie źródła zawartości.

Właściwość Wartość
Grupa parametrów: Source Arguments
--source-hash

Pobiera lub ustawia skrót. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: Source Arguments
--source-type

Pobiera lub ustawia typ źródła zawartości.

Właściwość Wartość
Grupa parametrów: Source Arguments
Dopuszczalne wartości: embeddedContent, uri
--source-version

Pobiera lub ustawia wersję zawartości.

Właściwość Wartość
Grupa parametrów: Source Arguments
--subscription

Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Właściwość Wartość
Grupa parametrów: Resource Id Arguments
--tags

Pobiera lub ustawia tagi dołączone do zasobu. Obsługa skróconej składni, pliku json-file i yaml-file. Spróbuj "??", aby pokazać więcej.

Właściwość Wartość
Grupa parametrów: Parameters Arguments
Parametry globalne
--debug

Zwiększ szczegółowość rejestrowania, aby wyświetlić wszystkie dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False
--help -h

Pokaż ten komunikat pomocy i zakończ pracę.

--only-show-errors

Pokaż tylko błędy, pomijając ostrzeżenia.

Właściwość Wartość
Domyślna wartość: False
--output -o

Format danych wyjściowych.

Właściwość Wartość
Domyślna wartość: json
Dopuszczalne wartości: json, jsonc, none, table, tsv, yaml, yamlc
--query

Ciąg zapytania JMESPath. Zobacz http://jmespath.org/ , aby uzyskać więcej informacji i przykładów.

--verbose

Zwiększ szczegółowość rejestrowania. Użyj --debuguj, aby uzyskać pełne dzienniki debugowania.

Właściwość Wartość
Domyślna wartość: False