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