你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az policy definition

  • 参考

管理资源策略定义。

命令

名称 说明 类型 状态
az policy definition create

创建策略定义。

 核心 GA
az policy definition delete

删除策略定义。

 核心 GA
az policy definition list

列出策略定义。

 核心 GA
az policy definition show

显示策略定义。

 核心 GA
az policy definition update

更新策略定义。

 核心 GA

az policy definition create

编辑

创建策略定义。

az policy definition create --name
                            [--description]
                            [--display-name]
                            [--management-group]
                            [--metadata]
                            [--mode]
                            [--params]
                            [--rules]
                            [--subscription]

示例

创建只读策略。

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

创建策略参数定义。

az policy definition create --name allowedLocations \
    --rules "{ \"if\": { \"allOf\": [ \
        { \"field\": \"location\",\"notIn\": \"[parameters('listOfAllowedLocations')]\" }, \
            { \"field\": \"location\", \"notEquals\": \"global\" }, \
                { \"field\": \"type\", \"notEquals\": \
                    \"Microsoft.AzureActiveDirectory/b2cDirectories\"} \
                        ] }, \"then\": { \"effect\": \"deny\" } }" \
    --params "{ \"allowedLocations\": { \
        \"type\": \"array\", \"metadata\": { \"description\": \
            \"The list of locations that can be specified when deploying resources\", \
                \"strongType\": \"location\", \"displayName\": \"Allowed locations\" } } }"

创建可在管理组中应用的只读策略。

az policy definition create -n readOnlyStorage --management-group "MyManagementGroup" \
    --rules "{ \"if\": { \"field\": \"type\", \
        \"equals\": \"Microsoft.Storage/storageAccounts/write\" }, \
            \"then\": { \"effect\": \"deny\" } }"

使用模式创建策略定义。 模式“Indexed”指示应仅针对支持标记和位置的资源类型评估策略。

az policy definition create --name TagsPolicyDefinition --subscription "MySubscription" \
    --mode Indexed --rules "{ \"if\": { \"field\": \"tags\", \"exists\": \"false\" }, \
        \"then\": { \"effect\": \"deny\" } }"

必需参数

--name -n

新策略定义的名称。

可选参数

--description

策略定义的说明。

--display-name

策略定义的显示名称。

--management-group

可以在其中分配新策略定义的管理组的名称。

--metadata

空格分隔键=值对中的元数据。

--mode -m

策略定义的模式，例如所有索引。 有关详细信息，请访问 https://aka.ms/azure-policy-mode。

--params

JSON 格式的字符串或包含参数定义的文件或 URI 的路径。

--rules

JSON 格式的策略规则，或包含 JSON 规则的文件的路径。

--subscription

可以在其中分配新策略定义的订阅的名称或 ID。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az policy definition delete

编辑

删除策略定义。

az policy definition delete --name
                            [--management-group]
                            [--subscription]

示例

删除策略定义。 （自动生成）

az policy definition delete --name MyPolicyDefinition

必需参数

--name -n

策略定义名称。

可选参数

--management-group

策略 [set] 定义的管理组的名称。 如果策略集的范围限定为管理组，则此参数是必需的。

--subscription

策略 [set] 定义的订阅 ID。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az policy definition list

编辑

列出策略定义。

az policy definition list [--management-group]
                          [--subscription]

可选参数

--management-group

策略 [set] 定义的管理组的名称。 如果策略集的范围限定为管理组，则此参数是必需的。

--subscription

策略 [set] 定义的订阅 ID。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az policy definition show

编辑

显示策略定义。

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

示例

显示策略定义。 （自动生成）

az policy definition show --name MyPolicyDefinition

必需参数

--name -n

策略定义名称。

可选参数

--management-group

策略 [set] 定义的管理组的名称。 如果策略集的范围限定为管理组，则此参数是必需的。

--subscription

策略 [set] 定义的订阅 ID。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az policy definition update

编辑

更新策略定义。

az policy definition update --name
                            [--description]
                            [--display-name]
                            [--management-group]
                            [--metadata]
                            [--mode]
                            [--params]
                            [--rules]
                            [--subscription]

示例

更新策略定义。 （自动生成）

az policy definition update --name MyPolicyDefinition

必需参数

--name -n

策略定义名称。

可选参数

--description

策略定义的说明。

--display-name

策略定义的显示名称。

--management-group

策略 [set] 定义的管理组的名称。 如果策略集的范围限定为管理组，则此参数是必需的。

--metadata

空格分隔键=值对中的元数据。

--mode -m

策略定义的模式，例如所有索引。 有关详细信息，请访问 https://aka.ms/azure-policy-mode。

--params

JSON 格式的字符串或包含参数定义的文件或 URI 的路径。

--rules

JSON 格式的字符串或包含此类内容的文件的路径。

--subscription

策略 [set] 定义的订阅 ID。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
默认值: json
--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。