Aracılığıyla paylaş

Read-Host

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Konsolundan bir giriş satırı okur.

Syntax

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

Description

cmdlet'i Read-Host konsoldan (stdin) bir giriş satırı okur. Bunu kullanarak bir kullanıcıdan giriş isteyebilirsiniz. Girişi güvenli bir dize olarak kaydedebileceğiniz için bu cmdlet'i kullanarak kullanıcılardan parolalar gibi güvenli veriler isteyebilirsiniz.

Not

Read-Host bir kullanıcıdan giriş olarak kabul edebildiği 1022 karakter sınırına sahiptir.

Örnekler

Örnek 1: Konsol girişini bir değişkene kaydetme

Bu örnekte istem olarak "Lütfen yaşınızı girin:" dizesi görüntülenir. Bir değer girildiğinde ve Enter tuşuna basıldığında değer değişkeninde $Age depolanır.

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

Örnek 2: Konsol girişini güvenli dize olarak kaydetme

Bu örnekte istem olarak "Parola Girin:" dizesi görüntülenir. Bir değer girilirken, giriş yerine konsolda yıldız işareti (*) görünür. Enter tuşuna basıldığında değer değişkeninde $pwd_secure_stringSecureString nesnesi olarak depolanır.

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

Örnek 3: Girişi ve düz metin dizesi olarak maskele

Bu örnekte istem olarak "Parola Girin:" dizesi görüntülenir. Bir değer girilirken, giriş yerine konsolda yıldız işareti (*) görünür. Enter tuşuna basıldığında, değer değişkende $pwd_string düz metin Dizesi nesnesi olarak depolanır.

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

Parametreler

-AsSecureString

Cmdlet'in, kullanıcının giriş olarak yazdığınız karakterlerin yerine yıldız işareti (*) görüntülediğini gösterir. Bu parametreyi kullandığınızda, cmdlet'in Read-Host çıkışı bir SecureString nesnesidir (System.Security.SecureString).

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

-MaskInput

Cmdlet'in, kullanıcının giriş olarak yazdığınız karakterlerin yerine yıldız işareti (*) görüntülediğini gösterir. Bu parametreyi kullandığınızda, cmdlet'in Read-Host çıkışı bir String nesnesidir. Bu, SecureString yerine düz metin olarak döndürülen bir parolayı güvenli bir şekilde sormanızı sağlar.

Bu parametre PowerShell 7.1'e eklendi.

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

-Prompt

İstem metnini belirtir. Bir dize yazın. Dize boşluk içeriyorsa, tırnak içine alın. PowerShell, girdiğiniz metne iki nokta (:) ekler.

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

Girişler

None

Bu cmdlet, PowerShell işlem hattından gelen girişleri kabul etmez.

Çıkışlar

System.String or System.Security.SecureString

AsSecureString parametresi kullanılırsa, Read-Host bir SecureString döndürür. Aksi takdirde bir dize döndürür.

Notlar

Bu cmdlet yalnızca konak işleminin stdin akışından okur. Genellikle stdin akışı konak konsolunun klavyesine bağlanır.