Start-AzPolicyRemediation

Referentie

Module:: Az.PolicyInsights

Hiermee maakt en start u een beleidsherstel voor een beleidstoewijzing.

Syntaxis

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>]

Description

De Start-AzPolicyRemediation cmdlet maakt een beleidsherstel voor een bepaalde beleidstoewijzing. Alle niet-compatibele resources op of onder het bereik van het herstel worden hersteld. Herstel wordt alleen ondersteund voor beleid met het effect deployIfNotExists.

Voorbeelden

Voorbeeld 1: Een herstel starten op abonnementsbereik

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

Met deze opdracht maakt u een nieuw beleidsherstel in abonnement 'Mijn abonnement' voor de opgegeven beleidstoewijzing.

Voorbeeld 2: Een herstel starten bij het bereik van de beheergroep met optionele filters

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

Met deze opdracht maakt u een nieuw beleidsherstel in beheergroep 'mg1' voor de opgegeven beleidstoewijzing. Alleen resources op de locaties 'westus' of 'eastus' worden hersteld.

Voorbeeld 3: Een herstel starten bij het bereik van de resourcegroep voor een definitietoewijzing van een beleidsset

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

Met deze opdracht maakt u een nieuw beleidsherstel in de resourcegroep 'myRG' voor de opgegeven beleidstoewijzing. Met de beleidstoewijzing wordt een definitie van een beleidsset toegewezen (ook wel initiatief genoemd). De referentie-id van de beleidsdefinitie geeft aan welk beleid binnen het initiatief moet worden hersteld.

Voorbeeld 4: Een herstel starten en wachten totdat het op de achtergrond is voltooid

$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

Met deze opdracht wordt een nieuw beleidsherstel gestart in abonnement 'Mijn abonnement' voor de opgegeven beleidstoewijzing. Het wacht totdat het herstel is voltooid voordat de definitieve herstelstatus wordt geretourneerd.

Voorbeeld 5: Een herstel starten waarmee niet-compatibele resources worden gedetecteerd voordat u herstelt

$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

Met deze opdracht maakt u een nieuw beleidsherstel in abonnement 'Mijn abonnement' voor de opgegeven beleidstoewijzing. De nalevingsstatus van resources in het abonnement wordt opnieuw geëvalueerd op basis van de beleidstoewijzing en niet-compatibele resources worden hersteld.

Voorbeeld 6: Een herstel starten waarmee maximaal 10.000 niet-compatibele resources worden hersteld

$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

Voorbeeld 7: Een herstel starten waarmee 30 resources parallel worden hersteld

$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

Voorbeeld 8: Een herstel starten dat wordt beëindigd als meer dan de helft van de herstelimplementaties mislukt

$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

Parameters

-AsJob

Voer de cmdlet op de achtergrond uit.

Type:	SwitchParameter
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:	SwitchParameter
Aliassen:	cf
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-DefaultProfile

De referenties, accounts, tenants en abonnementen die worden gebruikt voor communicatie met Azure.

Type:	IAzureContextContainer
Aliassen:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-FailureThreshold

Getal tussen 0,0 en 1,0 dat de drempelwaarde voor foutenpercentage vertegenwoordigt. Het herstel mislukt als het percentage mislukte herstelbewerkingen (bijvoorbeeld mislukte implementaties) deze drempelwaarde overschrijdt.

Type:	Nullable<T>[Double]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-LocationFilter

De resourcelocaties die moeten worden opgenomen in het herstel. Resources die zich niet op deze locaties bevinden, worden niet hersteld.

Type:	String[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ManagementGroupName

Beheergroep-id.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Name

Resourcenaam.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ParallelDeploymentCount

Hoeveel resources er op een bepaald moment moeten worden hersteld. Kan worden gebruikt om het tempo van het herstel te bepalen. Als deze niet is opgegeven, wordt de standaardwaarde voor parallelle implementaties gebruikt.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PolicyAssignmentId

Id van beleidstoewijzing. Bijvoorbeeld '/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{assignmentName}'.

Type:	String
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-PolicyDefinitionReferenceId

Hiermee haalt u de referentie-id van de beleidsdefinitie op van de afzonderlijke definitie die wordt hersteld. Vereist wanneer de beleidstoewijzing een beleidssetdefinitie toewijst.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceCount

Maximum aantal niet-compatibele resources dat wordt hersteld. Als dit niet is opgegeven, wordt het standaardaantal resources gebruikt.

Type:	Nullable<T>[Int32]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceDiscoveryMode

Beschrijft hoe met de hersteltaak resources worden gedetecteerd die moeten worden hersteld. ReEvaluateCompliance wordt niet ondersteund bij het herstellen van bereiken van beheergroepen.

Type:	String
Geaccepteerde waarden:	ExistingNonCompliant, ReEvaluateCompliance
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceGroupName

Naam van resourcegroep.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-ResourceId

Resource-id.

Type:	String
Aliassen:	Id
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Scope

Bereik van de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{rgName}.

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:	SwitchParameter
Aliassen:	wi
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

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]]

Uitvoerwaarden

PSRemediation

Delen via