콘솔에서 입력 줄을 읽습니다.
구문
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 개체로 저장됩니다.
참고 항목