Compartir a través de

Read-Host

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Lee una línea de entrada de la consola.

Sintaxis

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

Description

El cmdlet Read-Host lee una línea de entrada desde la consola. Puede usarlo para solicitar una entrada a un usuario. Dado que puede guardar la entrada como una cadena segura, puede usar este cmdlet para solicitar a los usuarios datos seguros, como contraseñas, así como datos compartidos.

Ejemplos

Ejemplo 1: Guardar la entrada de la consola en una variable

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

Este comando muestra la cadena "Escriba su edad:" como símbolo del sistema. Cuando se escribe un valor y se presiona la tecla Entrar, el valor se almacena en la variable $Age.

Ejemplo 2: Guardar la entrada de la consola como una cadena segura

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

Este comando muestra la cadena "Escribir una contraseña:" como símbolo del sistema. A medida que se especifica un valor, asteriscos (*) aparecen en la consola en lugar de la entrada. Cuando se presiona la tecla Entrar, el valor se almacena como un objeto SecureString en la variable $pwd_secure_string.

Parámetros

-AsSecureString

Indica que el cmdlet muestra asteriscos (*) en lugar de los caracteres que el usuario escribe como entrada.

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

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Prompt

Especifica el texto del símbolo del sistema. Escriba una cadena. Si la cadena incluye espacios, escríbalo entre comillas. Windows PowerShell anexa dos puntos (:) al texto que escriba.

Tipo:Object
Posición:0
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

No se puede canalizar la entrada a este cmdlet.

Salidas

System.String or System.Security.SecureString

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