Read-Host
Načte řádek vstupu z konzoly.
Syntax
Default (Výchozí)
Read-Host
[[-Prompt] <Object>]
[-AsSecureString]
[<CommonParameters>]
Description
Rutina Read-Host načte řádek vstupu z konzoly. Můžete ho použít k zobrazení výzvy k zadání vstupu uživatele. Protože můžete vstup uložit jako zabezpečený řetězec, můžete pomocí této rutiny vyzvat uživatele k zadání zabezpečených dat, jako jsou hesla a sdílená data.
Příklady
Příklad 1: Uložení vstupu konzoly do proměnné
PS C:\> $Age = Read-Host "Please enter your age"
Tento příkaz zobrazí řetězec "Zadejte váš věk:" jako výzvu. Při zadání hodnoty a stisknutí klávesy Enter se hodnota uloží do proměnné $Age.
Příklad 2: Uložení vstupu konzoly jako zabezpečeného řetězce
PS C:\> $pwd_secure_string = Read-Host "Enter a Password" -AsSecureString
Tento příkaz zobrazí řetězec "Zadejte heslo:" jako výzvu. Při zadávání hodnoty se v konzole místo vstupu zobrazí hvězdičky (*). Při stisknutí klávesy Enter se hodnota uloží jako objekt SecureString v proměnné $pwd_secure_string.
Parametry
-AsSecureString
Označuje, že rutina zobrazuje hvězdičky (*) místo znaků, které uživatel zadá jako vstup.
Při použití tohoto parametru je výstupem rutiny Read-Host objekt SecureString (System.Security.SecureString).
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Prompt
Určuje text výzvy. Zadejte řetězec. Pokud řetězec obsahuje mezery, uzavřete ho do uvozovek. Windows PowerShell připojí dvojtečku (:) k zadanému textu.
Vlastnosti parametru
| Typ: | Object |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
None
Vstup do této rutiny nelze převést.
Výstupy
System.String or System.Security.SecureString
Pokud se používá parametr