Get-Secret

참조

모듈:: Microsoft.PowerShell.SecretManagement

등록된 자격 증명 모음에서 이름으로 비밀을 찾아 반환합니다.

Syntax

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

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

Description

이 cmdlet은 제공된 이름과 일치하는 첫 번째 비밀을 찾아 반환합니다. 자격 증명 모음 이름을 지정하면 해당 자격 증명 모음만 검색됩니다. 그렇지 않으면 모든 자격 증명 모음을 검색하고 일치하는 첫 번째 결과를 반환합니다. 자격 증명 모음 레지스트리에 기본 자격 증명 모음이 있는 경우 cmdlet은 등록된 다른 자격 증명 모음 앞에 해당 자격 증명 모음을 검색합니다. String 또는 SecureString 형식인 비밀은 기본적으로 SecureString 개체로 반환됩니다.

예제

예 1

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

System.Security.SecureString
PlainTextSecretString

다음은 문자열 형식 비밀인 이름이 Secret1인 비밀을 검색하는 예제입니다. 첫 번째 명령은 비밀을 SecureString 개체로 반환합니다. 두 번째 명령은 AsPlainText 매개 변수를 사용하여 비밀을 String 개체로 반환하고 콘솔에 일반 텍스트로 표시합니다.

예 2

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

이 예제에서는 라는 SecretStore자격 증명 모음에서 라는 Secret2 비밀에 대한 비밀 정보를 검색합니다. 그런 다음, 파이프라인 Get-Secret을 통해 결과를 로 보내 비밀을 검색하고 일반 텍스트로 반환합니다.

매개 변수

-AsPlainText

String 또는 SecureString 형식의 비밀이 SecureString 대신 문자열(일반 텍스트)으로 반환되도록 지정합니다. 검색되는 비밀이 String 또는 SecureString이 아닌 경우 이 매개 변수는 적용되지 않습니다.

주의

보안을 보장하려면 가능하면 일반 텍스트 문자열을 사용하지 않아야 합니다.

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

-InputObject

Name및 Vault 매개 변수를 지정하는 대신 자격 증명 모음 비밀을 나타내는 SecretInformation 개체를 지정합니다. cmdlet을 사용하여 SecretInformation 개체를 Get-SecretInfo 가져올 수 있습니다.

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

-Name

검색할 비밀의 이름을 지정합니다. 와일드카드 문자는 사용할 수 없습니다.

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

-Vault

비밀을 검색할 등록된 자격 증명 모음의 이름을 지정합니다. 자격 증명 모음 이름을 지정하지 않으면 등록된 모든 자격 증명 모음이 검색됩니다. 자격 증명 모음 레지스트리에 기본 자격 증명 모음이 있고 이 매개 변수가 지정되지 않은 경우 등록된 다른 자격 증명 모음 앞에 기본 자격 증명 모음이 검색됩니다.

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

입력

String

Microsoft.PowerShell.SecretManagement.SecretInformation

출력

Object

Share via