Read-Host

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Odczytuje wiersz danych wejściowych z konsoli programu .

Składnia

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

Opis

Polecenie Read-Host cmdlet odczytuje wiersz danych wejściowych z konsoli (stdin). Można go użyć, aby monitować użytkownika o dane wejściowe. Ponieważ dane wejściowe można zapisać jako bezpieczny ciąg, możesz użyć tego polecenia cmdlet, aby monitować użytkowników o bezpieczne dane, takie jak hasła.

Uwaga

Read-Host ma limit 1022 znaków, który może zaakceptować jako dane wejściowe od użytkownika.

Przykłady

Przykład 1. Zapisywanie danych wejściowych konsoli w zmiennej

W tym przykładzie wyświetlany jest ciąg "Wprowadź wiek:" jako monit. Po wprowadzeniu wartości i naciśnięciu klawisza Enter wartość jest przechowywana w zmiennej $Age .

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

Przykład 2. Zapisywanie danych wejściowych konsoli jako bezpiecznego ciągu

W tym przykładzie wyświetlany jest ciąg "Wprowadź hasło:" jako monit. W miarę wprowadzania wartości gwiazdki (*) są wyświetlane w konsoli zamiast danych wejściowych. Po naciśnięciu klawisza Enter wartość jest przechowywana jako obiekt SecureString w zmiennej $pwd_secure_string .

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

Przykład 3. Maskuj dane wejściowe i jako ciąg w postaci zwykłego tekstu

W tym przykładzie wyświetlany jest ciąg "Wprowadź hasło:" jako monit. W miarę wprowadzania wartości gwiazdki (*) są wyświetlane w konsoli zamiast danych wejściowych. Po naciśnięciu klawisza Enter wartość jest przechowywana jako obiekt ciągu w postaci zwykłego tekstu w zmiennej $pwd_string .

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

Parametry

-AsSecureString

Wskazuje, że polecenie cmdlet wyświetla gwiazdki (*) zamiast znaków, które użytkownik wpisze jako dane wejściowe. W przypadku użycia tego parametru Read-Host dane wyjściowe polecenia cmdlet są obiektem SecureString (System.Security.SecureString).

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

-MaskInput

Wskazuje, że polecenie cmdlet wyświetla gwiazdki (*) zamiast znaków, które użytkownik wpisze jako dane wejściowe. W przypadku użycia tego parametru Read-Host dane wyjściowe polecenia cmdlet są obiektem String . Dzięki temu można bezpiecznie monitować o hasło, które jest zwracane jako zwykły tekst zamiast secureString.

Ten parametr został dodany w programie PowerShell 7.1.

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

-Prompt

Określa tekst monitu. Wpisz ciąg. Jeśli ciąg zawiera spacje, należy go ująć w cudzysłów. Program PowerShell dołącza dwukropek (:) do wprowadzonego tekstu.

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

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

String

Domyślnie to polecenie cmdlet zwraca ciąg.

SecureString

Jeśli używasz parametru AsSecureString , to polecenie cmdlet zwraca wartość SecureString.

Uwagi

To polecenie cmdlet odczytuje tylko ze strumienia stdin procesu hosta. Zwykle strumień stdin jest podłączony do klawiatury konsoli hosta.