Remove-AzPolicyAttestation

  • Referenz
Modul:
Az.PolicyInsights

Löscht einen Richtliniennachweis.

Syntax

Remove-AzPolicyAttestation
      -Name <String>
      [-Scope <String>]
      [-ResourceGroupName <String>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicyAttestation
      -ResourceId <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzPolicyAttestation
      -InputObject <PSAttestation>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Cmdlet Remove-AzPolicyAttestation löscht einen Richtliniennachweis.

Beispiele

Beispiel 1: Löschen einer Richtlinienbehebung anhand des Namens im Abonnementbereich.

Set-AzContext -Subscription "d1acb22b-c876-44f7-b08e-3fcf9f6767f4"
Remove-AzPolicyAttestation -Name "attestation-subscription" -PassThru

True

Mit diesem Befehl wird der Nachweis mit dem Namen "attestation-subscription" im Abonnement "d1acb22b-c876-44f7-b08e-3fcf9f6767f4" gelöscht. Der -PassThru Switch erzwingt das Cmdlet, den Status des Vorgangs zurückzugeben.

Beispiel 2: Löschen einer Richtlinienbehebung über die Rohrleitung in der Ressourcengruppe.

$rgName = "ps-attestation-test-rg"
Get-AzPolicyAttestation -Name "attestation-RG" -ResourceGroupName $rgName | Remove-AzPolicyAttestation

Mit diesem Befehl wird der Nachweis mit dem Namen "attestation-RG" in der Ressourcengruppe "ps-attestation-test-rg" mithilfe des Vom Cmdlet Get-AzPolicyAttestation angegebenen Eingabeobjekts gelöscht.

Beispiel 3: Löschen einer Richtlinienbehebung mithilfe von ResourceId.

$scope = "/subscriptions/d1acb22b-c876-44f7-b08e-3fcf9f6767f4/resourceGroups/ps-attestation-test-rg/providers/Microsoft.Network/networkSecurityGroups/pstests0"
$attestationToDelete = Get-AzPolicyAttestation -Name "attestation-resource" -Scope $scope
Remove-AzPolicyAttestation -Id $attestationToDelete.Id

Der erste Befehl ruft einen Nachweis mit dem Namen "attestation-resource" mit einer Ressourcen-ID ab, die als Bereich angegeben ist. Der zweite Befehl löscht dann den Nachweis mithilfe der Ressourcen-ID des gespeicherten Nachweises.

Parameter

-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

-InputObject

Das Attestation-Objekt.

Type:PSAttestation
Position:Named
Default value:None
Required:True
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

-PassThru

Gibt True zurück, wenn der Befehl erfolgreich abgeschlossen wurde.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

PSAttestation

Ausgaben

Boolean