Read-Host

Lee una línea de entrada de la consola.

Sintaxis

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

Descripción

El cmdlet Read-Host lee una línea de entrada de la consola. Este cmdlet se puede usar para solicitar al usuario que proporcione datos. Dado que la entrada se puede guardar como una cadena segura, este cmdlet puede usarse para solicitar a los usuarios que proporcionen datos seguros, como contraseñas, así como datos compartidos.

Parámetros

-AsSecureString

Muestra asteriscos (*) en lugar de los caracteres que el usuario escribe.

Cuando se usa este parámetro, el resultado del cmdlet Read-Host es un objeto SecureString (System.Security.SecureString).

¿Requerido?	false
¿Posición?	named
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

-Prompt <Object>

Especifica el texto de la solicitud. Escriba una cadena. Si la cadena contiene espacios, escríbala entre comillas. Por ejemplo, "Type an integer: ".

¿Requerido?	false
¿Posición?	1
Valor predeterminado
¿Aceptar canalización?	false
¿Aceptar caracteres comodín?	false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Ninguno

No se pueden canalizar entradas a este cmdlet.

Salidas

System.String o System.Security.SecureString

Si se utiliza el parámetro AsSecureString, Read-Host devuelve un objeto SecureString. De lo contrario, devolverá una cadena.

Ejemplo 1

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

Descripción
-----------
Este comando muestra la cadena "Please enter your age:" como un mensaje de solicitud de datos. Cuando se escribe un valor y se presiona la tecla ENTRAR, el valor se almacena en la variable $age.

Ejemplo 2

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

Descripción
-----------
Este comando muestra la cadena "Enter a Password:" como un mensaje de solicitud de datos. Cuando se escribe un valor, en la consola aparecen asteriscos (*) en lugar del texto que se ha escrito. Cuando se presiona la tecla ENTRAR, se almacena el valor como un objeto SecureString en la variable $pwd_secure_string.