معالجة Microsoft.PolicyInsights

• أحدث
• 2024-10-01
• 2021-10-01
• 2019-07-01
• معاينة 2018-07-01

تعريف مورد Bicep

يمكن نشر نوع مورد المعالجات مع العمليات التي تستهدف:

• المستأجر - راجع أوامر * مجموعات الإدارة - انظر أوامر* نشر مجموعة الإدارةالاشتراك - انظر أوامر* نشر الاشتراكمجموعات الموارد - انظر أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.PolicyInsights/remediations، أضف Bicep التالي إلى القالب الخاص بك.

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

قيم الخصائص

Microsoft.PolicyInsights/remediations

اسم	وصف	قيمة
اسم	اسم المورد	سلسلة (مطلوب)
خصائص	خصائص المعالجة.	معالجة الخصائص
نطاق	استخدم عند إنشاء مورد في نطاق مختلف عن نطاق النشر.	قم بتعيين هذه الخاصية إلى الاسم الرمزي لمورد لتطبيق مورد ملحق .

عوامل تصفية المعالجة

اسم	وصف	قيمة
مواقع	مواقع الموارد التي سيتم معالجتها.	سلسلة[]
معرفات الموارد	معرفات الموارد التي سيتم معالجتها. يمكن تحديد 100 معرف على الأكثر. لا يمكن استخدام عامل التصفية هذا عند تعيين ReEvaluateCompliance إلى ReEvaluateCompliance، ولا يمكن أن يكون فارغا إذا تم توفيره.	سلسلة[]

خصائص المعالجة

اسم	وصف	قيمة
فشلالعناد	إعدادات عتبة فشل المعالجة	RemediationPropertiesFailureThreshold
مرشحات	عوامل التصفية التي سيتم تطبيقها لتحديد الموارد التي يجب معالجتها.	RemediationFilters
عمليات التوزيع المتوازية	تحديد عدد الموارد التي يجب إصلاحها في أي وقت. يمكن استخدامها لزيادة أو تقليل وتيرة المعالجة. إذا لم يتم توفيرها، يتم استخدام قيمة عمليات النشر المتوازية الافتراضية.	الباحث
معرف تعيين النهج	معرف المورد لتعيين النهج الذي يجب معالجته.	خيط
policyDefinitionReferenceId	معرف مرجع تعريف النهج للتعريف الفردي الذي يجب معالجته. مطلوب عندما يقوم تعيين النهج الذي تتم معالجته بتعيين تعريف مجموعة نهج.	خيط
عدد الموارد	تحديد الحد الأقصى لعدد الموارد التي يمكن معالجتها بواسطة مهمة المعالجة. إذا لم يتم توفيره، يتم استخدام عدد الموارد الافتراضي.	الباحث
resourceDiscoveryMode	الطريقة التي يتم بها اكتشاف الموارد لمعالجة. الإعدادات الافتراضية ل ExistingNonCompliant إذا لم يتم تحديدها.	"ExistingNonCompliant" "إعادة تقييم التوافق"

RemediationPropertiesFailureThreshold

اسم	وصف	قيمة
النسبه المئويه	رقم بين 0.0 و1.0 يمثل حد فشل النسبة المئوية. ستفشل المعالجة إذا تجاوزت النسبة المئوية لعمليات المعالجة الفاشلة (أي عمليات النشر الفاشلة) هذا الحد.	الباحث

أمثلة الاستخدام

عينات Bicep

مثال أساسي لنشر معالجة نهج Azure.

targetScope = 'subscription'

param resourceName string = 'acctest0001'

resource policyAssignment 'Microsoft.Authorization/policyAssignments@2022-06-01' = {
  name: resourceName
  properties: {
    displayName: ''
    enforcementMode: 'Default'
    parameters: {
      listOfAllowedLocations: {
        value: [
          'West Europe'
          'West US 2'
          'East US 2'
        ]
      }
    }
    policyDefinitionId: '/providers/Microsoft.Authorization/policyDefinitions/e56962a6-4747-49cd-b67b-bf8b01975c4c'
    scope: subscription().id
  }
}

