Get-Secret

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 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 andra registrerade valv. Hemligheter som eller SecureString--typer returneras som SecureString- objekt som standard.

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 hemlighet av typen String type. 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. Sedan skickas resultatet 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 String (i oformaterad text) i stället för en SecureString-. Om hemligheten som hämtas inte är en String eller SecureStringhar den här parametern ingen effekt.

Försiktighet

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

Typ:	SwitchParameter
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-InputObject

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

Typ:	SecretInformation
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	False

-Name

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

Typ:	String
Position:	0
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	True
Godkänn jokertecken:	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 har angetts genomsöks standardvalvet före de andra registrerade valven.

Typ:	String
Position:	1
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

String

Microsoft.PowerShell.SecretManagement.SecretInformation

Utdata

Object