Start-AzPolicyRemediation
Szabályzat-hozzárendeléshez létrehoz és elindít egy szabályzat-szervizelést.
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
A Start-AzPolicyRemediation parancsmag létrehoz egy szabályzat-szervizelést egy adott szabályzat-hozzárendeléshez. A szervizelés hatókörén vagy alatt található összes nem megfelelő erőforrás szervizelésre kerül. A szervizelés csak a "deployIfNotExists" effektusú szabályzatok esetében támogatott.
Példák
1. példa: Szervizelés indítása az előfizetés hatókörében
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Set-AzContext -Subscription "My Subscription"
Start-AzPolicyRemediation -PolicyAssignmentId $policyAssignmentId -Name "remediation1"
Ez a parancs létrehoz egy új szabályzat-szervizelést az adott szabályzat-hozzárendeléshez tartozó "Saját előfizetés" előfizetésben.
2. példa: Szervizelés indítása a felügyeleti csoport hatókörében választható szűrőkkel
$policyAssignmentId = "/providers/Microsoft.Management/managementGroups/mg1/providers/Microsoft.Authorization/policyAssignments/pa1"
Start-AzPolicyRemediation -ManagementGroupName "mg1" -PolicyAssignmentId $policyAssignmentId -Name "remediation1" -LocationFilter "westus","eastus"
Ez a parancs létrehoz egy új házirend-szervizelést az adott szabályzat-hozzárendelés "mg1" felügyeleti csoportjában. Csak a "westus" vagy az "eastus" helyeken lévő erőforrások lesznek szervizelve.
3. példa: Szervizelés indítása erőforráscsoport-hatókörben egy szabályzatkészletdefiníció-hozzárendeléshez
$policyAssignmentId = "/subscriptions/f0710c27-9663-4c05-19f8-1b4be01e86a5/resourceGroups/myRG/providers/Microsoft.Authorization/policyAssignments/2deae24764b447c29af7c309"
Start-AzPolicyRemediation -ResourceGroupName "myRG" -PolicyAssignmentId $policyAssignmentId -PolicyDefinitionReferenceId "0349234412441" -Name "remediation1"
Ez a parancs létrehoz egy új szabályzat-szervizelést a "myRG" erőforráscsoportban az adott szabályzat-hozzárendeléshez. A szabályzat-hozzárendelés hozzárendel egy szabályzatkészlet-definíciót (más néven kezdeményezést). A szabályzatdefiníció referenciaazonosítója azt jelzi, hogy a kezdeményezésen belül melyik szabályzatot kell kijavítani.
4. példa: Szervizelés indítása és várakozás a háttérben való befejezésére
$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
Ez a parancs új szabályzat-szervizelést indít el az adott szabályzat-hozzárendeléshez tartozó "Saját előfizetés" előfizetésben. Megvárja, amíg a szervizelés befejeződik, mielőtt visszaadja a végleges szervizelési állapotot.
5. példa: Olyan szervizelés indítása, amely a szervizelés előtt felderíti a nem megfelelő erőforrásokat
$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
Ez a parancs létrehoz egy új szabályzat-szervizelést az adott szabályzat-hozzárendeléshez tartozó "Saját előfizetés" előfizetésben. Az előfizetésben lévő erőforrások megfelelőségi állapotát a rendszer újra kiértékeli a szabályzat-hozzárendelés alapján, és a nem megfelelő erőforrások szervizelése történik.
6. példa: Olyan szervizelés indítása, amely legfeljebb 10 000 nem megfelelő erőforrást szervizel
$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
7. példa: 30 erőforrást párhuzamosan szervizelő szervizelés indítása
$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
8. példa: Olyan szervizelés indítása, amely leáll, ha a szervizelési üzemelő példányok több mint fele sikertelen
$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
Paraméterek
-AsJob
Futtassa a parancsmagot a háttérben.
Típus: | SwitchParameter |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Jóváhagyást kér a parancsmag futtatása előtt.
Típus: | SwitchParameter |
Aliases: | cf |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Az Azure-ral való kommunikációhoz használt hitelesítő adatok, fiók, bérlő és előfizetés.
Típus: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailureThreshold
A hiba százalékos küszöbértékét jelölő 0,0 és 1,0 közötti szám. A szervizelés sikertelen lesz, ha a sikertelen szervizelési műveletek (azaz a sikertelen üzembe helyezések) százalékos aránya meghaladja ezt a küszöbértéket.
Típus: | Nullable<T>[Double] |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LocationFilter
A szervizelésbe belefoglalandó erőforráshelyek. Az ezeken a helyeken nem található erőforrások nem lesznek szervizelve.
Típus: | String[] |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ManagementGroupName
Felügyeleti csoport azonosítója.
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Erőforrás neve.
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ParallelDeploymentCount
Hány erőforrást kell egyszerre szervizelni. A szervizelés ütemének szabályozására használható. Ha nincs megadva, a rendszer az alapértelmezett párhuzamos üzembe helyezési értéket használja.
Típus: | Nullable<T>[Int32] |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyAssignmentId
Szabályzat-hozzárendelés azonosítója. Például: "/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/policyAssignments/{assignmentName}".
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PolicyDefinitionReferenceId
Lekéri a szervizelendő egyedi definíció szabályzatdefiníciós referencia-azonosítóját. Akkor szükséges, ha a szabályzat-hozzárendelés hozzárendel egy szabályzatkészlet-definíciót.
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceCount
A szervizelendő nem megfelelő erőforrások maximális száma. Ha nincs megadva, a rendszer az alapértelmezett erőforrásszámot használja.
Típus: | Nullable<T>[Int32] |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceDiscoveryMode
Ismerteti, hogy a szervizelési tevékenység hogyan fogja felderíteni a szervizelendő erőforrásokat. A felügyeleti csoport hatóköreinek szervizelése nem támogatja a ReEvaluateCompliance szolgáltatást.
Típus: | String |
elfogadott értékek: | ExistingNonCompliant, ReEvaluateCompliance |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Az erőforráscsoport neve.
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceId
Erőforrás-azonosító.
Típus: | String |
Aliases: | Id |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scope
Az erőforrás hatóköre. Például: "/subscriptions/{subscriptionId}/resourceGroups/{rgName}".
Típus: | String |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliases: | wi |
Position: | Named |
alapértelmezett érték: | None |
Kötelező: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
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]]