Get-Credential

获取基于用户名和密码的凭据对象。

语法

Get-Credential
   [[-Credential] <PSCredential>]
   [<CommonParameters>]
Get-Credential
   [-Message <String>]
   [[-UserName] <String>]
   [-Title <String>]
   [<CommonParameters>]

说明

Get-Credential cmdlet 为指定的用户名和密码创建凭据对象。 你可以在安全操作中使用凭据对象。

Get-Credential cmdlet 提示用户输入密码或用户名和密码。 可以使用 Message 参数在命令行提示符中指定自定义消息。

示例

示例 1

$c = Get-Credential

此命令获取凭据对象并将其保存在变量中 $c

输入命令时,系统会提示输入用户名和密码。 输入请求的信息时,该 cmdlet 会创建一个 PSCredential 对象,该对象代表用户的凭据并将其保存在变量中 $c

你可以将对象用作请求用户身份验证的 cmdlet(例如,具有 Credential 参数的 cmdlet)的输入。 但是,使用 PowerShell 安装的一些提供程序不支持 Credential 参数。

示例 2

$c = Get-Credential -credential User01
$c.Username
User01

此示例将创建一个包含用户名(不带域名)的凭据。

第一个命令获取用户名 User01 的凭据,并将其存储在变量中 $c 。 第二个命令将显示生成的凭据对象的 Username 属性值。

示例 3

$Credential = $host.ui.PromptForCredential("Need credentials", "Please enter your user name and password.", "", "NetBiosUserName")

此命令使用 PromptForCredential 方法提示用户输入其用户名和密码。 该命令将生成的凭据保存在变量中 $Credential

PromptForCredential 方法是使用 cmdlet 的Get-Credential替代方法。 使用 PromptForCredential 时,可以指定提示中显示的标题、消息和用户名。

有关详细信息,请参阅 SDK 中的 PromptForCredential 文档。

示例 4

此示例演示如何创建与返回的对象相同的凭据对象, Get-Credential 而不提示用户。 此方法要求输入纯文本密码,这可能会违反某些企业内的安全标准。

$User = "Domain01\User01"
$PWord = ConvertTo-SecureString -String "P@sSwOrd" -AsPlainText -Force
$Credential = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $User, $PWord

第一个命令将用户帐户名保存在参数中 $User 。 该值必须具有“Domain\User”或“ComputerName\User”格式。

第二个命令使用 ConvertTo-SecureString cmdlet 从纯文本密码创建安全字符串。 该命令使用 AsPlainText 参数来指示该字符串为纯文本,并使用 Force 参数来确认你了解使用纯文本的风险。

第三个命令使用 New-Object cmdlet 从变量中的$User$PWord值创建 PSCredential 对象。

示例 5

Get-Credential -Message "Credential are required for access to the \\Server1\Scripts file share." -User Server01\PowerUser

PowerShell Credential Request
Credential are required for access to the \\Server1\Scripts file share.
Password for user Server01\PowerUser:

此命令使用 cmdlet 的消息Get-CredentialUserName 参数。 此命令格式旨在用于共享的脚本和函数。 在此示例中,消息将告知用户为何需要凭据,并使他们能够确信此请求是合法的。

示例 6

Invoke-Command -ComputerName Server01 {Get-Credential Domain01\User02}

PowerShell Credential Request : PowerShell Credential Request
Warning: This credential is being requested by a script or application on the SERVER01 remote computer. Enter your credentials only if you
 trust the remote computer and the application or script requesting it.

Enter your credentials.
Password for user Domain01\User02: ***************

PSComputerName     : Server01
RunspaceId         : 422bdf52-9886-4ada-ab2f-130497c6777f
PSShowComputerName : True
UserName           : Domain01\User01
Password           : System.Security.SecureString

此命令将从 Server01 远程计算机获取凭据。 该命令使用 Invoke-Command cmdlet 在远程计算机上运行 Get-Credential 命令。 输出显示身份验证提示中包含的远程安全消息 Get-Credential

参数

-Credential

指定凭据的用户名,例如 User01Domain01\User01。 参数名称 -Credential是可选的。

提交命令并指定用户名时,系统会提示输入密码。 如果省略此参数,系统会提示输入用户名和密码。

从 PowerShell 3.0 开始,如果输入没有域的用户名, Get-Credential 则不再在名称前插入反斜杠。

凭据存储在 PSCredential 对象中,密码存储为 SecureString

备注

有关 SecureString 数据保护的详细信息,请参阅 SecureString 的安全性如何?

Type:PSCredential
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Message

指定将在身份验证提示中显示的消息。 此参数旨在用于函数或脚本。 你可以使用该消息向用户说明你为什么要请求凭据以及将如何使用它们。

此参数是在 PowerShell 3.0 中引入的。

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

-Title

设置控制台中身份验证提示的标题行文本。

此参数是在 PowerShell 6.0 中引入的。

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

-UserName

指定用户名。 身份验证提示要求输入该用户名对应的密码。 默认情况下,用户名为空并且身份验证提示将请求输入用户名和密码。

此参数是在 PowerShell 3.0 中引入的。

Type:String
Position:1
Default value:None (blank)
Accept pipeline input:False
Accept wildcard characters:False

输入

None

不能通过管道将输入传递给此 cmdlet。

输出

PSCredential

Get-Credential 返回凭据对象。

备注

可以使用在请求用户身份验证的 cmdlet 中创建 的 PSCredential 对象 Get-Credential ,例如具有 Credential 参数的 cmdlet

随 PowerShell 一起安装的所有提供程序都不支持 Credential 参数。 从 PowerShell 3.0 开始,所选 cmdlet(如 Get-Content cmdlet 和 New-PSDrive cmdlet)支持它。