HOWTO · PowerShell

在 PowerShell 中使用憑證管理器模組

本文將討論在 PowerShell 中安裝憑證管理器模組並利用其命令來管理我們儲存的密碼。

本頁內容

CredentialManager PowerShell 模組提供管理 Windows Credential Manager 中憑證的命令。需要依目標儲存或檢索憑證的指令碼可以使用此模組。Windows 和 PowerShell 版本可能也包含其他憑證相關命令;請在此模組的儲存憑證命令符合需求時使用它。

安裝並檢查 Credential Manager 模組

使用 Install-Module -Name CredentialManager -Scope CurrentUser,從 PowerShell Gallery 為目前使用者安裝模組。以目前使用者範圍安裝時,不需要提升權限的殼層。PowerShell 可能會要求你確認使用此存放庫;安裝也需要能連線到 Gallery。如果組織管理模組來源或執行原則,請遵循組織的設定。

此模組的主要操作包括用來儲存項目的 New-StoredCredential、用來檢索項目的 Get-StoredCredential,以及用來刪除項目的 Remove-StoredCredential。使用 Get-Command -Module CredentialManager 檢查命令,並透過 Get-Help Get-StoredCredential -Full 閱讀已安裝的文件。模組行為可能因版本而異,因此可利用說明確認支援的參數,包括持續性選項。這些命令需要先安裝模組,且適用於 Windows;下方範例不表示這裡曾執行過模組命令。

範例使用 Contoso 作為示範目標,並以 User2 作為帳戶名稱。請為自己的服務和帳戶選擇穩定且明確的目標。如果你的命名方式允許同一服務有多個帳戶,請勿假設目標名稱能識別特定使用者。

建立並儲存憑證

避免將密碼直接放在命令、指令碼、原始碼存放庫或殼層歷程記錄中。能讀取這些內容的其他人或工具可能會看到明文密碼。Get-Credential 會以互動方式提示輸入帳戶資訊並傳回 PSCredential;New-StoredCredential 則將目標、使用者名稱和密碼分別作為參數,因此請明確傳入這些值,而不要將物件透過管線傳入。在已安裝模組的工作階段中,先執行 $prompted = Get-Credential -UserName User2 -Message "Enter the Contoso account password:",再執行 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。若是,表示該目標沒有相符的憑證。如果傳回物件,請先確認目標拼寫和帳戶命名方式,再嘗試一次;不要擴大移除操作的目標範圍。移除命令本身可能完全沒有輸出,因此需要另外透過檢索來確認結果。