Megosztás a következőn keresztül:

Read-Host

Modul:
Microsoft.PowerShell.Utility Module

Beolvassa a bemenetsort a konzolról.

Syntax

Default (Alapértelmezett) 

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

Description

A Olvasási gazdagép parancsmag beolvassa a konzol bemeneti sorát. Ezzel kérheti a felhasználótól a bemenetet. Mivel biztonságos sztringként mentheti a bemenetet, ezzel a parancsmaggal kérheti a felhasználóktól a biztonságos adatokat, például jelszavakat és megosztott adatokat.

Példák

1. példa: Konzolbemenet mentése változóba

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

Ez a parancs a következő sztringet jeleníti meg: "Adja meg a korát:" sztringet. Amikor beír egy értéket, és lenyomja az Enter billentyűt, az érték a $Age változóban lesz tárolva.

2. példa: Konzolbemenet mentése biztonságos sztringként

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

Ez a parancs az "Enter a Password:" sztringet jeleníti meg parancssorként. Az érték megadásakor csillag (*) jelenik meg a konzolon a bemenet helyett. Az Enter billentyű lenyomásakor az érték SecureString objektumként lesz tárolva a $pwd_secure_string változóban.

Paraméterek

-AsSecureString

Azt jelzi, hogy a parancsmag csillagokat (*) jelenít meg a felhasználó által bemenetként beírt karakterek helyett.

Ha ezt a paramétert használja, a Olvasási gazdagép parancsmag kimenete egy SecureString objektum (System.Security.SecureString).

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Prompt

A parancssor szövegét adja meg. Írjon be egy karakterláncot. Ha a karakterlánc szóközöket tartalmaz, tegye idézőjelek közé. A Windows PowerShell kettőspontot fűz hozzá (:) a beírt szöveghez.

Paramétertulajdonságok

Típus:Object
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:0
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

None

Ehhez a parancsmaghoz nem csövezhet be bemenetet.

Kimenetek

System.String or System.Security.SecureString

Ha a AsSecureString paramétert használja, Olvasási gazdagép egy SecureStringad vissza. Ellenkező esetben egy sztringet ad vissza.