Start-AzPolicyRemediation

Referens

Modul:: Az.PolicyInsights

Skapar och startar en principreparation för en principtilldelning.

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

Description

Cmdleten Start-AzPolicyRemediation skapar en principreparation för en viss principtilldelning. Alla icke-kompatibla resurser vid eller under reparationsomfånget kommer att åtgärdas. Reparation stöds endast för principer med effekten "deployIfNotExists".

Exempel

Exempel 1: Starta en reparation i prenumerationsomfånget

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

Det här kommandot skapar en ny principreparation i prenumerationen "Min prenumeration" för den angivna principtilldelningen.

Exempel 2: Starta en reparation i hanteringsgruppens omfång med valfria filter

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

Det här kommandot skapar en ny principreparation i hanteringsgruppen "mg1" för den angivna principtilldelningen. Endast resurser på platserna "westus" eller "eastus" kommer att åtgärdas.

Exempel 3: Starta en reparation i resursgruppens omfång för en principuppsättningsdefinitionstilldelning

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

Det här kommandot skapar en ny principreparation i resursgruppen "myRG" för den angivna principtilldelningen. Principtilldelningen tilldelar en principuppsättningsdefinition (även kallat ett initiativ). Referens-ID:t för principdefinitionen anger vilken princip i initiativet som ska åtgärdas.

Exempel 4: Starta en reparation och vänta tills den har slutförts i bakgrunden

$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

Det här kommandot startar en ny principreparation i prenumerationen "Min prenumeration" för den angivna principtilldelningen. Den väntar tills reparationen har slutförts innan den slutliga reparationsstatusen returneras.

Exempel 5: Starta en reparation som identifierar icke-kompatibla resurser innan du åtgärdar

$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

Det här kommandot skapar en ny principreparation i prenumerationen "Min prenumeration" för den angivna principtilldelningen. Efterlevnadstillståndet för resurser i prenumerationen utvärderas på nytt mot principtilldelningen och icke-kompatibla resurser kommer att åtgärdas.

Exempel 6: Starta en reparation som åtgärdar upp till 10 000 icke-kompatibla resurser

$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

Exempel 7: Starta en reparation som åtgärdar 30 resurser parallellt

$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

Exempel 8: Starta en reparation som avslutas om mer än hälften av reparationsdistributionerna misslyckas

$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

Parametrar

-AsJob

Kör cmdleten i bakgrunden.

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:	SwitchParameter
Alias:	cf
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:	IAzureContextContainer
Alias:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-FailureThreshold

Tal mellan 0,0 och 1,0 som representerar tröskelvärdet för procentfel. Reparationen misslyckas om procentandelen misslyckade reparationsåtgärder (dvs. misslyckade distributioner) överskrider det här tröskelvärdet.

Typ:	Nullable<T>[Double]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-LocationFilter

De resursplatser som ska ingå i reparationen. Resurser som inte finns på dessa platser kommer inte att åtgärdas.

Typ:	String[]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ManagementGroupName

Hanteringsgrupps-ID.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

Resursnamn.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ParallelDeploymentCount

Hur många resurser som ska åtgärdas vid en viss tidpunkt. Kan användas för att kontrollera reparationstakten. Om det inte anges används standardvärdet för parallella distributioner.

Typ:	Nullable<T>[Int32]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-PolicyAssignmentId

Principtilldelnings-ID. T.ex. '/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{assignmentName}'.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-PolicyDefinitionReferenceId

Hämtar referens-ID:t för principdefinitionen för den enskilda definition som åtgärdas. Krävs när principtilldelningen tilldelar en principuppsättningsdefinition.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ResourceCount

Maximalt antal icke-kompatibla resurser som ska åtgärdas. Om det inte anges används standardantalet för resurser.

Typ:	Nullable<T>[Int32]
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ResourceDiscoveryMode

Beskriver hur reparationsaktiviteten identifierar resurser som behöver åtgärdas. ReEvaluateCompliance stöds inte vid reparation av hanteringsgruppsomfång.

Typ:	String
Godkända värden:	ExistingNonCompliant, ReEvaluateCompliance
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ResourceGroupName

Namn på resursgrupp.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-ResourceId

Resurs-ID.

Typ:	String
Alias:	Id
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Scope

Resursens omfattning. T.ex. '/subscriptions/{subscriptionId}/resourceGroups/{rgName}'.

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:	SwitchParameter
Alias:	wi
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

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

Utdata

PSRemediation

Dela via