HOWTO · PowerShell

在 PowerShell 中使用凭证管理器模块

本文将讨论在 PowerShell 中安装凭证管理器模块并利用其命令来管理我们存储的密码。

本页内容

CredentialManager PowerShell 模块提供了用于管理 Windows Credential Manager 中凭证的命令。对于需要按目标名称保存或检索凭证的脚本,这个模块很实用。Windows 和 PowerShell 版本可能还包含其他凭证相关命令;如果该模块的已存凭证命令适合你的任务,就可以使用它。

安装并检查 Credential Manager 模块

使用 Install-Module -Name CredentialManager -Scope CurrentUser,即可从 PowerShell Gallery 为当前用户安装模块。以当前用户身份安装无需打开提升权限的 shell。PowerShell 可能会要求你确认使用该存储库;安装还需要能够访问 Gallery。如果组织管理模块源或执行策略,请遵循组织的配置。

该模块的主要操作包括:使用 New-StoredCredential 保存条目、使用 Get-StoredCredential 检索条目,以及使用 Remove-StoredCredential 删除条目。运行 Get-Command -Module CredentialManager 可以查看这些命令;运行 Get-Help Get-StoredCredential -Full 可以阅读已安装的帮助文档。由于行为可能因模块版本而异,查看帮助有助于确认支持的参数,包括持久化选项。这些命令要求已安装该模块,且适用于 Windows;下方示例并不表示这里实际运行过模块命令。

示例使用 Contoso 作为目标名称,使用 User2 作为账户名。为自己的服务和账户选择稳定且明确的目标名称。如果你的命名方案允许同一服务有多个账户,请勿假定目标名称能唯一标识某个用户。

创建并存储凭证

避免将密码直接写入命令、脚本、源代码存储库或 shell 历史记录。能读取这些内容的其他人员或工具可能会看到明文密码。Get-Credential 会以交互方式提示输入账户信息,并返回 PSCredential;New-StoredCredential 则将目标名称、用户名和密码作为独立参数,因此应明确传入这些值,而不是通过管道传递凭证对象。在已安装该模块的会话中,先运行 $prompted = Get-Credential -UserName User2 -Message "Enter the Contoso account password:",再运行 $prompted 对应的存储命令:New-StoredCredential -Target Contoso -UserName $prompted.UserName -Password $prompted.GetNetworkCredential().Password。其中的提示消息仍为英文。密码是在提示中输入的,而不是作为字面值写入命令;不过,模块的 -Password 参数在进程内存中接收的是明文字符串。避免记录该值,并运行 Get-Help New-StoredCredential -Full 查看已安装模块版本的参数说明。

目标名称是之后查找或删除该条目的键。命令的返回显示取决于已安装的模块和运行环境,因此没有固定输出可供照抄。下面的独立示例使用本地样例数据,确定性地展示凭证对象的结构。它不会访问 Windows Credential Manager,也不会存储真实账户密码:

$sampleCredential = [pscredential]::new('User2', [System.Security.SecureString]::new())
$Cred = $sampleCredential
"User: $($Cred.UserName)"
"Password type: $($Cred.Password.GetType().Name)"
User: User2
Password type: SecureString

检索已存储的凭证

在已安装该模块的会话中,使用存储条目时相同的目标值检索凭证:$Cred = Get-StoredCredential -Target Contoso。将结果赋给变量后,脚本便可以访问返回的凭证对象。可通过 $Cred.UserName 获取用户名;密码则以 SecureString 表示。检索操作不会将账户密码作为普通文本打印出来。只在必要时将该对象保留在内存中,并将它传给接受凭证对象的命令,避免把密码转换为明文。

如果找不到匹配的条目,结果可能是 $null;在较大的脚本中使用结果前,请先检查这一点。这些命令依赖 Windows 凭证存储和已安装的模块;上面的本地示例只展示对象属性,不能证明存在已存储的条目。

删除并验证已存储的凭证

Remove-StoredCredential -Target Contoso 会删除由目标名称选中的条目。运行命令前请仔细确认目标名称,尤其是在脚本中;错误的值可能会选中你原本打算保留的条目。删除操作可能不会产生可见输出。

使用 Get-StoredCredential -Target Contoso 检索同一目标,然后检查返回值是否为 $null,即可验证结果。如果是 $null,表示该目标没有匹配的凭证。如果返回了对象,请先核对目标名称的拼写和账户命名规则,再决定如何处理;不要扩大删除操作的目标范围。单独执行检索检查很重要,因为删除成功时命令本身可能没有任何可见输出。