Read-Host

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 utilizzato per richiedere l'input a un utente. Poiché è possibile salvare l'input come stringa sicura, è possibile utilizzare questo cmdlet per richiedere dati sicuri agli utenti, ad esempio la password, nonché dati condivisi.

Parametri

-AsSecureString

Visualizza degli asterischi (*) al posto dei caratteri che l'utente digita come input.

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

Obbligatorio?	false
Posizione?	named
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

-Prompt <Object>

Specifica il testo del prompt. Digitare una stringa. Se la stringa include spazi, è necessario racchiuderla tra virgolette doppie. Ad esempio, "Digitare un valore intero: ".

Obbligatorio?	false
Posizione?	1
Valore predefinito
Accettare input da pipeline?	false
Accettare caratteri jolly?	false

<CommonParameters>

Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.

Input e output

Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.

Input

Nessuno

Non è possibile reindirizzare l'input a questo cmdlet.

Output

System.String o System.Security.SecureString

Se viene utilizzato il parametro AsSecureString, Read-Host restituisce SecureString. In caso contrario, restituisce una stringa.

Esempio 1

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

Descrizione
-----------
Con questo comando viene visualizzata la stringa "Please enter your age:" come richiesta. Quando si immette un valore e si preme INVIO, il valore viene archiviato nella variabile $age.

Esempio 2

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

Descrizione
-----------
Con questo comando viene visualizzata la stringa "Enter a Password:" come richiesta. Durante l'immissione di un valore, sulla console vengono visualizzati degli asterischi (*) al posto dell'input. Quando si preme INVIO, il valore viene archiviato come oggetto SecureString nella variabile $pwd_secure_string.