共用方式為

Read-Host

模組:
Microsoft.PowerShell.Utility Module

從主控台讀取一行輸入。

語法

AsString (預設值) 

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

AsSecureString 

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

Description

Read-Host Cmdlet 會從控制台 （stdin） 讀取一行輸入。 您可以使用它來提示使用者輸入。 因為您可以將輸入儲存為安全字串，因此您可以使用此 Cmdlet 來提示使用者輸入安全數據，例如密碼。

備註

Read-Host 可以接受最多 1022 個字元的使用者輸入限制。

範例

範例 1：將主控台輸入儲存至變數

此範例會以提示顯示字串 "Please enter your age:"。 輸入值並按下 Enter 鍵時，該值會儲存在 $Age 變數中。

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

範例 2：將主控台輸入儲存為安全字串

此範例會在提示中顯示字串 「Enter a Password：“。 輸入值時，星號 （*） 會出現在控制臺上，以取代輸入。 按下 Enter 鍵時，值會儲存為 SecureString 物件，並儲存在 $pwd_secure_string 變數中。

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

範例 3：將輸入遮罩並以純文字字串呈現

此範例會在提示中顯示字串 「Enter a Password：“。 輸入值時，星號 （*） 會出現在控制臺上，以取代輸入。 按下 Enter 鍵時，值會儲存為純文本 String 物件在 $pwd_string 變數中。

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

參數

-AsSecureString

指出 Cmdlet 會顯示星號（*），以替代使用者輸入的字元。 當您使用此參數時，Read-Host Cmdlet 的輸出是 SecureString 物件（System.Security.SecureString）。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

AsSecureString
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-MaskInput

指出 Cmdlet 會顯示星號（*），以替代使用者輸入的字元。 當您使用此參數時，Read-Host Cmdlet 的輸出是 String 物件。 您可以安全地提示輸入密碼，使其以純文字形式返回，而不是使用 SecureString。

此參數已在PowerShell 7.1中新增。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False

參數集

AsString
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Prompt

指定提示的文字。 輸入字串。 如果字串包含空格，請以引弧括住它。 PowerShell 會將冒號 （:） 附加至您輸入的文字。

參數屬性

類型:Object
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:0
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

None

此 cmdlet 不接受來自 PowerShell 管道的輸入。

輸出

System.String or System.Security.SecureString

如果使用 AsSecureString 參數， Read-Host 則返回 SecureString。 否則，它會傳回字串。

備註

此 Cmdlet 只會從主機進程的 stdin 數據流讀取。 通常，stdin 數據流會連線到主機控制台的鍵盤。