콘솔에서 입력 줄을 읽습니다.

구문

Read-Host [[-Prompt] <Object>] [-AsSecureString] [<CommonParameters>]

설명

Read-Host cmdlet은 콘솔의 출력 줄을 읽습니다. 사용자에게 입력하도록 요청하는 메시지를 표시하는 데 이 cmdlet을 사용할 수 있습니다. 입력은 보안 문자열로 저장할 수 있으므로 이 cmdlet을 사용하여 암호 등의 보안 데이터와 공유 데이터를 입력하라는 메시지를 사용자에게 표시할 수 있습니다.

매개 변수

-AsSecureString

사용자가 입력하는 문자 대신 별표(*)를 표시합니다.

이 매개 변수를 사용하는 경우 Read-Host cmdlet의 출력은 SecureString 개체(System.Security.SecureString)가 됩니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Prompt <Object>

표시되는 메시지의 텍스트를 지정합니다. 문자열을 입력합니다. 문자열에 공백이 포함된 경우에는 문자열을 따옴표로 묶어야 합니다. 예를 들어 "Type an integer: "입니다.

필수 여부

false

위치

1

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

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

입력 및 출력

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

입력

없음

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

출력

System.String 또는 System.Security.SecureString

AsSecureString 매개 변수를 사용하는 경우 Read-Host는 SecureString을 반환하고 그 외의 경우에는 문자열을 반환합니다.

예 1

C:\PS>$age = read-host "Please enter your age:"

설명
-----------
이 명령은 "Please enter your age:" 문자열을 프롬프트로 표시합니다. 값을 입력하고 Enter 키를 누르면 값이 $age 변수에 저장됩니다.






예 2

C:\PS>$pwd_secure_string = read-host "Enter a Password:" -assecurestring

설명
-----------
이 명령은 "Enter a Password:" 문자열을 프롬프트로 표시합니다. 값을 입력할 때는 입력 값 대신 별표(*)가 콘솔에 표시됩니다. Enter 키를 누르면 이 값이 $pwd_secure_string 변수에 SecureString 개체로 저장됩니다.






참고 항목




목차