Read-Host
Legge una riga di input dalla console.
Sintassi
Default (Impostazione predefinita)
Read-Host
[[-Prompt] <Object>]
[-AsSecureString]
[<CommonParameters>]
Descrizione
Il cmdlet Read-Host legge una riga di input dalla console. È possibile usarlo per richiedere input a un utente. Poiché è possibile salvare l'input come stringa protetta, è possibile utilizzare questo cmdlet per richiedere agli utenti dati protetti, ad esempio password, nonché dati condivisi.
Esempio
Esempio 1: Salvare l'input della console in una variabile
PS C:\> $Age = Read-Host "Please enter your age"
Questo comando visualizza la stringa "Inserisci la tua età:" come prompt. Quando si immette un valore e si preme il tasto Invio, il valore viene memorizzato nella variabile $Age.
Esempio 2: Salvare l'input della console come stringa sicura
PS C:\> $pwd_secure_string = Read-Host "Enter a Password" -AsSecureString
Questo comando visualizza la stringa "Immettere una password:" come prompt. Quando viene immesso un valore, sulla console vengono visualizzati degli asterischi (*) al posto dell'input. Quando si preme il tasto INVIO, il valore viene archiviato come oggetto SecureString nella variabile $pwd_secure_string.
Parametri
-AsSecureString
Indica che il cmdlet visualizza asterischi (*) al posto dei caratteri digitati dall'utente come input.
Quando si utilizza questo parametro, l'output del cmdlet Read-Host è un oggetto SecureString (System.Security.SecureString).
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Prompt
Specifica il testo del prompt. Digitare una stringa. Se la stringa include spazi, racchiuderla tra virgolette. Windows PowerShell aggiunge i due punti (:) al testo immesso.
Proprietà dei parametri
| Tipo: | Object |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Non è possibile inviare tramite pipe l'input a questo cmdlet.
Output
System.String or System.Security.SecureString
Se viene utilizzato il parametro AsSecureString , Read-Host restituisce un oggetto SecureString. In caso contrario, restituisce una stringa.