Install-PackageProvider
安裝一或多個套件管理套件提供者。
語法
PackageBySearch (預設值)
Install-PackageProvider
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Source <String[]>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
PackageByInputObject
Install-PackageProvider
[-InputObject] <SoftwareIdentity[]>
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdlet Install-PackageProvider 會安裝相符的套件管理提供者,這些提供者可在向 PowerShellGet 註冊的套件來源中取得。 根據預設,這包括 Windows PowerShell 資源庫中具有 PackageManagement 標籤的模組。
PowerShellGet 套件管理提供者用於尋找這些存放庫中的提供者。
此 Cmdlet 也會安裝相符的套件管理提供者,這些提供者可使用套件管理啟動載入應用程式。
範例
範例 1:從 PowerShell 資源庫安裝套件提供者
此命令會從 PowerShell 資源庫安裝 GistProvider 套件提供者。
Install-PackageProvider -Name "GistProvider" -Verbose
範例 2:安裝指定的套件提供者版本
此範例會安裝指定的 NuGet 套件提供者版本。
第一個命令會尋找名為 NuGet 之套件提供者的所有版本。 第二個命令會安裝指定的 NuGet 套件提供者版本。
Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force
如果您在 Windows PowerShell 中運行 PackageManagement v1.1.0.0,則只需安裝 NuGet 包提供程式。 默認情況下,較新版本的PowerShellGet和 PackageManagement包括 NuGet 包提供程式。
範例 3:尋找提供者並加以安裝
此範例會使用 Find-PackageProvider 和管線來搜尋 Gist 提供者並加以安裝。
Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose
範例 4:將提供者安裝至目前使用者的模組資料夾
此命令會安裝套件提供者, $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies 以便只有目前的使用者可以使用它。
Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser
參數
-AllVersions
指出此 Cmdlet 會安裝套件提供者的所有可用版本。 根據預設, Install-PackageProvider 只會傳回最高的可用版本。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Confirm
在執行 Cmdlet 之前,提示您進行確認。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | cf |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Credential
指定有權安裝套件提供者的用戶帳戶。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PackageBySearch
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Force
表示此 Cmdlet 會強制使用此 Cmdlet 的所有動作。 目前,這表示 Force 參數的作用與 ForceBootstrap 參數相同。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ForceBootstrap
表示此 Cmdlet 會自動安裝套件提供者。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-InputObject
指定 SoftwareIdentity 物件。
Find-PackageProvider使用 Cmdlet 取得 SoftwareIdentity 物件,以管線傳送至 Install-PackageProvider。
參數屬性
| 類型: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PackageByInputObject
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MaximumVersion
指定您要安裝之套件提供者的最大允許版本。 如果您未新增此參數, Install-PackageProvider 請安裝提供者的最高可用版本。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PackageBySearch
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-MinimumVersion
指定您要安裝之套件提供者的最低允許版本。 如果您未新增此參數, Install-PackageProvider 請安裝最高可用的套件版本,該套件也符合 MaximumVersion 參數所指定的任何需求。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PackageBySearch
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Name
指定一或多個套件提供者模組名稱。 以逗號分隔多個套件名稱。 不支援通配符。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PackageBySearch
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Proxy
指定要求的 Proxy 伺服器,而不是直接連線到因特網資源。
參數屬性
| 類型: | Uri |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ProxyCredential
指定具有許可權的用戶帳戶,其有權使用 Proxy 參數所指定的 Proxy 伺服器。
參數屬性
| 類型: | PSCredential |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RequiredVersion
指定您要安裝之套件提供者的確切允許版本。 如果不添加此參數, Install-PackageProvider 則安裝提供程式的最高可用版本,該版本還滿足 MaximumVersion 參數指定的任何最高版本。
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PackageBySearch
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Scope
指定提供者的安裝範圍。 此參數可接受的值為:
AllUsers - 將提供程式安裝在電腦的所有使用者都可以訪問的位置。 根據預設,這是 $env:ProgramFiles\PackageManagement\ProviderAssemblies。
CurrentUser - 將提供程式安裝在只有當前使用者才能訪問的位置。 根據預設,這會 $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies。
參數屬性
| 類型: | String |
| 預設值: | None |
| 接受的值: | CurrentUser, AllUsers |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Source
指定一或多個套件來源。
Get-PackageSource使用 Cmdlet 取得可用套件來源的清單。
參數屬性
| 類型: | String[] |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
PackageBySearch
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
顯示 Cmdlet 執行時會發生什麼事。 該 Cmdlet 未被執行。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | False |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 無線 |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。
輸入
Microsoft.PackageManagement.Packaging.SoftwareIdentity
您可以使用管線將 SoftwareIdentity 物件傳送至此 Cmdlet。 用來Find-PackageProvider取得可傳送至的Install-PackageProvider物件。
備註
這很重要
自 2020 年 4 月起,PowerShell 資源庫不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。 如果您未使用 TLS 1.2 或更高版本,當您嘗試存取 PowerShell 資源庫時,會收到錯誤。 使用下列命令以確保您使用 TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
如需詳細資訊,請參閱 PowerShell 部落格中的 公告 。