Remove-Secret

Referenz

Modul:: Microsoft.PowerShell.SecretManagement

Entfernt ein Geheimnis aus einem angegebenen registrierten Erweiterungstresor.

Syntax

Remove-Secret
      [-Name] <String>
      [-Vault] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-Secret
      [-InputObject] <SecretInformation>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Entfernt ein Geheimnis anhand des Namens aus einem registrierten Erweiterungstresor. Sowohl der Geheimnisname als auch der Erweiterungstresorname müssen angegeben werden.

Beispiele

Beispiel 1

Remove-Secret -Name secretTest -Vault CredMan
Get-Secret -Name secretTest -Vault CredMan

Get-Secret: The secret secretTest was not found.

In diesem Beispiel wird das secretTest Geheimnis aus dem CredMan Tresor entfernt. Der Get-Secret Befehl überprüft, ob das Geheimnis nicht mehr im Tresor vorhanden ist.

Beispiel 2

Get-SecretInfo -Name Secret2 -Vault CredMan | Remove-Secret
Get-Secret -Name Secret2 -Vault CredMan

Get-Secret: The secret Secret2 was not found.

In diesem Beispiel wird das Secret2 Geheimnis aus dem CredMan Tresor entfernt. Get-SecretInfo ruft die Informationen für das Geheimnis ab und sendet das Ergebnis über die Pipeline an Remove-Secret. Get-Secret überprüft, ob das Geheimnis nicht mehr im Tresor vorhanden ist.

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

-InputObject

Gibt ein SecretInformation-Objekt an, das ein Tresorgeheimnis beschreibt.

Type:	SecretInformation
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Gibt den Namen des zu entfernenden Geheimnisses an. Wildcardzeichen (*) sind nicht zulässig.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Vault

Gibt den Namen des Tresors an, aus dem das Geheimnis entfernt werden soll. Wildcardzeichen (*) sind nicht zulässig.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
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

Microsoft.PowerShell.SecretManagement.SecretInformation

Ausgaben

None

Freigeben über