Sdílet prostřednictvím

Read-Host

Modul:
Microsoft.PowerShell.Utility Module

Načte řádek vstupu z konzoly.

Syntax

AsString (Výchozí) 

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

AsSecureString 

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

Description

Rutina Read-Host načte řádek vstupu z konzoly (stdin). 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.

Poznámka:

Read-Host má limit 1022 znaků, který může přijmout jako vstup od uživatele.

Příklady

Příklad 1: Uložení vstupu konzoly do proměnné

Tento příklad 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.

$Age = Read-Host "Please enter your age"

Příklad 2: Uložení vstupu konzoly jako zabezpečeného řetězce

V tomto příkladu se 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.

$pwd_secure_string = Read-Host "Enter a Password" -AsSecureString

Příklad 3: Maskování vstupu a jako řetězec prostého textu

V tomto příkladu se zobrazí řetězec "Zadejte heslo:" jako výzvu. Při zadávání hodnoty se v konzole místo vstupu zobrazí hvězdičky (*). Když stisknete klávesu Enter, hodnota se uloží jako prostý text String objektu v proměnné $pwd_string.

$pwd_string = Read-Host "Enter a Password" -MaskInput

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ů

AsSecureString
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

-MaskInput

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 String. To vám umožní bezpečně vyzvat k zadání hesla, které je vráceno jako prostý text místo SecureString.

Tento parametr byl přidán v PowerShellu 7.1.

Vlastnosti parametru

Typ:SwitchParameter
Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

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

Tato rutina nepřijímá vstup z kanálu PowerShell.

Výstupy

System.String or System.Security.SecureString

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

Poznámky

Tato rutina čte pouze ze streamu stdin hostitelského procesu. Stream stdin je obvykle připojený k klávesnici konzoly hostitele.