Partilhar via


Remove-Secret

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

Sintaxe

NameParameterSet (Predefiniçã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 secreto 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 de secretTest do cofre 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 de Secret2 do cofre CredMan. Get-SecretInfo recupera as informações para o segredo e envia o resultado através do pipeline para Remove-Secret. Get-Secret verifica se o segredo não existe mais no cofre.

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-InputObject

Especifica um objeto SecretInformation que descreve um segredo do cofre.

Propriedades dos parâmetros

Tipo:Microsoft.PowerShell.SecretManagement.SecretInformation
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

InfoParameterSet
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NameParameterSet
Position:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Vault

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

NameParameterSet
Position:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-WhatIf

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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