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

Read-Host

Modul:
Microsoft.PowerShell.Utility Module

Beolvassa a bemenetsort a konzolról.

Syntax

AsString (Alapértelmezett) 

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

AsSecureString 

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

Description

A Read-Host parancsmag beolvassa a konzol (stdin) bemeneti sorát. Ezzel kérheti a felhasználótól a bemenetet. Mivel a bemenetet biztonságos sztringként mentheti, ezzel a parancsmaggal kérheti a felhasználóktól a biztonságos adatok, például jelszavak megadását.

Megjegyzés:

Read-Host legfeljebb 1022 karakter hosszúságú lehet, amelyet a felhasználó bemeneteként elfogadhat.

Példák

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

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

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

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

Ez a példa 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.

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

3. példa: Bemenet maszkolása és megjelenítése egyszerű szöveges sorozatként.

Ez a példa 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űt lenyomva az érték egyszerű szöveges sztring objektumként lesz tárolva a $pwd_string változóban.

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

Paraméterek

-AsSecureString

Azt jelzi, hogy a parancsmag csillagokat (*) jelenít meg a felhasználó által bemenetként beírt karakterek helyett. A paraméter használatakor a Read-Host 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

AsSecureString
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

-MaskInput

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 Read-Host parancsmag kimenete egy Sztring objektum. Így biztonságosan kérheti az egyszerű szövegként visszaadott jelszót a SecureStringhelyett.

Ez a paraméter a PowerShell 7.1-ben lett hozzáadva.

Paramétertulajdonságok

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

Paraméterkészletek

AsString
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 PowerShell egy kettőspontot (:) fűz 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

Ez a parancsmag nem fogadja el a PowerShell-folyamat bemenetét.

Kimenetek

System.String or System.Security.SecureString

Ha az AsSecureString paramétert használja, egy Read-HostSecureString értéket ad vissza. Ellenkező esetben egy sztringet ad vissza.

Jegyzetek

Ez a parancsmag csak a gazdafolyamat stdin streaméből olvas be. A stdin stream általában a gazdakonzol billentyűzetéhez csatlakozik.