사용자 이름 및 암호를 기반으로 자격 증명 개체를 가져옵니다.

구문

Get-Credential [-Credential] <PSCredential> [<CommonParameters>]

설명

Get-Credential cmdlet은 지정된 사용자 이름 및 암호에 대한 자격 증명 개체를 만듭니다. 보안 작업에서 자격 증명 개체를 사용할 수 있습니다.

이 cmdlet은 암호 또는 사용자 이름과 암호를 묻는 메시지를 표시합니다. 메시지는 시스템 레지스트리 설정에 따라 대화 상자나 명령줄에 표시됩니다.

매개 변수

-Credential <PSCredential>

자격 증명에 대한 사용자 이름(예: "User01" 또는 "Domain01\User01")을 지정합니다. 매개 변수 이름("Credential")은 선택 사항입니다.

명령을 전송하면 암호를 묻는 메시지가 표시됩니다.

도메인 없이 사용자 이름을 입력하면 Get-Credential이 이름 앞에 백슬래시를 삽입합니다.

이 매개 변수를 생략하면 사용자 이름 및 암호를 묻는 메시지가 표시됩니다.

필수 여부

true

위치

1

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

없음

입력을 이 cmdlet으로 파이프할 수 없습니다.

출력

System.Management.Automation.PSCredential

Get-Credential은 자격 증명 개체를 반환합니다.

참고

사용자 인증을 요청하는 cmdlet(예: Credential 매개 변수를 사용하는 cmdlet)에서 Get-Credential이 만든 PSCredential 개체를 사용할 수 있습니다.

Credential 매개 변수는 Windows PowerShell과 함께 설치된 공급자에서 지원되지 않습니다. 그러나 Get-WmiObject에서는 Microsoft .NET Framework를 직접 호출하므로 Credential 매개 변수를 사용할 수 있습니다.

예 1

C:\PS>$c = Get-Credential

설명
-----------
이 명령은 자격 증명 개체를 가져와서 $c 변수에 저장합니다. 

명령을 입력하면 사용자 이름 및 암호를 요청하는 대화 상자가 나타납니다. 요청된 정보를 입력하면 cmdlet이 사용자의 자격 증명을 나타내는 PSCredential 개체를 만들어 $c 변수에 저장합니다. 

사용자 인증을 요청하는 cmdlet(예: Credential 매개 변수를 사용하는 cmdlet)의 입력으로 이 개체를 사용할 수 있습니다. 그러나 Windows PowerShell과 함께 설치된 공급자에서는 Credential 매개 변수가 지원되지 않습니다.

예 2

C:\PS>$c = Get-Credential

C:\PS>Get-WmiObject Win32_DiskDrive -ComputerName Server01 -Credential $c

설명
-----------
이들 명령은 Get-Credential에서 가져온 자격 증명 개체를 사용하여 원격 컴퓨터에서 사용자를 인증하므로 WMI(Windows Management Instrumentation)를 사용하여 컴퓨터를 관리할 수 있습니다.

첫 번째 명령은 자격 증명 개체를 가져와서 $c 변수에 저장합니다. 두 번째 명령은 Get-WmiObject 명령에서 자격 증명 개체를 사용합니다. 이 명령은 Server01 컴퓨터의 디스크 드라이브 정보를 가져옵니다.

예 3

C:\PS>C:\PS>Get-WmiObject Win32_BIOS -ComputerName Server01 '
-Credential (get-credential Domain01\User01)

설명
-----------
이 명령은 Get-WmiObject 명령에 Get-Credential 명령을 포함하는 방법을 보여 줍니다.

이 명령은 Get-WmiObject cmdlet을 사용하여 Server01 컴퓨터의 BIOS 정보를 가져오고, Credential 매개 변수를 사용하여 사용자(Domain01\User01)를 인증하며 Get-Credential 명령을 Credential 매개 변수 값으로 사용합니다.

예 4

C:\PS>$c = Get-Credential -credential User01

C:\PS>$c.Username

\User01

설명
-----------
이 예에서는 도메인 이름이 없는 사용자 이름을 포함하는 자격 증명을 만들며, Get-Credential이 사용자 이름 앞에 백슬래시를 삽입함을 보여 줍니다.

첫 번째 명령은 사용자 이름(User01)이 포함된 자격 증명을 가져와서 $c 변수에 저장합니다.

두 번째 명령은 첫 번째 명령의 결과로 생성된 자격 증명 개체의 Username 속성 값을 표시합니다.

예 5

C:\PS>$credential = $host.ui.PromptForCredential("Need credentials", "Please enter your user name and password.", "", "NetBiosUserName")

설명
-----------
이 명령은 PromptForCredential 메서드를 사용하여 사용자 이름 및 암호를 묻는 메시지를 표시하고 그 결과로 생성되는 자격 증명을 $credential 변수에 저장합니다.

PromptForCredential을 Get-Credential 대신 사용할 수 있습니다. PromptForCredential을 사용하는 경우 메시지 상자에 표시되는 캡션, 메시지 및 사용자 이름을 지정할 수 있습니다.

예 6

C:\PS>Set-ItemProperty 'HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds' ConsolePrompting $true

설명
-----------
사용자 이름 및 암호를 입력해야 하는 경우에는 사용자에게 해당 정보를 묻는 대화 상자가 기본적으로 표시됩니다. 해당 메시지가 명령줄에 표시되도록 하려면 이 명령을 Windows PowerShell에서 관리자로 실행하여 레지스트리를 수정합니다.

메시지가 대화 상자에 표시되도록 하려면 동일한 명령에 "ConsolePrompting $false"를 사용하면 됩니다.



목차