Microsoft.PolicyInsights-Korrekturen
Bicep-Ressourcendefinition
Der Ressourcentyp "Remediations" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
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 die folgende Bicep hinzu.
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'
}
}
Eigenschaftswerte
Microsoft.PolicyInsights/Remediations
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Eigenschaften für die Wartung. | RemediationProperties |
| Umfang | Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. | Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden. |
RemediationFilters
| Name | Beschreibung | Wert |
|---|---|---|
| Orte | Die Ressourcenspeicherorte, die korrigiert werden. | string[] |
| resourceIds | Die IDs der Ressourcen, die korrigiert werden. Kann höchstens 100 IDs angeben. Dieser Filter kann nicht verwendet werden, wenn "ReEvaluateCompliance" auf "ReEvaluateCompliance" festgelegt ist und bei Angabe nicht leer sein kann. | string[] |
RemediationProperties
| Name | Beschreibung | Wert |
|---|---|---|
| failureThreshold | Einstellungen für fehlerbehebungsschwellenwerte | RemediationPropertiesFailureThreshold |
| Filter | Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen korrigiert werden sollen. | RemediationFilters |
| ParallelDeployments | Bestimmt, wie viele Ressourcen zu einem bestimmten Zeitpunkt behoben werden sollen. Kann verwendet werden, um das Tempo der Behebung zu erhöhen oder zu reduzieren. Wenn nicht angegeben, wird der Standardwert für parallele Bereitstellungen verwendet. | Int |
| policyAssignmentId | Die Ressourcen-ID der Richtlinienzuordnung, die korrigiert werden soll. | Schnur |
| policyDefinitionReferenceId | Die Richtliniendefinitionsreferenz-ID der einzelnen Definition, die korrigiert werden soll. Erforderlich, wenn die zu korrigierende Richtlinienzuweisung eine Richtliniensatzdefinition zuweist. | Schnur |
| 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 behoben werden können, werden ermittelt. Wird standardmäßig auf "ExistingNonCompliant" festgelegt, falls nicht angegeben. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Name | Beschreibung | Wert |
|---|---|---|
| Prozentsatz | Eine Zahl zwischen 0,0 und 1,0, die den Prozentsatzfehlerschwellenwert darstellt. Die Korrektur schlägt fehl, wenn der Prozentsatz der fehlgeschlagenen Wartungsvorgänge (d. h. fehlgeschlagene Bereitstellungen) diesen Schwellenwert überschreitet. | Int |
ARM-Vorlagenressourcendefinition
Der Ressourcentyp "Remediations" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
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": "2024-10-01",
"name": "string",
"properties": {
"failureThreshold": {
"percentage": "int"
},
"filters": {
"locations": [ "string" ],
"resourceIds": [ "string" ]
},
"parallelDeployments": "int",
"policyAssignmentId": "string",
"policyDefinitionReferenceId": "string",
"resourceCount": "int",
"resourceDiscoveryMode": "string"
}
}
Eigenschaftswerte
Microsoft.PolicyInsights/Remediations
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | '2024-10-01' |
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| Eigenschaften | Eigenschaften für die Wartung. | RemediationProperties |
| Art | Der Ressourcentyp | "Microsoft.PolicyInsights/Remediations" |
RemediationFilters
| Name | Beschreibung | Wert |
|---|---|---|
| Orte | Die Ressourcenspeicherorte, die korrigiert werden. | string[] |
| resourceIds | Die IDs der Ressourcen, die korrigiert werden. Kann höchstens 100 IDs angeben. Dieser Filter kann nicht verwendet werden, wenn "ReEvaluateCompliance" auf "ReEvaluateCompliance" festgelegt ist und bei Angabe nicht leer sein kann. | string[] |
RemediationProperties
| Name | Beschreibung | Wert |
|---|---|---|
| failureThreshold | Einstellungen für fehlerbehebungsschwellenwerte | RemediationPropertiesFailureThreshold |
| Filter | Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen korrigiert werden sollen. | RemediationFilters |
| ParallelDeployments | Bestimmt, wie viele Ressourcen zu einem bestimmten Zeitpunkt behoben werden sollen. Kann verwendet werden, um das Tempo der Behebung zu erhöhen oder zu reduzieren. Wenn nicht angegeben, wird der Standardwert für parallele Bereitstellungen verwendet. | Int |
| policyAssignmentId | Die Ressourcen-ID der Richtlinienzuordnung, die korrigiert werden soll. | Schnur |
| policyDefinitionReferenceId | Die Richtliniendefinitionsreferenz-ID der einzelnen Definition, die korrigiert werden soll. Erforderlich, wenn die zu korrigierende Richtlinienzuweisung eine Richtliniensatzdefinition zuweist. | Schnur |
| 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 behoben werden können, werden ermittelt. Wird standardmäßig auf "ExistingNonCompliant" festgelegt, falls nicht angegeben. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Name | Beschreibung | Wert |
|---|---|---|
| Prozentsatz | Eine Zahl zwischen 0,0 und 1,0, die den Prozentsatzfehlerschwellenwert darstellt. Die Korrektur schlägt fehl, wenn der Prozentsatz der fehlgeschlagenen Wartungsvorgänge (d. h. fehlgeschlagene Bereitstellungen) diesen Schwellenwert überschreitet. | Int |
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp "Remediations" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
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 die folgende Terraform hinzu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.PolicyInsights/remediations@2024-10-01"
name = "string"
parent_id = "string"
body = jsonencode({
properties = {
failureThreshold = {
percentage = int
}
filters = {
locations = [
"string"
]
resourceIds = [
"string"
]
}
parallelDeployments = int
policyAssignmentId = "string"
policyDefinitionReferenceId = "string"
resourceCount = int
resourceDiscoveryMode = "string"
}
})
}
Eigenschaftswerte
Microsoft.PolicyInsights/Remediations
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Der Ressourcenname | Zeichenfolge (erforderlich) |
| parent_id | Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. | Zeichenfolge (erforderlich) |
| Eigenschaften | Eigenschaften für die Wartung. | RemediationProperties |
| Art | Der Ressourcentyp | "Microsoft.PolicyInsights/remediations@2024-10-01" |
RemediationFilters
| Name | Beschreibung | Wert |
|---|---|---|
| Orte | Die Ressourcenspeicherorte, die korrigiert werden. | string[] |
| resourceIds | Die IDs der Ressourcen, die korrigiert werden. Kann höchstens 100 IDs angeben. Dieser Filter kann nicht verwendet werden, wenn "ReEvaluateCompliance" auf "ReEvaluateCompliance" festgelegt ist und bei Angabe nicht leer sein kann. | string[] |
RemediationProperties
| Name | Beschreibung | Wert |
|---|---|---|
| failureThreshold | Einstellungen für fehlerbehebungsschwellenwerte | RemediationPropertiesFailureThreshold |
| Filter | Die Filter, die angewendet werden, um zu bestimmen, welche Ressourcen korrigiert werden sollen. | RemediationFilters |
| ParallelDeployments | Bestimmt, wie viele Ressourcen zu einem bestimmten Zeitpunkt behoben werden sollen. Kann verwendet werden, um das Tempo der Behebung zu erhöhen oder zu reduzieren. Wenn nicht angegeben, wird der Standardwert für parallele Bereitstellungen verwendet. | Int |
| policyAssignmentId | Die Ressourcen-ID der Richtlinienzuordnung, die korrigiert werden soll. | Schnur |
| policyDefinitionReferenceId | Die Richtliniendefinitionsreferenz-ID der einzelnen Definition, die korrigiert werden soll. Erforderlich, wenn die zu korrigierende Richtlinienzuweisung eine Richtliniensatzdefinition zuweist. | Schnur |
| 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 behoben werden können, werden ermittelt. Wird standardmäßig auf "ExistingNonCompliant" festgelegt, falls nicht angegeben. | 'ExistingNonCompliant' 'ReEvaluateCompliance' |
RemediationPropertiesFailureThreshold
| Name | Beschreibung | Wert |
|---|---|---|
| Prozentsatz | Eine Zahl zwischen 0,0 und 1,0, die den Prozentsatzfehlerschwellenwert darstellt. Die Korrektur schlägt fehl, wenn der Prozentsatz der fehlgeschlagenen Wartungsvorgänge (d. h. fehlgeschlagene Bereitstellungen) diesen Schwellenwert überschreitet. | Int |