Freigeben über

Read-Host

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Liest eine Zeile von Eingabedaten aus der Konsole.

Syntax

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

Beschreibung

Das Cmdlet Read-Host liest eine Eingabezeile aus der Konsole. Damit kann ein Benutzer zur Eingabe aufgefordert werden. Da Sie die Eingabe als sichere Zeichenfolge speichern können, können Sie dieses Cmdlet verwenden, um Benutzer zur Eingabe von sicheren Daten wie Kennwörtern oder freigegebenen Daten aufzufordern.

Beispiele

Beispiel 1: Speichern der Konsoleneingabe in einer Variablen

PS C:\> $Age = Read-Host "Please enter your age"

Dieser Befehl zeigt die Zeichenfolge „Please enter your age:“ als Eingabeaufforderung an. Wenn ein Wert eingegeben und die EINGABETASTE gedrückt wird, wird der Wert in der variablen $Age gespeichert.

Beispiel 2: Speichern der Konsoleneingabe als sichere Zeichenfolge

PS C:\> $pwd_secure_string = Read-Host "Enter a Password" -AsSecureString

Dieser Befehl zeigt die Zeichenfolge „Enter a Password:“ als Eingabeaufforderung an. Wenn ein Wert eingegeben wird, werden in der Konsole Sternchen (*) anstelle der Eingabe angezeigt. Wenn die EINGABETASTE gedrückt wird, wird der Wert als SecureString-Objekt in der Variablen $pwd_secure_string gespeichert.

Parameter

-AsSecureString

Gibt an, dass das Cmdlet Sternchen (*) anstelle der Zeichen anzeigt, die der Benutzer als Eingabe eingibt.

Wenn Sie diesen Parameter verwenden, ist die Ausgabe des Read-Host-Cmdlets ein SecureString-Objekt (System.Security.SecureString).

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

-Prompt

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. Windows PowerShell fügt einen Doppelpunkt (:) zu dem von Ihnen eingegebenen Text hinzu.

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

Eingaben

None

Eingaben können nicht an dieses Cmdlet weitergereicht werden.

Ausgaben

System.String or System.Security.SecureString

Wenn der AsSecureString-Parameter verwendet wird, gibt Read-Host einen SecureString-Wert zurück. Andernfalls wird eine Zeichenfolge zurückgegeben.