Microsoft.PolicyInsights-Korrekturen 2021-10-01
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:
- Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle
- Abonnements : Siehe Befehle zur Abonnementbereitstellung
- Verwaltungsgruppen : Siehe Verwaltungsgruppenbereitstellungsbefehle
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:
- Ressourcengruppen : Siehe Ressourcengruppenbereitstellungsbefehle
- Abonnements : Siehe Befehle zur Abonnementbereitstellung
- Verwaltungsgruppen : Siehe Verwaltungsgruppenbereitstellungsbefehle
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 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[] |