Get-Secret

Başvuru

Modül:: Microsoft.PowerShell.SecretManagement

Kayıtlı kasalardan ada göre bir gizli dizi bulur ve döndürür.

Syntax

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

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

Description

Bu cmdlet, sağlanan adla eşleşen ilk gizli diziyi bulur ve döndürür. Bir kasa adı belirtilirse, yalnızca o kasada arama yapılır. Aksi takdirde, tüm kasalarda arama yapıp eşleşen ilk sonucu döndürür. Kasa kayıt defterinin varsayılan kasası varsa, cmdlet bu kasayı diğer kayıtlı kasadan önce arar. String veya SecureString türleri olan gizli diziler varsayılan olarak SecureString nesneleri olarak döndürülür.

Örnekler

Örnek 1

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

System.Security.SecureString
PlainTextSecretString

Bu örnek, Dize türü gizli dizi olan adlı Secret1gizli diziyi arar. İlk komut gizli diziyi SecureString nesnesi olarak döndürür. İkinci komut, gizli diziyi dize nesnesi olarak döndürmek için AsPlainText parametresini kullanır ve konsolda düz metin olarak görüntülenir.

Örnek 2

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

Bu örnek, adlı SecretStorekasada adlı Secret2 gizli dizi için gizli dizi bilgilerini alır. Ardından, ardışık düzen aracılığıyla sonucu dizinine Get-Secretgönderir ve gizli diziyi arar ve düz metin olarak döndürür.

Parametreler

-AsPlainText

Türü String veya SecureString olan bir gizli dizinin SecureString yerine Dize (düz metin) olarak döndürülmesi gerektiğini belirtir. Alınan gizli dizi bir String veya SecureString değilse, bu parametrenin hiçbir etkisi yoktur.

Dikkat

Güvenliği sağlamak için mümkün olduğunca düz metin dizeleri kullanmaktan kaçınmanız gerekir.

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

-InputObject

Name ve Vault parametrelerini belirtmek yerine bir kasa gizli dizisini temsil eden secretInformation nesnesini belirtir. Cmdlet'iyle Get-SecretInfo bir SecretInformation nesnesi alabilirsiniz.

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

-Name

Alınacak gizli dizinin adını belirtir. Joker karakterlere izin verilmez.

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

-Vault

Gizli diziyi almak için kayıtlı kasanın adını belirtir. Kasa adı belirtilmezse tüm kayıtlı kasalarda arama yapılır. Kasa kayıt defteri varsayılan bir kasaya sahipse ve bu parametre belirtilmemişse, varsayılan kasa diğer kayıtlı kasalardan önce aranıyor demektir.

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

Girişler

String

Microsoft.PowerShell.SecretManagement.SecretInformation

Çıkışlar

Object

Aracılığıyla paylaş