Freigeben über


Microsoft.PolicyInsights-Korrekturen

Bicep-Ressourcendefinition

Der Wartungsressourcentyp ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.

Verwenden Sie die scope -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen. Weitere Informationen finden Sie unter Festlegen des Bereichs für Erweiterungsressourcen in Bicep.

Gültige Bereitstellungsbereiche für die Wartungsressource sind:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.PolicyInsights/remediations-Ressource zu erstellen, fügen Sie ihrer Vorlage den folgenden Bicep hinzu.

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

Eigenschaftswerte

remediations

Name BESCHREIBUNG Wert
name Der Ressourcenname Zeichenfolge (erforderlich)
scope Verwenden Sie beim Erstellen einer Erweiterungsressource in einem bereich, der sich vom Bereitstellungsbereich unterscheidet. Zielressource

Legen Sie für Bicep diese Eigenschaft auf den symbolischen Namen der Ressource fest, um die Erweiterungsressource anzuwenden.
properties Eigenschaften für die Korrektur. RemediationProperties

RemediationProperties

Name BESCHREIBUNG Wert
failureThreshold Schwellenwerteinstellungen für Behebungsfehler RemediationPropertiesFailureThreshold
Filter Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen behoben werden sollen. RemediationFilters
parallelDeployments Bestimmt, wie viele Ressourcen zu einem bestimmten Zeitpunkt behoben werden müssen. Kann verwendet werden, um das Tempo der Sanierung zu erhöhen oder zu reduzieren. Falls nicht angegeben, wird der Standardwert für parallele Bereitstellungen verwendet. INT
policyAssignmentId Die Ressourcen-ID der Richtlinienzuweisung, die behoben werden soll. Zeichenfolge
policyDefinitionReferenceId Die Referenz-ID der Richtliniendefinition der einzelnen Definition, die behoben werden soll. Erforderlich, wenn die zu korrigierende Richtlinienzuweisung eine Richtliniensatzdefinition zuweist. Zeichenfolge
resourceCount Bestimmt die maximale Anzahl von Ressourcen, die vom Wartungsauftrag behoben werden können. Falls nicht angegeben, wird die Standardressourcenanzahl verwendet. INT
resourceDiscoveryMode Die Art und Weise, wie Ressourcen zur Behebung ermittelt werden. Wird standardmäßig Auf ExistingNonCompliant festgelegt, wenn nicht angegeben. "ExistingNonCompliant"
'ReEvaluateCompliance'

RemediationPropertiesFailureThreshold

Name BESCHREIBUNG Wert
Prozentwert Eine Zahl zwischen 0,0 und 1,0, die den Prozentsatz des Fehlerschwellenwerts darstellt. Die Wartung schlägt fehl, wenn der Prozentsatz der fehlgeschlagenen Wartungsvorgänge (d. h. fehlgeschlagene Bereitstellungen) diesen Schwellenwert überschreitet. INT

RemediationFilters

Name BESCHREIBUNG Wert
locations Die Ressourcenspeicherorte, die behoben werden. string[]

Ressourcendefinition mit einer ARM-Vorlage

Der Wartungsressourcentyp ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.

Verwenden Sie die scope -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen. Weitere Informationen finden Sie unter Festlegen des Bereichs für Erweiterungsressourcen in ARM-Vorlagen.

Gültige Bereitstellungsbereiche für die Wartungsressource sind:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.PolicyInsights/remediations-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

remediations

Name BESCHREIBUNG Wert
type Ressourcentyp "Microsoft.PolicyInsights/remediations"
apiVersion Die Version der Ressourcen-API '2021-10-01'
name Der Ressourcenname Zeichenfolge (erforderlich)
scope Verwenden Sie beim Erstellen einer Erweiterungsressource in einem anderen Bereich als dem Bereitstellungsbereich. Zielressource

Legen Sie für JSON den Wert auf den vollständigen Namen der Ressource fest, auf die die Erweiterungsressource angewendet werden soll.
properties Eigenschaften für die Korrektur. RemediationProperties

RemediationProperties

