Read-Host
Liest eine Zeile von Eingaben aus der Konsole.
Syntax
Default (Standard)
Read-Host
[[-Prompt] <Object>]
[-AsSecureString]
[<CommonParameters>]
Beschreibung
Das Cmdlet Read-Host liest eine Eingabezeile aus der Konsole. Sie können ihn verwenden, um einen Benutzer zur Eingabe aufzufordern. Da Sie die Eingabe als sichere Zeichenfolge speichern können, können Sie dieses Cmdlet verwenden, um Benutzer zur Eingabe sicherer Daten, z. B. Kennwörter, sowie freigegebener Daten aufzufordern.
Beispiele
Beispiel 1: Speichern von Konsoleneingaben in einer Variablen
PS C:\> $Age = Read-Host "Please enter your age"
Dieser Befehl zeigt die Zeichenfolge "Bitte geben Sie Ihr Alter ein:" als Eingabeaufforderung an. Wenn ein Wert eingegeben und die Eingabetaste gedrückt wird, wird der Wert in der Variablen $Age gespeichert.
Beispiel 2: Speichern von Konsoleneingaben 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 Sternchen (*) anstelle der Eingabe auf der Konsole 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 Cmdlets Read-Host ein SecureString-Objekt (System.Security.SecureString).
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Prompt
Gibt den Text der Eingabeaufforderung an. Geben Sie eine Zeichenfolge ein. Wenn die Zeichenfolge Leerzeichen enthält, schließen Sie sie in Anführungszeichen ein. Windows PowerShell fügt einen Doppelpunkt (:) an den eingegebenen Text an.
Parametereigenschaften
| Typ: | Object |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
None
Eingaben können nicht an dieses Cmdlet weitergereicht werden.
Ausgaben
System.String or System.Security.SecureString
Wenn der Parameter AsSecureString verwendet wird, gibt Read-Host einen SecureString zurück. Andernfalls wird eine Zeichenfolge zurückgegeben.