dotnet nuget update client-cert

本文適用於:✔️.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
    

也請參閱