Get-Secret

Referensi

Modul:: Microsoft.PowerShell.SecretManagement

Menemukan dan mengembalikan rahasia berdasarkan nama dari vault terdaftar.

Sintaks

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

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

Deskripsi

Cmdlet ini menemukan dan mengembalikan rahasia pertama yang cocok dengan nama yang disediakan. Jika nama vault ditentukan, hanya vault yang dicari. Jika tidak, ia mencari semua vault dan mengembalikan hasil pencocokan pertama. Jika registri vault memiliki vault default, cmdlet akan mencari vault tersebut sebelum vault terdaftar lainnya. Rahasia yang merupakan jenis String atau SecureString dikembalikan sebagai objek SecureString secara default.

Contoh

Contoh 1

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

System.Security.SecureString
PlainTextSecretString

Contoh ini mencari rahasia dengan nama Secret1, yang merupakan rahasia jenis String . Perintah pertama mengembalikan rahasia sebagai objek SecureString . Perintah kedua menggunakan parameter AsPlainText untuk mengembalikan rahasia sebagai objek String sebagai gantinya, ditampilkan di konsol sebagai teks biasa.

Contoh 2

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

Contoh ini mengambil informasi rahasia untuk rahasia bernama Secret2 dalam vault bernama SecretStore. Kemudian mengirimkan hasilnya melalui alur ke Get-Secret, yang mencari rahasia dan mengembalikannya sebagai teks biasa.

Parameter

-AsPlainText

Menentukan bahwa rahasia yang jenisnya adalah String atau SecureString harus dikembalikan sebagai String (dalam teks biasa) alih-alih SecureString. Jika rahasia yang diambil bukan String atau SecureString, parameter ini tidak berpengaruh.

Perhatian

Untuk memastikan keamanan, Anda harus menghindari penggunaan string teks biasa jika memungkinkan.

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

-InputObject

Menentukan objek SecretInformation yang mewakili rahasia vault alih-alih menentukan parameter Nama dan Vault . Anda bisa mendapatkan objek SecretInformation dengan Get-SecretInfo cmdlet .

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

-Name

Menentukan nama rahasia yang akan diambil. Karakter kartubebas tidak diizinkan.

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

-Vault

Menentukan nama vault terdaftar untuk mengambil rahasia. Jika tidak ada nama vault yang ditentukan, maka semua vault terdaftar akan dicari. Jika registri vault memiliki vault default dan parameter ini tidak ditentukan, maka vault default dicari sebelum vault terdaftar lainnya.

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

Input

String

Microsoft.PowerShell.SecretManagement.SecretInformation

Output

Object

Bagikan melalui