Get-Secret

Reference

Modul:: Microsoft.PowerShell.SecretManagement

Vyhledá a vrátí tajný kód podle názvu z registrovaných trezorů.

Syntax

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

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

Description

Tato rutina vyhledá a vrátí první tajný kód, který odpovídá zadanému názvu. Pokud zadáte název trezoru, prohledá se jenom tento trezor. V opačném případě prohledá všechny trezory a vrátí první odpovídající výsledek. Pokud má registr trezoru výchozí trezor, rutina prohledá tento trezor před jakýmkoli jiným zaregistrovaným trezorem. Tajné kódy typu String nebo SecureString jsou ve výchozím nastavení vráceny jako securestring objekty.

Příklady

Příklad 1

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

System.Security.SecureString
PlainTextSecretString

Tento příklad vyhledá tajný kód s názvem Secret1, což je tajný klíč typu Řetězec . První příkaz vrátí tajný kód jako SecureString objektu. Druhý příkaz používá parametr AsPlainText k vrácení tajného kódu jako objektu String , který se v konzole zobrazí jako prostý text.

Příklad 2

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

Tento příklad načte informace o tajném kódu s názvem Secret2 v trezoru s názvem SecretStore. Potom odešle výsledek prostřednictvím kanálu do Get-Secret, který vyhledá tajný kód a vrátí ho jako prostý text.

Parametry

-AsPlainText

Určuje, že tajný kód, jehož typ je String nebo SecureString , by měl být vrácen jako String (ve formátu prostého textu) namísto SecureString. Pokud načítaný tajný klíč není String nebo SecureString, nemá tento parametr žádný vliv.

Upozornění

Pokud chcete zajistit zabezpečení, měli byste se vyhnout používání řetězců ve formátu prostého textu, kdykoli je to možné.

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

-InputObject

Určuje SecretInformation objekt představující tajný klíč trezoru namísto zadání Name a Vault parametry. Objekt SecretInformation můžete získat pomocí rutiny Get-SecretInfo .

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

-Name

Určuje název tajného kódu, který se má načíst. Zástupné znaky nejsou povoleny.

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

-Vault

Určuje název registrovaného trezoru, ze které se má tajný kód načíst. Pokud není zadaný název trezoru, prohledá se všechny zaregistrované trezory. Pokud má registr trezoru výchozí trezor a tento parametr není zadaný, prohledá se výchozí trezor před ostatními zaregistrovanými trezory.

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

Vstupy

String

Microsoft.PowerShell.SecretManagement.SecretInformation

Výstupy

Object

Sdílet prostřednictvím