Start-AzPolicyRemediation

Erstellt und startet eine Richtlinienkorrektur für eine Richtlinienzuweisung.

Syntax

Start-AzPolicyRemediation
     -Name <String>
     [-Scope <String>]
     [-ManagementGroupName <String>]
     [-ResourceGroupName <String>]
     -PolicyAssignmentId <String>
     [-PolicyDefinitionReferenceId <String>]
     [-LocationFilter <String[]>]
     [-ResourceDiscoveryMode <String>]
     [-ResourceCount <Int32>]
     [-ParallelDeploymentCount <Int32>]
     [-FailureThreshold <Double>]
     [-AsJob]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-AzPolicyRemediation
     -ResourceId <String>
     -PolicyAssignmentId <String>
     [-PolicyDefinitionReferenceId <String>]
     [-LocationFilter <String[]>]
     [-ResourceDiscoveryMode <String>]
     [-ResourceCount <Int32>]
     [-ParallelDeploymentCount <Int32>]
     [-FailureThreshold <Double>]
     [-AsJob]
     [-DefaultProfile <IAzureContextContainer>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Beschreibung

Das Cmdlet "Start-AzPolicyRemediation " erstellt eine Richtlinienkorrektur für eine bestimmte Richtlinienzuweisung. Alle nicht kompatiblen Ressourcen im Oder unter dem Umfang der Korrektur werden korrigiert. Die Korrektur wird nur für Richtlinien mit dem Effekt "deployIfNotExists" unterstützt.

Beispiele

Beispiel 1: Starten einer Wartung im Abonnementbereich

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1"

Dieser Befehl erstellt eine neue Richtlinienkorrektur im Abonnement "Mein Abonnement" für die angegebene Richtlinienzuweisung.

Beispiel 2: Starten einer Korrektur im Verwaltungsgruppenbereich mit optionalen Filtern

$policyAssignmentId = "/providers/Microsoft.Management/managementGroups/mg1/providers/Microsoft.Authorization/policyAssignments/pa1"
Start-AzPolicyRemediation -ManagementGroupName "mg1" -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -LocationFilter "westus","eastus"

Dieser Befehl erstellt eine neue Richtlinienkorrektur in der Verwaltungsgruppe "mg1" für die angegebene Richtlinienzuweisung. Es werden nur Ressourcen an den Standorten "westus" oder "eastus" behoben.

Beispiel 3: Starten einer Korrektur im Ressourcengruppenbereich für eine Richtliniensatzdefinitionszuordnung

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/resourceGroups/myRG/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Start-AzPolicyRemediation -ResourceGroupName "myRG" -PolicyAssignmentId $policyAssignmentId -PolicyDefinitionReferenceId "0349234412441" -Name "remediation1"

Dieser Befehl erstellt eine neue Richtlinienkorrektur in der Ressourcengruppe "myRG" für die angegebene Richtlinienzuweisung. Die Richtlinienzuweisung weist eine Richtliniensatzdefinition zu (auch als Initiative bezeichnet). Die Referenz-ID der Richtliniendefinition gibt an, welche Richtlinie innerhalb der Initiative behoben werden soll.

Beispiel 4: Starten einer Korrektur und Warten auf den Abschluss im Hintergrund

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription f0710c27-9663-4c05-19f8-1b4be01e86a5
$job = Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -AsJob
$job | Wait-Job
$remediation = $job | Receive-Job

Dieser Befehl startet eine neue Richtlinienkorrektur im Abonnement "Mein Abonnement" für die angegebene Richtlinienzuweisung. Es wartet, bis die Wartung abgeschlossen ist, bevor der endgültige Wartungsstatus zurückgegeben wird.

Beispiel 5: Starten einer Korrektur, die nicht kompatible Ressourcen erkennt, bevor sie behoben werden

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ResourceDiscoveryMode ReEvaluateCompliance

Dieser Befehl erstellt eine neue Richtlinienkorrektur im Abonnement "Mein Abonnement" für die angegebene Richtlinienzuweisung. Der Compliancestatus der Ressourcen im Abonnement wird anhand der Richtlinienzuweisung erneut ausgewertet, und nicht kompatible Ressourcen werden korrigiert.

Beispiel 6: Starten einer Wartung, die bis zu 10.000 nicht kompatible Ressourcen korrigiert

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ResourceCount 10000

Beispiel 7: Starten einer Wartung, die 30 Ressourcen parallel beheben wird

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -ParallelDeploymentCount 30

Beispiel 8: Starten einer Wartung, die beendet wird, wenn mehr als die Hälfte der Wartungsbereitstellungen fehlschlägt

$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -FailureThreshold 0.5

Parameter

-AsJob

Führen Sie das Cmdlet im Hintergrund aus.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FailureThreshold

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.

Type:Nullable<T>[Double]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LocationFilter

Die Ressourcenspeicherorte, die in die Wartung einbezogen werden sollen. Ressourcen, die sich nicht an diesen Speicherorten befinden, werden nicht behoben.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ManagementGroupName

Verwaltungsgruppen-ID.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Ressourcenname.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ParallelDeploymentCount

Anzahl der Ressourcen, die zu einem bestimmten Zeitpunkt behoben werden sollen. Kann verwendet werden, um das Tempo der Behebung zu steuern. Wenn nicht angegeben, wird der Standardwert für parallele Bereitstellungen verwendet.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-PolicyAssignmentId

Richtlinienzuweisungs-ID. Beispiel: "/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{assignmentName}".

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyDefinitionReferenceId

Ruft die Richtliniendefinitionsreferenz-ID der einzelnen Definition ab, die korrigiert wird. Erforderlich, wenn die Richtlinienzuweisung eine Richtliniensatzdefinition zuweist.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceCount

Maximale Anzahl nicht kompatibler Ressourcen, die korrigiert werden. Wenn nicht angegeben, wird die Standardressourcenanzahl verwendet.

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceDiscoveryMode

Beschreibt, wie der Wartungsvorgang Ressourcen erkennt, die korrigiert werden müssen. ReEvaluateCompliance wird beim Beheben von Verwaltungsgruppenbereichen nicht unterstützt.

Type:String
Accepted values:ExistingNonCompliant, ReEvaluateCompliance
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Ressourcengruppenname

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceId

Ressourcen-ID

Type:String
Aliases:Id
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Bereich der Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{rgName}".

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

String[]

Nullable<T>[[System.Int32, System.Private.CoreLib, Version=7.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Nullable<T>[[System.Double, System.Private.CoreLib, Version=7.0.0.0, Culture=neutral, PublicKeyToken=7cec85d7bea7798e]]

Ausgaben

PSRemediation