다음을 통해 공유

Read-Host

모듈:
Microsoft.PowerShell.Utility Module

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

구문

AsString (기본값) 

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

AsSecureString 

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

Description

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

비고

Read-Host 사용자의 입력으로 수락할 수 있는 1022자의 제한이 있습니다.

예제

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

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

$Age = Read-Host "Please enter your age"

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

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

$pwd_secure_string = Read-Host "Enter a Password" -AsSecureString

예제 3: 마스크 입력 및 일반 텍스트 문자열

다음은 "암호 입력:" 문자열을 프롬프트로 표시하는 예제입니다. 값을 입력할 때 입력 대신 별표(*)가 콘솔에 나타납니다. Enter 키를 누르면 값이 변수에 일반 텍스트 $pwd_string 개체로 저장됩니다.

$pwd_string = Read-Host "Enter a Password" -MaskInput

매개 변수

-AsSecureString

cmdlet에 사용자가 입력으로 입력하는 문자 대신 별표(*)가 표시됨을 나타냅니다. 이 매개 변수를 사용하는 경우 Read-Host cmdlet의 출력은 SecureString 개체(System.Security.SecureString)입니다.

매개 변수 속성

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

매개 변수 집합

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

-MaskInput

cmdlet에 사용자가 입력으로 입력하는 문자 대신 별표(*)가 표시됨을 나타냅니다. 이 매개 변수를 사용하는 경우 Read-Host cmdlet의 출력은 String 개체입니다. 이렇게 하면 SecureString 대신 일반 텍스트로 반환되는 암호를 안전하게.

이 매개 변수는 PowerShell 7.1에 추가되었습니다.

매개 변수 속성

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

매개 변수 집합

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

-Prompt

프롬프트의 텍스트를 지정합니다. 문자열을 입력합니다. 문자열에 공백이 포함된 경우 따옴표로 묶습니다. 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은 PowerShell 파이프라인의 입력을 허용하지 않습니다.

출력

System.String or System.Security.SecureString

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

참고

이 cmdlet은 호스트 프로세스의 stdin 스트림에서만 읽습니다. 일반적으로 stdin 스트림은 호스트 콘솔의 키보드에 연결됩니다.