az policy definition version

Управление версиями определений политики.

Версии определения политики представляют различные итерации определения политики, что позволяет отслеживать и применять изменения в управляемом и прогнозируемом способе.

Команды

Имя Описание Тип Состояние
az policy definition version create

Создайте версию определения политики.

 Core GA
az policy definition version delete

Удалите версию определения политики.

 Core GA
az policy definition version list

Получение версий определений политики.

 Core GA
az policy definition version show

Извлекает версию определения политики.

 Core GA
az policy definition version update

Обновление версии определения политики.

 Core GA

az policy definition version create

Изменить

Создайте версию определения политики.

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

az policy definition version create --name
                                    --version
                                    [--acquire-policy-token]
                                    [--change-reference]
                                    [--description]
                                    [--display-name]
                                    [--external-evaluation-enforcement-settings --external-settings]
                                    [--management-group]
                                    [--metadata]
                                    [--mode]
                                    [--params]
                                    [--rule --rules]

Примеры

Создание определения политики с более старой версией

az policy definition version create --name readOnlyStorage --rules "{ 'if': { 'field': 'type', 'equals': 'Microsoft.Storage/storageAccounts/write' }, 'then': { 'effect': 'deny' } }" --version 1.1.0

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

--name -n

Имя определения политики.

--version

Версия определения политики.

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

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

--acquire-policy-token

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

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

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

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

Описание определения политики.

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

Отображаемое имя определения политики.

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

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

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

Группа управления.

--metadata

Метаданные определения политики. Поддержка сокращенного синтаксиса (только полного значения), json-file и yaml-file.

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

Режим определения политики.

Свойство Значение
Группа параметров: Properties Arguments
Значение по умолчанию: Indexed
--params -p

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

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

Правило политики. Поддержка сокращенного синтаксиса (только полного значения), json-file и yaml-file.

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

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

Свойство Значение
Значение по умолчанию: False
--help -h

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

--only-show-errors

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

Свойство Значение
Значение по умолчанию: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Значение по умолчанию: False

az policy definition version delete

Изменить

Удалите версию определения политики.

Удалите версию определения политики в данной подписке или группе управления с заданным именем и другими свойствами.

az policy definition version delete --name
                                    --version
                                    [--acquire-policy-token]
                                    [--change-reference]
                                    [--management-group]
                                    [--yes]

Примеры

Удаление версии определения политики

az policy definition version delete --name ResourceNaming --version 1.2.1

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

--name -n

Имя определения политики.

--version

Версия определения политики.

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

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

--acquire-policy-token

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

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

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

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

Группа управления.

--yes -y

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

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

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

Свойство Значение
Значение по умолчанию: False
--help -h

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

--only-show-errors

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

Свойство Значение
Значение по умолчанию: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Значение по умолчанию: False

az policy definition version list

Изменить

Получение версий определений политики.

Извлеките список всех версий определений политик для определения политики в заданной подписке или группе управления.

az policy definition version list --name
                                  [--management-group]
                                  [--max-items]
                                  [--next-token]
                                  [--top]

Примеры

Вывод списка версий определений политики по подписке

az policy definition version list --name ResourceNaming

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

--name -n

Имя определения политики.

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

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

--management-group

Группа управления.

--max-items

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

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

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

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

Максимальное количество возвращаемых записей. Если фильтр $top не указан, он вернет 500 записей.

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

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

Свойство Значение
Значение по умолчанию: False
--help -h

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

--only-show-errors

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

Свойство Значение
Значение по умолчанию: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Значение по умолчанию: False

az policy definition version show

Изменить

Извлекает версию определения политики.

Получение и отображение сведений о версии определения политики в данной подписке или группе управления с заданным именем и версией.

az policy definition version show --name
                                  --version
                                  [--management-group]

Примеры

Получение версии определения политики

az policy definition version show --name ResourceNaming --version 1.2.1

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

--name -n

Имя определения политики.

--version

Версия определения политики.

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

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

--management-group

Группа управления.

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

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

Свойство Значение
Значение по умолчанию: False
--help -h

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

--only-show-errors

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

Свойство Значение
Значение по умолчанию: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Значение по умолчанию: False

az policy definition version update

Изменить

Обновление версии определения политики.

Обновите версию определения политики в данной подписке или группе управления с заданным именем и версией, применяя указанные свойства.

az policy definition version update --name
                                    --version
                                    [--acquire-policy-token]
                                    [--add]
                                    [--change-reference]
                                    [--description]
                                    [--display-name]
                                    [--external-evaluation-enforcement-settings --external-settings]
                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--management-group]
                                    [--metadata]
                                    [--mode]
                                    [--params]
                                    [--remove]
                                    [--rule --rules]
                                    [--set]

Примеры

Обновление версии определения политики

az policy definition version update -n readOnlyStorage --display-name "Updated display name goes here"

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

--name -n

Имя определения политики.

--version

Версия определения политики.

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

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

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

Описание определения политики.

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

Отображаемое имя определения политики.

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

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

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

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

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

Группа управления.

--metadata

Метаданные определения политики. Поддержка сокращенного синтаксиса (только полного значения), json-file и yaml-file.

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

Режим определения политики.

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

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

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

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

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

Правило политики. Поддержка сокращенного синтаксиса (только полного значения), json-file и yaml-file.

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

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

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

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

Свойство Значение
Значение по умолчанию: False
--help -h

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

--only-show-errors

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

Свойство Значение
Значение по умолчанию: False
--output -o

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

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

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

--subscription

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

--verbose

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

Свойство Значение
Значение по умолчанию: False