Freigeben über

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.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Das Attestation-Objekt.

Typ:PSAttestation
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Ressourcenname.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PassThru

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Ressourcengruppenname

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceId

Ressourcen-ID

Typ:String
Aliase:Id
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Scope

Bereich der Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{rgName}".

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String

PSAttestation

Ausgaben

Boolean