Remove-Secret
從指定的已註冊擴充保存庫移除秘密。
Syntax
Remove-Secret
[-Name] <String>
[-Vault] <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Remove-Secret
[-InputObject] <SecretInformation>
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
依名稱從已註冊的擴充保存庫移除秘密。 必須同時提供秘密名稱和擴充功能保存庫名稱。
範例
範例 1
Remove-Secret -Name secretTest -Vault CredMan
Get-Secret -Name secretTest -Vault CredMan
Get-Secret: The secret secretTest was not found.此範例會從 CredMan 保存 secretTest 庫移除秘密。 Get-Secret命令會驗證秘密已不存在於保存庫中。
範例 2
Get-SecretInfo -Name Secret2 -Vault CredMan | Remove-Secret
Get-Secret -Name Secret2 -Vault CredMan
Get-Secret: The secret Secret2 was not found.此範例會從 CredMan 保存 Secret2 庫移除秘密。 Get-SecretInfo 擷取秘密的資訊，並透過管線將結果傳送至 Remove-Secret 。
Get-Secret 驗證秘密已不存在於保存庫中。
參數
-Confirm
在執行 Cmdlet 前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定描述保存庫秘密 的 SecretInformation 物件。
| Type: | SecretInformation |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
指定要移除的秘密名稱。 不允許萬用字元 (*) 。
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Vault
指定要從中移除秘密的保存庫名稱。 不允許萬用字元 (*) 。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
Microsoft.PowerShell.SecretManagement.SecretInformation
輸出
None