resource remediation 'Microsoft.PolicyInsights/remediations@2021-10-01' = {
  name: resourceName
  properties: {
    filters: {
      locations: []
    }
    policyAssignmentId: policyAssignment.id
    policyDefinitionReferenceId: ''
    resourceDiscoveryMode: 'ExistingNonCompliant'
  }
}

تعريف مورد قالب ARM

يمكن نشر نوع مورد المعالجات مع العمليات التي تستهدف:

• المستأجر - راجع أوامر * مجموعات الإدارة - انظر أوامر* نشر مجموعة الإدارةالاشتراك - انظر أوامر* نشر الاشتراكمجموعات الموارد - انظر أوامر نشر مجموعة الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.PolicyInsights/remediations، أضف JSON التالي إلى القالب الخاص بك.

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

قيم الخصائص

Microsoft.PolicyInsights/remediations

اسم	وصف	قيمة
apiVersion	إصدار واجهة برمجة التطبيقات	'2024-10-01'
اسم	اسم المورد	سلسلة (مطلوب)
خصائص	خصائص المعالجة.	معالجة الخصائص
نوع	نوع المورد	'Microsoft.PolicyInsights/remediations'

عوامل تصفية المعالجة

اسم	وصف	قيمة
مواقع	مواقع الموارد التي سيتم معالجتها.	سلسلة[]
معرفات الموارد	معرفات الموارد التي سيتم معالجتها. يمكن تحديد 100 معرف على الأكثر. لا يمكن استخدام عامل التصفية هذا عند تعيين ReEvaluateCompliance إلى ReEvaluateCompliance، ولا يمكن أن يكون فارغا إذا تم توفيره.	سلسلة[]

خصائص المعالجة

اسم	وصف	قيمة
فشلالعناد	إعدادات عتبة فشل المعالجة	RemediationPropertiesFailureThreshold
مرشحات	عوامل التصفية التي سيتم تطبيقها لتحديد الموارد التي يجب معالجتها.	RemediationFilters
عمليات التوزيع المتوازية	تحديد عدد الموارد التي يجب إصلاحها في أي وقت. يمكن استخدامها لزيادة أو تقليل وتيرة المعالجة. إذا لم يتم توفيرها، يتم استخدام قيمة عمليات النشر المتوازية الافتراضية.	الباحث
معرف تعيين النهج	معرف المورد لتعيين النهج الذي يجب معالجته.	خيط
policyDefinitionReferenceId	معرف مرجع تعريف النهج للتعريف الفردي الذي يجب معالجته. مطلوب عندما يقوم تعيين النهج الذي تتم معالجته بتعيين تعريف مجموعة نهج.	خيط
عدد الموارد	تحديد الحد الأقصى لعدد الموارد التي يمكن معالجتها بواسطة مهمة المعالجة. إذا لم يتم توفيره، يتم استخدام عدد الموارد الافتراضي.	الباحث
resourceDiscoveryMode	الطريقة التي يتم بها اكتشاف الموارد لمعالجة. الإعدادات الافتراضية ل ExistingNonCompliant إذا لم يتم تحديدها.	"ExistingNonCompliant" "إعادة تقييم التوافق"

RemediationPropertiesFailureThreshold

اسم	وصف	قيمة
النسبه المئويه	رقم بين 0.0 و1.0 يمثل حد فشل النسبة المئوية. ستفشل المعالجة إذا تجاوزت النسبة المئوية لعمليات المعالجة الفاشلة (أي عمليات النشر الفاشلة) هذا الحد.	الباحث

أمثلة الاستخدام

تعريف مورد Terraform (موفر AzAPI)

يمكن نشر نوع مورد المعالجات مع العمليات التي تستهدف:

• المستأجر* مجموعات* الإدارةالاشتراك* مجموعات الموارد

للحصول على قائمة بالخصائص التي تم تغييرها في كل إصدار من إصدارات واجهة برمجة التطبيقات، راجع سجل التغيير .

تنسيق المورد

لإنشاء مورد Microsoft.PolicyInsights/remediations، أضف Terraform التالي إلى القالب الخاص بك.

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

قيم الخصائص

Microsoft.PolicyInsights/remediations

اسم	وصف	قيمة
اسم	اسم المورد	سلسلة (مطلوب)
parent_id	معرف المورد لتطبيق مورد الملحق هذا عليه.	سلسلة (مطلوب)
خصائص	خصائص المعالجة.	معالجة الخصائص
نوع	نوع المورد	"Microsoft.PolicyInsights/remediations@2024-10-01"

