Get-Secret

Referens

Modul:: Microsoft.PowerShell.SecretManagement

Söker efter och returnerar en hemlighet efter namn från registrerade valv.

Syntax

Get-Secret
   [-Name] <String>
   [[-Vault] <String>]
   [-AsPlainText]
   [<CommonParameters>]

Get-Secret
   [-InputObject] <SecretInformation>
   [-AsPlainText]
   [<CommonParameters>]

Description

Den här cmdleten hittar och returnerar den första hemligheten som matchar det angivna namnet. Om ett valvnamn anges genomsöks endast det valvet. Annars söker den igenom alla valv och returnerar det första matchande resultatet. Om valvregistret har ett standardvalv söker cmdleten igenom valvet före ett annat registrerat valv. Hemligheter som är sträng - eller SecureString-typer returneras som standard som SecureString-objekt .

Exempel

Exempel 1

Get-Secret -Name Secret1 -Vault CredMan
Get-Secret -Name Secret1 -Vault CredMan -AsPlainText

System.Security.SecureString
PlainTextSecretString

Det här exemplet söker efter en hemlighet med namnet Secret1, som är en strängtypshemlighet . Det första kommandot returnerar hemligheten som ett SecureString-objekt . Det andra kommandot använder parametern AsPlainText för att returnera hemligheten som ett String-objekt i stället och visas i konsolen som oformaterad text.

Exempel 2

Get-SecretInfo -Name Secret2 -Vault SecretStore | Get-Secret -AsPlainText

Det här exemplet hämtar hemlig information för hemligheten med namnet Secret2 i valvet med namnet SecretStore. Resultatet skickas sedan via pipelinen till Get-Secret, som söker efter hemligheten och returnerar den som oformaterad text.

Parametrar

-AsPlainText

Anger att en hemlighet vars typ är String eller SecureString ska returneras som en Sträng (i oformaterad text) i stället för en SecureString. Om hemligheten som hämtas inte är en Sträng eller SecureString har den här parametern ingen effekt.

Varning

För att säkerställa säkerheten bör du undvika att använda strängar i klartext när det är möjligt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Anger ett SecretInformation-objekt som representerar en valvhemlighet i stället för att ange parametrarna Namn och Valv . Du kan hämta ett SecretInformation-objekt med cmdleten Get-SecretInfo .

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

-Name

Anger namnet på hemligheten som ska hämtas. Jokertecken tillåts inte.

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

-Vault

Anger namnet på det registrerade valvet som hemligheten ska hämtas från. Om inget valvnamn anges genomsöks alla registrerade valv. Om valvregistret har ett standardvalv och den här parametern inte anges genomsöks standardvalvet före de andra registrerade valven.

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

Indata

String

Microsoft.PowerShell.SecretManagement.SecretInformation

Utdata

Object

Share via