Read-Host
Lee una línea de entrada de la consola.
Sintaxis
Default (valor predeterminado)
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).
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | 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.
Propiedades de parámetro
| Tipo: | Object |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 0 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
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.