本文適用於:✔️.NET Core 3.1.400 SDK 及後續版本
Name
dotnet nuget update client-cert - 更新 NuGet 套件來源的用戶端憑證設定。
Synopsis
dotnet nuget update client-cert --package-source <SOURCE_NAME>
[--path <CERTIFICATE_PATH>] [--password <PASSWORD>]
[--store-password-in-clear-text] [--configfile <FILE>] [-f|--force]
dotnet nuget update client-cert --package-source <SOURCE_NAME>
[--find-value <VALUE>] [--find-by <FIND_TYPE>]
[--store-location <LOCATION>] [--store-name <STORE_NAME>]
[--configfile <FILE>] [-f|--force]
dotnet nuget update client-cert -h|--help
Description
指令會 dotnet nuget update client-cert 更新與套件來源名稱相符的用戶端憑證設定。 該配置必須已經存在。 要新增設定,請使用 dotnet nuget add client-cert。
請至少為現有憑證來源類型指定一個設定:
-
檔案: 請指定
--path、或--password兩者皆有。 -
憑證儲存: 指定一個或多個
--store-location、--store-name、--find-by和--find-value。
你省略的設定會保留原本的數值。 例如,若要替換使用相同密碼的憑證檔案,只需 --path指定 。 若要更改密碼儲存方式,請再次--password--store-password-in-clear-text輸入;本身並不會更新設定。
不要把檔案選項和商店選項合併。 你無法將檔案設定改成儲存設定,或將儲存設定改成檔案設定。 若要更改憑證來源類型,先 移除該設定,然後新增新的 設定。
除非你特別指定 --force,NuGet 會先檢查它能找到並載入憑證,然後才儲存設定。 這個指令不會測試與套件來源的認證。
選項
-
--configfile <FILE>要使用的 NuGet 組態檔 (nuget.config)。 若已指定,僅會使用此檔案中的設定。 若未指定,則將使用當前目錄中組態檔的階層。 如需詳細資訊,請參閱常見的 NuGet 組態。
--find-by <FIND_TYPE>憑證儲存搜尋方法。 數值不區分大小寫。 使用不含
FindBy前綴的 X.509 尋得型。 例如,使用Thumbprint或SubjectName,而非FindByThumbprintFindBySubjectName或 。 對於所有被接受 的--find-by值,請參考 add 指令的選項。--find-value <VALUE>在憑證儲存庫中搜尋的值,例如憑證的拇指或主題名稱。
-f|--force即使 NuGet 找不到或載入憑證,也能保存設定檔。 這個選項不會停用 HTTPS 伺服器的憑證驗證。
-
-?|-h|--help輸出有關如何使用命令的說明。
-s|--package-source <SOURCE_NAME>與現有用戶端憑證設定相關的套件來源名稱。 Required. 請指定來源名稱,而非網址。
--password <PASSWORD>憑證檔案的密碼。 只能用檔案設定。 預設情況下,NuGet 會在儲存密碼前加密密碼。
Note
密碼加密僅支援 Windows。 只有同一台電腦上的同一個使用者才能解密密碼。
--path <CERTIFICATE_PATH>通往替換憑證檔案的路徑。
要選擇特定檔案,請使用絕對路徑。 對於相對路徑,NuGet 會先檢查目前的工作目錄。 如果檔案不在,NuGet 會檢查相對於包含 NuGet 設定檔的目錄的路徑。
--store-location <LOCATION>憑證儲存地點:
CurrentUser或LocalMachine。--store-name <STORE_NAME>證書商店名稱。 公認的值為
AddressBook、AuthRoot、CertificateAuthorityTrustedPublisherDisallowedMyRootTrustedPeople和 。 憑證儲存庫的可用性取決於你的作業系統。--store-password-in-clear-text儲存憑證檔案密碼時沒有加密。 用 指定這個選項
--password。 若要在非 Windows 平台儲存密碼,請使用此選項。Warning
盡量避免使用明文密碼。 限制存取包含密碼的設定檔,且不要將密碼或私鑰提交給原始碼控制。
Examples
這些範例需要一個名為 Contoso的套件來源的現有用戶端憑證設定。
更換一個憑證檔案。 如果替換密碼使用不同密碼,也請指定
--password:dotnet nuget update client-cert --package-source Contoso --path .\replacement-client.pfx --configfile .\nuget.config更新商店設定,使用不同的憑證指紋。 替換
<CERTIFICATE_THUMBPRINT>成新的拇指印:dotnet nuget update client-cert --package-source Contoso --find-by Thumbprint --find-value <CERTIFICATE_THUMBPRINT> --configfile .\nuget.config