Condividi tramite

Read-Host

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Legge una riga di input dalla console.

Sintassi

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

Descrizione

Il cmdlet Read-Host legge una riga di input dalla console. Può essere usato per richiedere l'input a un utente. Poiché è possibile salvare l'input come stringa sicura, è possibile usare questo cmdlet per richiedere agli utenti dati protetti, ad esempio una 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 "Please enter your age:" come richiesta. Quando viene immesso un valore e viene premuto il tasto INVIO, il valore viene archiviato 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 "Enter a Password:" come richiesta. Come si immette un valore, al posto dell'input nella console verranno visualizzati degli asterischi (*). 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 gli asterischi (*) al posto dei caratteri digitati dall'utente come input.

Quando si usa questo parametro, l'output del cmdlet Read-Host è un oggetto SecureString (System.Security.SecureString).

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prompt

Specifica il testo della richiesta. Digitare una stringa. Se la stringa include spazi, racchiuderla tra virgolette. Windows PowerShell aggiunge i due punti (:) al testo immesso.

Type:Object
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Non è possibile inviare input tramite pipe a questo cmdlet.

Output

System.String or System.Security.SecureString

Se viene usato il parametro AsSecureString , Read-Hostrestituisce un oggetto SecureString. In caso contrario, restituisce un stringa.