Sdílet prostřednictvím

Read-Host

  • Reference
Modul:
Microsoft.PowerShell.Utility

Načte řádek vstupu z konzoly.

Syntaxe

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).

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Object
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Vstup do této rutiny nelze převést.

Výstupy

System.String or System.Security.SecureString

Pokud se používá parametr AsSecureString, Read-Host vrátíSecureString . V opačném případě vrátí řetězec.