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




Inhaltsverzeichnis