Delen via

Read-Host

  • Referentie
Module:
Microsoft.PowerShell.Utility

Leest een regel invoer van de console.

Syntaxis

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

Description

De cmdlet Read-Host leest een invoerregel van de console. U kunt deze gebruiken om een gebruiker om invoer te vragen. Omdat u de invoer kunt opslaan als een beveiligde tekenreeks, kunt u deze cmdlet gebruiken om gebruikers te vragen om beveiligde gegevens, zoals wachtwoorden, en gedeelde gegevens.

Voorbeelden

Voorbeeld 1: Console-invoer opslaan in een variabele

PS C:\> $Age = Read-Host "Please enter your age"

Met deze opdracht wordt de tekenreeks 'Geef uw leeftijd op:' weergegeven als een prompt. Wanneer een waarde wordt ingevoerd en de Enter-toets wordt ingedrukt, wordt de waarde opgeslagen in de $Age variabele.

Voorbeeld 2: Console-invoer opslaan als een beveiligde tekenreeks

PS C:\> $pwd_secure_string = Read-Host "Enter a Password" -AsSecureString

Met deze opdracht wordt de tekenreeks 'Een wachtwoord invoeren:' weergegeven als een prompt. Als een waarde wordt ingevoerd, worden sterretjes (*) weergegeven op de console in plaats van de invoer. Wanneer de Enter-toets wordt ingedrukt, wordt de waarde opgeslagen als een SecureString--object in de variabele $pwd_secure_string.

Parameters

-AsSecureString

Geeft aan dat de cmdlet sterretjes (*) weergeeft in plaats van de tekens die de gebruiker als invoer typt.

Wanneer u deze parameter gebruikt, is de uitvoer van de cmdlet Read-Host een SecureString-object (System.Security.SecureString).

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Prompt

Hiermee geeft u de tekst van de prompt. Typ een tekenreeks. Als de tekenreeks spaties bevat, plaatst u deze tussen aanhalingstekens. Windows PowerShell voegt een dubbele punt toe (:) aan de tekst die u invoert.

Type:Object
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

U kunt invoer voor deze cmdlet niet doorsluisen.

Uitvoerwaarden

System.String or System.Security.SecureString

Als de parameter AsSecureString wordt gebruikt, retourneert Read-Host- een SecureString-. Anders wordt een tekenreeks geretourneerd.