Get-Secret

Reference

Modul:: Microsoft.PowerShell.SecretManagement

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

Syntaxe

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 je zadán název úložiště, bude prohledán pouze 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 registrovaným trezorem. Tajné kódy, které jsou typu String nebo SecureString , jsou ve výchozím nastavení vráceny jako objekty SecureString .

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ý klíč s názvem Secret1, což je tajný klíč typu String . První příkaz vrátí tajný kód jako objekt SecureString . Druhý příkaz používá parametr AsPlainText k vrácení tajného klíče 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 tajné informace pro tajný klíč pojmenovaný Secret2 v úložišti s názvem SecretStore. Výsledek pak odešle kanálem do Get-Secretprogramu , který vyhledá tajný klíč a vrátí jej 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ý kód není String nebo SecureString, nemá tento parametr žádný vliv.

Upozornění

Z důvodu zajištění bezpečnosti byste se měli pokud možno vyvarovat používání řetězců ve formátu prostého textu.

Typ:	SwitchParameter
Position:	Named
Default value:	False
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-InputObject

Určuje objekt SecretInformation představující tajný klíč úložiště namísto zadání parametrů Name a Vault . Pomocí rutiny Get-SecretInfo můžete získat objekt SecretInformation.

Typ:	Microsoft.PowerShell.SecretManagement.SecretInformation
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Určuje název tajného klíče, který se má načíst. Zástupné znaky nejsou povolené.

Typ:	String
Position:	0
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Vault

Určuje název registrovaného trezoru, ze kterého se má tajný klíč načíst. Pokud není zadán žádný název úložiště, budou prohledány všechny registrované úložiště. Pokud má registr trezoru výchozí trezor a tento parametr není zadaný, bude výchozí trezor prohledán před ostatními registrovanými trezory.

Typ:	String
Position:	1
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

String

Microsoft.PowerShell.SecretManagement.SecretInformation

Výstupy

Object

Sdílet prostřednictvím