Liest eine Eingabezeile aus der Konsole.
Syntax
Read-Host [[-Prompt] <Object>] [-AsSecureString] [<CommonParameters>]
Beschreibung
Mit dem Cmdlet "Read-Host" wird eine Eingabezeile aus der Konsole gelesen. Sie können mit ihm einen Benutzer zu einer Eingabe auffordern. Da Sie die Eingabe als sichere Zeichenfolge speichern können, können Sie mit diesem Cmdlet Benutzer zur Eingabe von sicheren Daten, z. B. Kennwörtern, und gemeinsamen Daten auffordern.
Parameter
-AsSecureString
Zeigt als Eingabe Sternchen (*) anstelle der Zeichen an, die der Benutzer eingibt.
Wenn Sie diesen Parameter verwenden, ist die Ausgabe des Cmdlet "Read-Host" ein SecureString-Objekt (System.Security.SecureString).
|
Erforderlich? |
false |
|
Position? |
named |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
-Prompt <Object>
Gibt den Text der Eingabeaufforderung an. Geben Sie eine Zeichenfolge ein. Wenn die Zeichenfolge Leerzeichen enthält, müssen Sie sie in Anführungszeichen einschließen. Beispiel: "Geben Sie eine ganze Zahl ein: ".
|
Erforderlich? |
false |
|
Position? |
1 |
|
Standardwert |
|
|
Pipelineeingaben akzeptieren? |
false |
|
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die folgenden allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer und -OutVariable. Weitere Informationen finden Sie unter about_Commonparameters.
Eingaben und Ausgaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können. Der Rückgabetyp ist der Typ der Objekte, die das Cmdlet zurückgibt.
|
Eingaben |
None Eingaben können nicht über die Pipeline an dieses Cmdlet übergeben werden. |
|
Ausgaben |
System.String oder System.Security.SecureString Wenn der AsSecureString-Parameter verwendet wird, gibt Read-Host einen SecureString zurück. Andernfalls wird eine Zeichenfolge zurückgegeben. |
Beispiel 1
C:\PS>$age = read-host "Please enter your age:" Beschreibung ----------- Mit diesem Befehl wird die Zeichenfolge "Please enter your age:" als Eingabeaufforderung angezeigt. Wenn ein Wert eingegeben und die EINGABETASTE gedrückt wurde, wird dieser Wert in der Variablen "$age" gespeichert.
Beispiel 2
C:\PS>$pwd_secure_string = read-host "Enter a Password:" -assecurestring Beschreibung ----------- Mit diesem Befehl wird die Zeichenfolge "Enter a Password:" als Eingabeaufforderung angezeigt. Wenn ein Wert eingegeben wird, werden in der Konsole Sternchen (*) anstelle der Eingabe angezeigt. Beim Drücken der EINGABETASTE wird der Wert als SecureString-Objekt in der Variablen "$pwd_secure_string" gespeichert.
Siehe auch