从控制台读取一行输入。
语法
Read-Host [[-Prompt] <Object>] [-AsSecureString] [<CommonParameters>]
说明
Read-Host 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 所返回对象的类型。
|
输入 |
None 不能通过管道将输入传递给此 cmdlet。 |
|
输出 |
System.String or 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 键时，值将作为 SecureString 对象存储在 $pwd_secure_string 变量中。
另请参阅