Get-Credential 帮助信息

如下说明是翻译 PowerShell 中 : help Get-Credential 产生的帮助信息 .

译者 : Edengundam( 马涛 )

 

Get-Credential

 

大纲

根据用户名和密码取得凭证对象 .

 

语法

Get-Credential [-credential] <PSCredential> [<CommonParameters>]

 

详细描述

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

 

参数

 

-credential <PSCredential>

为凭证的用户名称 , 例如 : "User01" 或 "Domain01/User01". 参数名称 ("-Credential") 为可选项 .

 

当你输入命令时 , 将会提示您输入密码 .

 

如果你忽略此参数 , 将会提示您输入用户名和密码 .

 

强制参数 ?	true
参数位置 ?	1
默认值	null
允许从管道绑定输入 ?	false
允许通配符扩展 ?	false

 

< 公共参数 >

此命令支持公共参数 : -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. 更多信息 , 输入 , "get-help about_commonparameters".

 

输入类型

None

 

返回类型

CredentialObject

 

注意

 

更多信息 , 输入 "Get-Help Get-Credential -detailed". 需要技术信息 , 输入 "Get-Help Get-Credential -full".

 

你可以在 cmdlet 中 ( 例如那些支持 Credential 参数的命令 ) 使用 Get-Credential 创建的 PSCredential 对象请求用户权限 .

 

随 Windows PowerShell 一起安装的提供程序不支持使用 Credential 参数 . 你依然可以使用 Get-WmiObject 的 Credential 参数 , 这是因为它直接调用 .Net.

 

如果需要为该命令提供多个参数 , 请使用逗号进行分隔 . 例如 , "<parameter-name> <value1>, <value2>".

 

例 1

 

C:/PS>$c = Get-Credential

 

此命令取得凭证对象 , 并将其存储在变量 $c 中 .

 

当你输入命令后 , 将会出现一个请求输入用户名和密码的对话框 . 当你输入了需要的信息后 , 此 cmdlet 将会创建一个表示指定用户凭证的 PSCredential 对象 , 并将其存储在变量 $c 中 .

 

你可以使用此对象作为 cmdlet 的输入来请求用户身份 , 例如那些 Credential 参数 . 然而 , 随 Windows PowerShell 一起安装的提供程序是不支持 Credential 参数的 .

 

例 2

 

C:/PS>$c = Get-Credential

 

C:/PS>Get-WmiObject Win32_DiskDrive -ComputerName Server01 -Credential $c

 

这些命令使用由 Get-Credential 创建的凭证对象来认证一个远程计算机上的用户 , 以允许能够使用 Windows Management Instrumentation (WMI) 来管理远程计算机 .

 

第一个命令取得凭证对象并将其存储在变量 $c 中 . 第二个命令在 Get-WimObject 命令中使用凭证对象 . 此命令取得计算机 Server01 上的磁盘驱动器信息 .

 

例 3

 

C:/PS>C:/PS>Get-WmiObject Win32_BIOS -ComputerName Server01 '

-Credential (get-credential Domain01/User01)

 

此命令展示了如何在 Get-WmiObject 命令中包含 Get-Credential 命令 .

 

此命令使用 Get-WmiObject cmdlet 取得计算机 Server01 上的 BIOS 信息 . 它使用 Credential 参数来认证用户 : Domain01/User01, 并使用 Get-Credential 命令作为 Credential 参数的值 .

 

相关链接

Get-WmiObject