다음을 통해 공유

Read-Host

모듈:
Microsoft.PowerShell.Utility Module

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

구문

Default (기본값) 

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

Description

읽기 호스트 cmdlet은 콘솔에서 입력 줄을 읽습니다. 이를 사용하여 사용자에게 입력을 요청하는 메시지를 표시할 수 있습니다. 입력을 보안 문자열로 저장할 수 있으므로 이 cmdlet을 사용하여 사용자에게 암호와 같은 보안 데이터와 공유 데이터를 묻는 메시지를 표시할 수 있습니다.

예제

예제 1: 변수에 콘솔 입력 저장

PS C:\> $Age = Read-Host "Please enter your age"

이 명령은 프롬프트로 "나이 입력하세요:" 문자열을 표시합니다. 값을 입력하고 Enter 키를 누르면 값이 $Age 변수에 저장됩니다.

예제 2: 콘솔 입력을 보안 문자열로 저장

PS C:\> $pwd_secure_string = Read-Host "Enter a Password" -AsSecureString

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

매개 변수

-AsSecureString

사용자가 입력으로 입력하는 문자 대신 별표(*)가 cmdlet에 표시됨을 나타냅니다.

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

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Prompt

프롬프트의 텍스트를 지정합니다. 문자열을 입력합니다. 문자열에 공백이 포함된 경우 따옴표로 묶습니다. Windows PowerShell은 입력한 텍스트에 콜론(:) 추가합니다.

매개 변수 속성

형식:Object
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

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

출력

System.String or System.Security.SecureString

AsSecureString 매개 변수를 사용하는 경우 Read-HostSecureString반환합니다. 그렇지 않으면 문자열을 반환합니다.