Reads a line of input from the console. (Read-Host)

   

# NAME
Read-Host

# SYNOPSIS
Reads a line of input from the console.

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

# DESCRIPTION
The Read-Host cmdlet reads a line of input from the console. You can use it to prompt a user for input. Because you can save the input as a secure string, you can use this cmdlet to prompt users for secure data, such as passwords, as well as shared data.

# PARAMETERS
-AsSecureString [<SwitchParameter>]
Displays asterisks (*) in place of the characters that the user types as input.

When you use this parameter, the output of the Read-Host cmdlet is a SecureString object (System.Security.SecureString).

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Prompt <Object>
Specifies the text of the prompt. Type a string. If the string includes spaces, enclose it in quotation marks. For example, "Type an integer: ".

Required? false
Position? 1
Default value
Accept pipeline input? false
Accept wildcard characters? false

<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

# INPUTS
None
You cannot pipe input to this cmdlet.

# OUTPUTS
System.String or System.Security.SecureString
If the AsSecureString parameter is used, Read-Host returns a SecureString. Otherwise, it returns a string.

# NOTES

# EXAMPLE 1

C:\PS>$age = read-host "Please enter your age:"

# Description
-----------
This command displays the string "Please enter your age:" as a prompt. When a value is entered and the Enter key is pressed, the value is stored in the $age variable.

# EXAMPLE 2

C:\PS>$pwd_secure_string = read-host "Enter a Password:" -assecurestring

# Description
-----------
This command displays the string "Enter a Password:" as a prompt. As a value is being entered, asterisks (*) appear on the console in place of the input. When the Enter key is pressed, the value is stored as a SecureString object in the $pwd_secure_string variable.

RELATED LINKS
Online version: http://go.microsoft.com/fwlink/?LinkID=113371
Get-Host
Out-Host
Write-Host
ConvertFrom-SecureString

C:\Windows>powershell get-help Set-Alias -full

ColorConsole [Version 1.7.1000] PowerShell 2.0-Export
Microsoft Windows [Version 6.1.7600]
Copyright (c) 2014 Microsoft Corporation.

OS: Windows 10, 8.1, 8, 7, Vista / Windows Server 2016, 2012, 2008
»»»» ColorConsole






Windows-10


Windows-10





Windows-10


Become a Sponsor
... Your button here?





HTTP: ... PS_Windows/en/Read-Host.htm
0.124

Run Command Prompt and activate Opacity Mode on Windows 10!

 /

Start with a favorite, without to register *.qdr?

 /

Wo ist die Sidebar in Windows-7 versteckt, gibt es überhaupt eine?

 /

How to switch the Windows 8 or Win 8.1 Control Panel, to classic?

 /

How do I know if I'm running Windows-8 x32/x86 (32 bit) or x64 (32-bit) installed edition ?

 /

Where can I see if Service Pack 1 is installed on my Windows 7?

 /

Arbeitsgruppe und Computername ändern unter Windows-XP!

 /

Was ist eine SD-Speicherkarte?

 /