Remove-AzPolicyRemediation

Hiermee verwijdert u een beleidsherstel.

Syntax

DeleteBySubscriptionId (Standaard)

Remove-AzPolicyRemediation
    -Name <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-AllowStop]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DeleteByResourceGroup

Remove-AzPolicyRemediation
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-AllowStop]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DeleteByResourceId

Remove-AzPolicyRemediation
    -ResourceId <String>
    [-Name <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-AllowStop]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DeleteByScope

Remove-AzPolicyRemediation
    -Name <String>
    -Scope <String>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-AllowStop]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DeleteByManagementGroup

Remove-AzPolicyRemediation
    -Name <String>
    -ManagementGroupId <String>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-AllowStop]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

DeleteViaIdentity

Remove-AzPolicyRemediation
    -InputObject <IPolicyInsightsIdentity>
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-AllowStop]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Met de cmdlet Remove-AzPolicyRemediation wordt een beleidsherstel verwijderd.

Het herstel moet een terminalstatus hebben om te worden verwijderd.

Deze cmdlet heeft echter een schakeloptie waarmee een herstel wordt afgedwongen om te stoppen als deze nog wordt uitgevoerd en deze vervolgens wordt verwijderd.

Voorbeelden

Voorbeeld 1: Een beleidsherstel verwijderen binnen het bereik van de resourcegroep

Remove-AzPolicyRemediation -ResourceGroupName "myRG" -Name "remediation1"

Met deze opdracht verwijdert u het herstel met de naam 'remediation1' in de resourcegroep 'myRG'.

Voorbeeld 2: Een herstel van een beheergroep verwijderen via leidingen

$remediation = Get-AzPolicyRemediation -ManagementGroupId "mg1" -Name "remediation1"
$remediation | Remove-AzPolicyRemediation -Confirm

Met deze opdracht verwijdert u het herstel met de naam 'remediation1' uit beheergroep 'mg1'. Er wordt een bevestigingsprompt weergegeven voordat u de resource verwijdert.

Voorbeeld 3: Een beleidsherstel annuleren en verwijderen

Remove-AzPolicyRemediation -ResourceGroupName "myRG" -Name "remediation1" -AllowStop

Met deze opdracht verwijdert u het herstel met de naam 'remediation1' in de resourcegroep 'myRG'. Als het herstel wordt uitgevoerd, wordt het geannuleerd voordat het wordt verwijderd.

Parameters

-AllowStop

Toestaan dat het herstel wordt geannuleerd als deze wordt uitgevoerd. Ongevaarlijk als het herstel zich al in een terminalstatus bevindt. Zonder deze schakeloptie genereert de cmdlet een fout als het herstel zich niet in een terminalstatus bevindt.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-AsJob

Voer de cmdlet op de achtergrond uit.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-DefaultProfile

De parameter DefaultProfile is niet functioneel. Gebruik de parameter SubscriptionId indien beschikbaar als u de cmdlet uitvoert voor een ander abonnement.

Parametereigenschappen

Type:PSObject
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzureRMContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-InputObject

Identiteitsparameter

Parametereigenschappen

Type:IPolicyInsightsIdentity
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DeleteViaIdentity
Position:Named
Verplicht:True
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ManagementGroupId

Beheergroep-id.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Beheergroepnaam

Parametersets

DeleteByManagementGroup
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

De naam van het herstel.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Herstelnaam

Parametersets

DeleteBySubscriptionId
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
DeleteByResourceGroup
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
DeleteByScope
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
DeleteByManagementGroup
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-PassThru

Retourneert waar wanneer de opdracht slaagt

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceGroupName

Naam van de resourcegroep.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DeleteByResourceGroup
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-ResourceId

Id van de resource die is gemaakt voor of volledige resource-id van het herstel.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DeleteByResourceId
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Scope

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

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DeleteByScope
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-SubscriptionId

De ID van het doelabonnement. Gebruikt het huidige abonnement als er geen abonnement is opgegeven.

Parametereigenschappen

Type:String
Default value:(Get-AzContext).Subscription.Id
Ondersteunt jokertekens:False
DontShow:False

Parametersets

DeleteBySubscriptionId
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False
DeleteByResourceGroup
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-WhatIf

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

Parametereigenschappen

Type:SwitchParameter
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

IPolicyInsightsIdentity

Uitvoerwaarden

Boolean