Name BESCHREIBUNG Wert
failureThreshold Schwellenwerteinstellungen für Korrekturfehler RemediationPropertiesFailureThreshold
Filter Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen wiederhergestellt werden sollen. RemediationFilters
parallelDeployments Bestimmt, wie viele Ressourcen zu einem bestimmten Zeitpunkt wiederhergestellt werden sollen. Kann verwendet werden, um das Tempo der Korrektur zu erhöhen oder zu verringern. Wenn nicht angegeben, wird der Standardwert für parallele Bereitstellungen verwendet. INT
policyAssignmentId Die Ressourcen-ID der Richtlinienzuweisung, die wiederhergestellt werden soll. Zeichenfolge
policyDefinitionReferenceId Die Referenz-ID der Richtliniendefinition der einzelnen Definition, die wiederhergestellt werden soll. Erforderlich, wenn die zu korrigierende Richtlinienzuweisung eine Richtliniensatzdefinition zuweist. Zeichenfolge
resourceCount Bestimmt die maximale Anzahl von Ressourcen, die durch den Wartungsauftrag behoben werden können. Wenn nicht angegeben, wird die Standardressourcenanzahl verwendet. INT
resourceDiscoveryMode Die Art und Weise, wie Ressourcen ermittelt werden, die wiederhergestellt werden sollen. Wird standardmäßig ExistingNonCompliant verwendet, wenn nicht angegeben. "ExistingNonCompliant"
"ReEvaluateCompliance"

RemediationPropertiesFailureThreshold

Name BESCHREIBUNG Wert
Prozentwert Eine Zahl zwischen 0,0 und 1,0, die den Fehlerschwellenwert in Prozent darstellt. Die Wartung schlägt fehl, wenn der Prozentsatz der fehlgeschlagenen Wartungsvorgänge (d. h. fehlerhafte Bereitstellungen) diesen Schwellenwert überschreitet. INT

RemediationFilters

Name BESCHREIBUNG Wert
locations Die Ressourcenspeicherorte, die wiederhergestellt werden. string[]

Terraform-Ressourcendefinition (AzAPI-Anbieter)

Der Ressourcentyp "Remediations" ist eine Erweiterungsressource, was bedeutet, dass Sie sie auf eine andere Ressource anwenden können.

Verwenden Sie die parent_id -Eigenschaft für diese Ressource, um den Bereich für diese Ressource festzulegen.

Gültige Bereitstellungsbereiche für die Wartungsressource sind:

  • Ressourcengruppen
  • Abonnements
  • Verwaltungsgruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.PolicyInsights/remediations-Ressource zu erstellen, fügen Sie Ihrer Vorlage den folgenden Terraform hinzu.

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

Eigenschaftswerte

remediations

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.PolicyInsights/remediations@2021-10-01"
name Der Ressourcenname Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. Zeichenfolge (erforderlich)
properties Eigenschaften für die Korrektur. RemediationProperties

RemediationProperties

Name BESCHREIBUNG Wert
failureThreshold Schwellenwerteinstellungen für Korrekturfehler RemediationPropertiesFailureThreshold
Filter Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen wiederhergestellt werden sollen. RemediationFilters
parallelDeployments Bestimmt, wie viele Ressourcen zu einem bestimmten Zeitpunkt wiederhergestellt werden sollen. Kann verwendet werden, um das Tempo der Korrektur zu erhöhen oder zu verringern. Wenn nicht angegeben, wird der Standardwert für parallele Bereitstellungen verwendet. INT
policyAssignmentId Die Ressourcen-ID der Richtlinienzuweisung, die wiederhergestellt werden soll. Zeichenfolge
policyDefinitionReferenceId Die Referenz-ID der Richtliniendefinition der einzelnen Definition, die wiederhergestellt werden soll. Erforderlich, wenn die zu korrigierende Richtlinienzuweisung eine Richtliniensatzdefinition zuweist. Zeichenfolge
resourceCount Bestimmt die maximale Anzahl von Ressourcen, die durch den Wartungsauftrag behoben werden können. Wenn nicht angegeben, wird die Standardressourcenanzahl verwendet. INT
resourceDiscoveryMode Die Art und Weise, wie Ressourcen ermittelt werden, die wiederhergestellt werden sollen. Wird standardmäßig ExistingNonCompliant verwendet, wenn nicht angegeben. "ExistingNonCompliant"
"ReEvaluateCompliance"

RemediationPropertiesFailureThreshold

Name BESCHREIBUNG Wert
Prozentwert Eine Zahl zwischen 0,0 und 1,0, die den Fehlerschwellenwert in Prozent darstellt. Die Wartung schlägt fehl, wenn der Prozentsatz der fehlgeschlagenen Wartungsvorgänge (d. h. fehlerhafte Bereitstellungen) diesen Schwellenwert überschreitet. INT

RemediationFilters

Name BESCHREIBUNG Wert
locations Die Ressourcenspeicherorte, die wiederhergestellt werden. string[]