Dela via

Read-Host

  • Referens
Modul:
Microsoft.PowerShell.Utility

Läser en rad med indata från konsolen.

Syntax

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

Description

Cmdleten Read-Host läser en rad med indata från konsolen. Du kan använda den för att fråga en användare om indata. Eftersom du kan spara indata som en säker sträng kan du använda den här cmdleten för att be användarna om säkra data, till exempel lösenord och delade data.

Exempel

Exempel 1: Spara konsolindata till en variabel

I det här exemplet visas strängen "Ange din ålder:" som en uppmaning. När ett värde anges och returnyckeln trycks på lagras värdet i variabeln $Age .

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

Exempel 2: Spara konsolindata som en säker sträng

I det här exemplet visas strängen "Ange ett lösenord:" som en uppmaning. När ett värde anges visas asterisker (*) i konsolen i stället för indata. När returtangenten trycks in lagras värdet som ett SecureString-objekt i variabeln $pwd_secure_string .

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

Parametrar

-AsSecureString

Anger att cmdleten visar asterisker (*) i stället för de tecken som användaren skriver som indata. När du använder den här parametern är utdata för cmdleten Read-Host ett SecureString-objekt (System.Security.SecureString).

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

-Prompt

Anger texten i prompten. Skriv en sträng. Om strängen innehåller blanksteg omger du den inom citattecken. PowerShell lägger till ett kolon (:) i den text som du anger.

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

Indata

None

Du kan inte skicka indata till den här cmdleten.

Utdata

System.String or System.Security.SecureString

Om parametern AsSecureString används Read-Host returnerar en SecureString. Annars returneras en sträng.