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

Microsoft.PolicyInsights 修正

• 最新
• 2021-10-01
• 2019-07-01
• 2018-07-01-preview

Bicep 资源定义

修正资源类型是 扩展资源，这意味着你可以将其应用于另一个资源。

scope使用此资源上的 属性可设置此资源的范围。 请参阅 在 Bicep 中设置扩展资源的范围。

修正资源的有效部署范围包括：

• 资源组 - 请参阅 资源组部署命令
• 订阅 - 请参阅 订阅部署命令
• 管理组 - 请参阅 管理组部署命令

有关每个 API 版本中更改的属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.PolicyInsights/remediations 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.PolicyInsights/remediations@2021-10-01' = {
  name: 'string'
  scope: resourceSymbolicName
  properties: {
    failureThreshold: {
      percentage: int
    }
    filters: {
      locations: [
        'string'
      ]
    }
    parallelDeployments: int
    policyAssignmentId: 'string'
    policyDefinitionReferenceId: 'string'
    resourceCount: int
    resourceDiscoveryMode: 'string'
  }
}

属性值

remediations

名称	说明	Value
name	资源名称	字符串 (必需)
scope	在与部署范围不同的范围创建扩展资源时使用 。	目标资源 对于 Bicep，请将此属性设置为资源的符号名称以应用 扩展资源。
properties	修正的属性。	RemediationProperties

RemediationProperties

名称	说明	Value
failureThreshold	修正失败阈值设置	RemediationPropertiesFailureThreshold
筛选器	将应用于确定要修正的资源的筛选器。	RemediationFilters
parallelDeployments	确定在任何给定时间要修正的资源数。 可用于增加或减少修正的步伐。 如果未提供，则使用默认的并行部署值。	int
policyAssignmentId	应修正的策略分配的资源 ID。	字符串
policyDefinitionReferenceId	应修正的单个定义的策略定义引用 ID。 当正在修正的策略分配分配策略集定义时是必需的。	字符串
resourceCount	确定修正作业可以修正的最大资源数。 如果未提供，则使用默认资源计数。	int
resourceDiscoveryMode	发现要修正的资源的方式。 如果未指定，则默认为 ExistingNonCompliant。	“ExistingNonCompliant” “ReEvaluateCompliance”

RemediationPropertiesFailureThreshold

名称	说明	Value
percentage	一个介于 0.0 到 1.0 之间的数字，表示失败百分比阈值。 如果失败的修正操作百分比 (即失败的部署) 超过此阈值，则修正将失败。	int

RemediationFilters

名称	说明	Value
locations	要修正的资源位置。	string[]

ARM 模板资源定义

修正资源类型是 扩展资源，这意味着你可以将其应用于另一个资源。

scope使用此资源上的 属性可设置此资源的范围。 请参阅 在 ARM 模板中设置扩展资源的范围。

修正资源的有效部署范围包括：

• 资源组 - 请参阅 资源组部署命令
• 订阅 - 请参阅 订阅部署命令
• 管理组 - 请参阅 管理组部署命令

有关每个 API 版本中更改的属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.PolicyInsights/remediations 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.PolicyInsights/remediations",
  "apiVersion": "2021-10-01",
  "name": "string",
  "scope": "string",
  "properties": {
    "failureThreshold": {
      "percentage": "int"
    },
    "filters": {
      "locations": [ "string" ]
    },
    "parallelDeployments": "int",
    "policyAssignmentId": "string",
    "policyDefinitionReferenceId": "string",
    "resourceCount": "int",
    "resourceDiscoveryMode": "string"
  }
}

属性值

remediations

名称	说明	Value
type	资源类型	“Microsoft.PolicyInsights/remediations”
apiVersion	资源 API 版本	'2021-10-01'
name	资源名称	字符串 (必需)
scope	在与部署范围不同的范围创建扩展资源时使用 。	目标资源 对于 JSON，请将值设置为要向其应用 扩展资源 的资源的全名。
properties	修正的属性。	RemediationProperties

RemediationProperties

名称	说明	Value
failureThreshold	修正失败阈值设置	RemediationPropertiesFailureThreshold
筛选器	将应用于确定要修正的资源的筛选器。	RemediationFilters
parallelDeployments	确定在任何给定时间要修正的资源数。 可用于增加或减少修正的步伐。 如果未提供，则使用默认的并行部署值。	int
policyAssignmentId	应修正的策略分配的资源 ID。	字符串
policyDefinitionReferenceId	应修正的单个定义的策略定义引用 ID。 当正在修正的策略分配分配策略集定义时是必需的。	字符串
resourceCount	确定修正作业可以修正的最大资源数。 如果未提供，则使用默认资源计数。	int
resourceDiscoveryMode	发现要修正的资源的方式。 如果未指定，则默认为 ExistingNonCompliant。	“ExistingNonCompliant” “ReEvaluateCompliance”

RemediationPropertiesFailureThreshold

名称	说明	Value
percentage	一个介于 0.0 到 1.0 之间的数字，表示失败百分比阈值。 如果失败的修正操作百分比 (即失败的部署) 超过此阈值，则修正将失败。	int

RemediationFilters

名称	说明	Value
locations	要修正的资源位置。	string[]

Terraform (AzAPI 提供程序) 资源定义

修正资源类型是 扩展资源，这意味着你可以将其应用于另一个资源。

parent_id使用此资源上的 属性可设置此资源的范围。

修正资源的有效部署范围包括：

• 资源组
• 订阅
• 管理组

有关每个 API 版本中更改的属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.PolicyInsights/remediations 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.PolicyInsights/remediations@2021-10-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      failureThreshold = {
        percentage = int
      }
      filters = {
        locations = [
          "string"
        ]
      }
      parallelDeployments = int
      policyAssignmentId = "string"
      policyDefinitionReferenceId = "string"
      resourceCount = int
      resourceDiscoveryMode = "string"
    }
  })
}

属性值

remediations

名称	说明	Value
type	资源类型	“Microsoft.PolicyInsights/remediations@2021-10-01”
name	资源名称	字符串 (必需)
parent_id	要向其应用此扩展资源的资源的 ID。	字符串 (必需)
properties	修正的属性。	RemediationProperties

RemediationProperties

名称	说明	Value
failureThreshold	修正失败阈值设置	RemediationPropertiesFailureThreshold
筛选器	将应用于确定要修正的资源的筛选器。	RemediationFilters
parallelDeployments	确定在任何给定时间要修正的资源数。 可用于增加或减少修正的步伐。 如果未提供，则使用默认的并行部署值。	int
policyAssignmentId	应修正的策略分配的资源 ID。	字符串
policyDefinitionReferenceId	应修正的单个定义的策略定义引用 ID。 当正在修正的策略分配分配策略集定义时是必需的。	字符串
resourceCount	确定修正作业可以修正的最大资源数。 如果未提供，则使用默认资源计数。	int
resourceDiscoveryMode	发现要修正的资源的方式。 如果未指定，则默认为 ExistingNonCompliant。	“ExistingNonCompliant” “ReEvaluateCompliance”

RemediationPropertiesFailureThreshold

名称	说明	Value
percentage	一个介于 0.0 到 1.0 之间的数字，表示失败百分比阈值。 如果失败的修正操作百分比 (即失败的部署) 超过此阈值，则修正将失败。	int

RemediationFilters

名称	说明	Value
locations	要修正的资源位置。	string[]