Compartilhar via


Remove-Secret

Remove um segredo de um cofre de extensão registrado especificado.

Sintaxe

NameParameterSet (Padrão)

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

InfoParameterSet

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

Description

Remove um segredo pelo nome de um cofre de extensão registrado. O nome do segredo e o nome do cofre de extensão devem ser fornecidos.

Exemplos

Exemplo 1

Remove-Secret -Name secretTest -Vault CredMan
Get-Secret -Name secretTest -Vault CredMan
Get-Secret: The secret secretTest wasn't found.

Este exemplo remove o segredo secretTest do cofre de CredMan. O comando Get-Secret verifica se o segredo não existe mais no cofre.

Exemplo 2

Get-SecretInfo -Name Secret2 -Vault CredMan | Remove-Secret
Get-Secret -Name Secret2 -Vault CredMan
Get-Secret: The secret Secret2 wasn't found.

Este exemplo remove o segredo Secret2 do cofre de CredMan. Get-SecretInfo recupera as informações do segredo e envia o resultado por meio do pipeline para Remove-Secret. Get-Secret verifica se o segredo não existe mais no cofre.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-InputObject

Especifica um objeto SecretInformation que descreve um segredo do cofre.

Propriedades do parâmetro

Tipo:Microsoft.PowerShell.SecretManagement.SecretInformation
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

InfoParameterSet
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome do segredo a ser removido. Caracteres curinga (*) não são permitidos.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NameParameterSet
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Vault

Especifica o nome do cofre do qual remover o segredo. Caracteres curinga (*) não são permitidos.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NameParameterSet
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Microsoft.PowerShell.SecretManagement.SecretInformation

Saídas

None