Install-PackageProvider
Instaluje co najmniej jednego dostawcę pakietów zarządzania pakietami.
Składnia
PackageBySearch (Domyślna)
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>]
Opis
Polecenie Install-PackageProvider cmdlet instaluje pasujących dostawców zarządzania pakietami, którzy są dostępni w źródłach pakietów zarejestrowanych za pomocą modułu PowerShellGet. Domyślnie obejmuje to moduły dostępne w galerii programu Windows PowerShell z tagiem PackageManagement . Dostawca zarządzania pakietami PowerShellGet służy do znajdowania dostawców w tych repozytoriach.
To polecenie cmdlet instaluje również pasujących dostawców zarządzania pakietami, którzy są dostępni przy użyciu aplikacji bootstrapping zarządzania pakietami.
Przykłady
Przykład 1. Instalowanie dostawcy pakietów z galerii programu PowerShell
To polecenie instaluje dostawcę pakietów GistProvider z galerii programu PowerShell.
Install-PackageProvider -Name "GistProvider" -Verbose
Przykład 2. Instalowanie określonej wersji dostawcy pakietów
W tym przykładzie jest instalowana określona wersja dostawcy pakietów NuGet.
Pierwsze polecenie znajduje wszystkie wersje dostawcy pakietów o nazwie NuGet. Drugie polecenie instaluje określoną wersję dostawcy pakietów NuGet.
Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force
Dostawcę pakietów NuGet należy zainstalować tylko wtedy, gdy używasz PackageManagement w wersji 1.1.0.0 w Windows PowerShell. Nowsze wersje PowerShellGet i PackageManagement domyślnie zawierają dostawcę pakietów NuGet.
Przykład 3. Znajdowanie dostawcy i instalowanie go
W tym przykładzie użyto Find-PackageProvider metody i potoku, aby wyszukać dostawcę Gist i zainstalować go.
Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose
Przykład 4. Instalowanie dostawcy w folderze modułu bieżącego użytkownika
To polecenie instaluje dostawcę pakietów w taki $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies sposób, aby tylko bieżący użytkownik mógł go używać.
Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser
Parametry
-AllVersions
Wskazuje, że to polecenie cmdlet instaluje wszystkie dostępne wersje dostawcy pakietów. Domyślnie Install-PackageProvider zwraca tylko najwyższą dostępną wersję.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Confirm
Prosi o potwierdzenie przed uruchomieniem cmdletu.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | por |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Credential
Określa konto użytkownika, które ma uprawnienia do instalowania dostawców pakietów.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
PackageBySearch
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Force
Wskazuje, że to polecenie cmdlet wymusza wszystkie akcje za pomocą tego polecenia cmdlet, które można wymusić. Obecnie oznacza to, że parametr Force działa tak samo jak parametr ForceBootstrap .
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ForceBootstrap
Wskazuje, że to polecenie cmdlet automatycznie instaluje dostawcę pakietów.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Określa obiekt SoftwareIdentity . Użyj polecenia cmdlet , Find-PackageProvider aby uzyskać obiekt SoftwareIdentity , aby przekazać potok do elementu Install-PackageProvider.
Właściwości parametru
| Typ: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
PackageByInputObject
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-MaximumVersion
Określa maksymalną dozwoloną wersję dostawcy pakietów, który chcesz zainstalować. Jeśli ten parametr nie zostanie dodany, Install-PackageProvider zainstaluje najwyższą dostępną wersję dostawcy.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
PackageBySearch
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-MinimumVersion
Określa minimalną dozwoloną wersję dostawcy pakietów, który chcesz zainstalować. Jeśli ten parametr nie zostanie dodany, Install-PackageProvider zainstaluje najwyższą dostępną wersję pakietu, która spełnia również wszelkie wymagania określone przez parametr MaximumVersion .
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
PackageBySearch
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Określa co najmniej jedną nazwę modułu dostawcy pakietów. Oddzielaj wiele nazw pakietów przecinkami. Symbole wieloznaczne nie są obsługiwane.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
PackageBySearch
| Position: | 0 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Proxy
Określa serwer proxy dla żądania, zamiast łączyć się bezpośrednio z zasobem internetowym.
Właściwości parametru
| Typ: | Uri |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ProxyCredential
Określa konto użytkownika, które ma uprawnienia do używania serwera proxy określonego przez parametr Proxy.
Właściwości parametru
| Typ: | PSCredential |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-RequiredVersion
Określa dokładną dozwoloną wersję dostawcy pakietów, który chcesz zainstalować. Jeśli ten parametr Install-PackageProvider nie zostanie dodany, zainstaluje najwyższą dostępną wersję dostawcy, która spełnia również dowolną maksymalną wersję określoną przez parametr MaximumVersion .
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
PackageBySearch
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Scope
Określa zakres instalacji dostawcy. Dopuszczalne wartości tego parametru to:
AllUsers — instaluje dostawców w lokalizacji, która jest dostępna dla wszystkich użytkowników komputera. Domyślnie jest to $env:ProgramFiles\PackageManagement\ProviderAssemblies.
CurrentUser — instaluje dostawców w lokalizacji, w której są dostępni tylko dla bieżącego użytkownika. Domyślnie jest to $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Dopuszczalne wartości: | CurrentUser, AllUsers |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Source
Określa co najmniej jedno źródło pakietu.
Get-PackageSource Użyj polecenia cmdlet , aby uzyskać listę dostępnych źródeł pakietów.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
PackageBySearch
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-WhatIf
Pokazuje, co się stanie, jeśli polecenie cmdlet zostanie uruchomione. Cmdlet nie został uruchomiony.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | False |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Wi |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Do tego polecenia cmdlet można przekazać obiekt SoftwareIdentity . Użyj Find-PackageProvider polecenia , aby uzyskać obiekt SoftwareIdentity , który można przekazać do Install-PackageProviderelementu .
Uwagi
Ważne
Od kwietnia 2020 r. galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do galerii programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Aby uzyskać więcej informacji, zobacz anons w blogu programu PowerShell.
