az automation configuration

Note

Эта ссылка является частью расширения automation для Azure CLI (версия 2.75.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az automation configuration. Подробнее о расширениях.

Управление конфигурацией Dsc.

Команды

Имя Описание Тип Состояние
az automation configuration create

Создайте конфигурацию, определяемую по имени конфигурации.

 Extension GA
az automation configuration delete

Удалите конфигурацию dsc, определяемую по имени конфигурации.

 Extension GA
az automation configuration list

Список конфигураций.

 Extension GA
az automation configuration show

Получите конфигурацию, определяемую по имени конфигурации.

 Extension GA
az automation configuration show-content

Получите скрипт конфигурации, определенный по имени конфигурации.

 Extension GA
az automation configuration update

Обновите конфигурацию, определяемую по имени конфигурации.

 Extension GA

az automation configuration create

Создайте конфигурацию, определяемую по имени конфигурации.

az automation configuration create --account --automation-account-name
                                   --configuration-name --name
                                   --resource-group
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--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]

Примеры

Создание конфигурации DSC, которая настраивает сервер

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

Обязательные параметры

--account --automation-account-name

Имя учетной записи службы автоматизации.

--configuration-name --name -n

Параметры создания или обновления конфигурации.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--description

Возвращает или задает описание конфигурации.

Свойство Значение
Группа параметров: Properties Arguments
--location

Возвращает или задает расположение ресурса.

Свойство Значение
Группа параметров: Parameters Arguments
--log-progress

Возвращает или задает параметр журнала выполнения.

Свойство Значение
Группа параметров: Properties Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Возвращает или задает подробный параметр журнала.

Свойство Значение
Группа параметров: Properties Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Возвращает или задает параметры конфигурации. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Properties Arguments
--source

Возвращает или задает значение содержимого. Это основано на типе источника контента.

Свойство Значение
Группа параметров: Source Arguments
--source-hash

Возвращает или задает хэш. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Source Arguments
--source-type

Возвращает или задает тип источника контента.

Свойство Значение
Группа параметров: Source Arguments
Допустимые значения: embeddedContent, uri
--source-version

Возвращает или задает версию содержимого.

Свойство Значение
Группа параметров: Source Arguments
--tags

Возвращает или задает теги, подключенные к ресурсу. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Parameters Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az automation configuration delete

Удалите конфигурацию dsc, определяемую по имени конфигурации.

az automation configuration delete [--account --automation-account-name]
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--configuration-name --name]
                                   [--ids]
                                   [--resource-group]
                                   [--subscription]
                                   [--yes]

Примеры

Удаление конфигурации DSC

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--account --automation-account-name

Имя учетной записи службы автоматизации.

Свойство Значение
Группа параметров: Resource Id Arguments
--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--configuration-name --name -n

Имя конфигурации.

Свойство Значение
Группа параметров: Resource Id Arguments
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
--yes -y

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az automation configuration list

Список конфигураций.

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

Примеры

Список всех конфигураций DSC

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

Обязательные параметры

--account --automation-account-name

Имя учетной записи службы автоматизации.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--filter

Фильтр, применяемый к операции.

--inlinecount

Возврат общих строк.

--max-items

Общее количество элементов, возвращаемых в выходных данных команды. Если общее количество доступных элементов превышает указанное значение, маркер предоставляется в выходных данных команды. Чтобы возобновить разбиение на страницы, укажите значение маркера в --next-token аргументе последующей команды.

Свойство Значение
Группа параметров: Pagination Arguments
--next-token

Маркер, чтобы указать, где начать разбиение на страницы. Это значение маркера из ранее усеченного ответа.

Свойство Значение
Группа параметров: Pagination Arguments
--skip

Количество пропустить строк.

--top

Количество строк, которые требуется принять.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az automation configuration show

Получите конфигурацию, определяемую по имени конфигурации.

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

Примеры

Получение конфигурации по имени

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--account --automation-account-name

Имя учетной записи службы автоматизации.

Свойство Значение
Группа параметров: Resource Id Arguments
--configuration-name --name -n

Имя конфигурации.

Свойство Значение
Группа параметров: Resource Id Arguments
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az automation configuration show-content

Получите скрипт конфигурации, определенный по имени конфигурации.

az automation configuration show-content [--account --automation-account-name]
                                         [--acquire-policy-token]
                                         [--change-reference]
                                         [--configuration-name --name]
                                         [--ids]
                                         [--resource-group]
                                         [--subscription]

Примеры

Отображение содержимого скрипта конфигурации DSC

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

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--account --automation-account-name

Имя учетной записи службы автоматизации.

Свойство Значение
Группа параметров: Resource Id Arguments
--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--configuration-name --name -n

Имя конфигурации.

Свойство Значение
Группа параметров: Resource Id Arguments
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az automation configuration update

Обновите конфигурацию, определяемую по имени конфигурации.

az automation configuration update [--account --automation-account-name]
                                   [--acquire-policy-token]
                                   [--add]
                                   [--change-reference]
                                   [--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]

Примеры

Обновление скрипта в конфигурации 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"
}
}
}"

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--account --automation-account-name

Имя учетной записи службы автоматизации.

Свойство Значение
Группа параметров: Resource Id Arguments
--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string or JSON string>.

Свойство Значение
Группа параметров: Generic Update Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--configuration-name --name -n

Имя конфигурации.

Свойство Значение
Группа параметров: Resource Id Arguments
--description

Возвращает или задает описание конфигурации.

Свойство Значение
Группа параметров: Properties Arguments
--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

Свойство Значение
Группа параметров: Generic Update Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--location

Возвращает или задает расположение ресурса.

Свойство Значение
Группа параметров: Parameters Arguments
--log-progress

Возвращает или задает параметр журнала выполнения.

Свойство Значение
Группа параметров: Properties Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--log-verbose

Возвращает или задает подробный параметр журнала.

Свойство Значение
Группа параметров: Properties Arguments
Допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--parameters

Возвращает или задает параметры конфигурации. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Properties Arguments
--remove

Удалите свойство или элемент из списка. Пример: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Свойство Значение
Группа параметров: Generic Update Arguments
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=<value>.

Свойство Значение
Группа параметров: Generic Update Arguments
--source

Возвращает или задает значение содержимого. Это основано на типе источника контента.

Свойство Значение
Группа параметров: Source Arguments
--source-hash

Возвращает или задает хэш. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Source Arguments
--source-type

Возвращает или задает тип источника контента.

Свойство Значение
Группа параметров: Source Arguments
Допустимые значения: embeddedContent, uri
--source-version

Возвращает или задает версию содержимого.

Свойство Значение
Группа параметров: Source Arguments
--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
--tags

Возвращает или задает теги, подключенные к ресурсу. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Parameters Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False