عوامل تصفية المعالجة

اسم	وصف	قيمة
مواقع	مواقع الموارد التي سيتم معالجتها.	سلسلة[]
معرفات الموارد	معرفات الموارد التي سيتم معالجتها. يمكن تحديد 100 معرف على الأكثر. لا يمكن استخدام عامل التصفية هذا عند تعيين ReEvaluateCompliance إلى ReEvaluateCompliance، ولا يمكن أن يكون فارغا إذا تم توفيره.	سلسلة[]

خصائص المعالجة

اسم	وصف	قيمة
فشلالعناد	إعدادات عتبة فشل المعالجة	RemediationPropertiesFailureThreshold
مرشحات	عوامل التصفية التي سيتم تطبيقها لتحديد الموارد التي يجب معالجتها.	RemediationFilters
عمليات التوزيع المتوازية	تحديد عدد الموارد التي يجب إصلاحها في أي وقت. يمكن استخدامها لزيادة أو تقليل وتيرة المعالجة. إذا لم يتم توفيرها، يتم استخدام قيمة عمليات النشر المتوازية الافتراضية.	الباحث
معرف تعيين النهج	معرف المورد لتعيين النهج الذي يجب معالجته.	خيط
policyDefinitionReferenceId	معرف مرجع تعريف النهج للتعريف الفردي الذي يجب معالجته. مطلوب عندما يقوم تعيين النهج الذي تتم معالجته بتعيين تعريف مجموعة نهج.	خيط
عدد الموارد	تحديد الحد الأقصى لعدد الموارد التي يمكن معالجتها بواسطة مهمة المعالجة. إذا لم يتم توفيره، يتم استخدام عدد الموارد الافتراضي.	الباحث
resourceDiscoveryMode	الطريقة التي يتم بها اكتشاف الموارد لمعالجة. الإعدادات الافتراضية ل ExistingNonCompliant إذا لم يتم تحديدها.	"ExistingNonCompliant" "إعادة تقييم التوافق"

RemediationPropertiesFailureThreshold

اسم	وصف	قيمة
النسبه المئويه	رقم بين 0.0 و1.0 يمثل حد فشل النسبة المئوية. ستفشل المعالجة إذا تجاوزت النسبة المئوية لعمليات المعالجة الفاشلة (أي عمليات النشر الفاشلة) هذا الحد.	الباحث

أمثلة الاستخدام

عينات Terraform

مثال أساسي لنشر معالجة نهج Azure.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
    azurerm = {
      source = "hashicorp/azurerm"
    }
  }
}

provider "azurerm" {
  features {
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "eastus"
}

data "azurerm_client_config" "current" {
}

data "azapi_resource" "subscription" {
  type                   = "Microsoft.Resources/subscriptions@2021-01-01"
  resource_id            = "/subscriptions/${data.azurerm_client_config.current.subscription_id}"
  response_export_values = ["*"]
}

resource "azapi_resource" "policyAssignment" {
  type      = "Microsoft.Authorization/policyAssignments@2022-06-01"
  parent_id = data.azapi_resource.subscription.id
  name      = var.resource_name
  body = {
    properties = {
      displayName     = ""
      enforcementMode = "Default"
      parameters = {
        listOfAllowedLocations = {
          value = [
            "West Europe",
            "West US 2",
            "East US 2",
          ]
        }
      }
      policyDefinitionId = "/providers/Microsoft.Authorization/policyDefinitions/e56962a6-4747-49cd-b67b-bf8b01975c4c"
      scope              = data.azapi_resource.subscription.id
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "remediation" {
  type      = "Microsoft.PolicyInsights/remediations@2021-10-01"
  parent_id = data.azapi_resource.subscription.id
  name      = var.resource_name
  body = {
    properties = {
      filters = {
        locations = [
        ]
      }
      policyAssignmentId          = azapi_resource.policyAssignment.id
      policyDefinitionReferenceId = ""
      resourceDiscoveryMode       = "ExistingNonCompliant"
    }
  }
  schema_validation_enabled = false
  ignore_casing             = true
  response_export_values    = ["*"]
}