Udostępnij za pośrednictwem

Install-PackageProvider

  • Odwołanie
Moduł:
PackageManagement

Instaluje co najmniej jednego dostawcę pakietów zarządzania pakietami.

Składnia

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>]
Install-PackageProvider
       [-Scope <String>]
       [-InputObject] <SoftwareIdentity[]>
       [-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 w programie PowerShellGet. Domyślnie obejmuje to moduły dostępne w galerii Windows PowerShell z tagiem PackageManagement. Dostawca zarządzania pakietami PowerShellGet jest używany 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.

To polecenie cmdlet instaluje również pasujących dostawców zarządzania pakietami, którzy są dostępni w magazynie obiektów blob azure zarządzania pakietami. Użyj dostawcy programu bootstrapper, aby je znaleźć i zainstalować.

W celu wykonania po raz pierwszy pakiet PackageManagement wymaga połączenia internetowego w celu pobrania dostawcy pakietów NuGet. Jeśli jednak komputer nie ma połączenia z Internetem i musisz użyć dostawcy NuGet lub PowerShellGet, możesz pobrać je na innym komputerze i skopiować je na komputer docelowy. Wykonaj następujące czynności:

  1. Uruchom polecenie Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force , aby zainstalować dostawcę z komputera z połączeniem internetowym.
  2. Po zainstalowaniu można znaleźć dostawcę zainstalowanego w $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> programie lub $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. <ProviderName> Umieść folder, który w tym przypadku to folder NuGet, w odpowiedniej lokalizacji na komputerze docelowym. Jeśli komputer docelowy jest serwerem Nano Server, należy uruchomić Install-PackageProvider z serwera Nano Server, aby pobrać poprawne pliki binarne NuGet.
  4. Uruchom ponownie program PowerShell, aby automatycznie załadować dostawcę pakietów. Możesz też uruchomić polecenie Get-PackageProvider -ListAvailable , aby wyświetlić listę wszystkich dostawców pakietów dostępnych na komputerze. Następnie użyj polecenia Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 , aby zaimportować dostawcę do bieżącej sesji Windows PowerShell.

Przykłady

Przykład 1. Instalowanie dostawcy pakietów z Galeria programu PowerShell

To polecenie instaluje dostawcę pakietów GistProvider z Galeria programu PowerShell.

Install-PackageProvider -Name "GistProvider" -Verbose

Przykład 2. Instalowanie określonej wersji dostawcy pakietów

W tym przykładzie zainstalowano określoną wersję 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

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 sposób, aby $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies 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ę.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Określa konto użytkownika, które ma uprawnienia do instalowania dostawców pakietów.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceBootstrap

Wskazuje, że to polecenie cmdlet automatycznie instaluje dostawcę pakietów.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Określa obiekt SoftwareIdentity . Find-PackageProvider Użyj polecenia cmdlet , aby uzyskać obiekt SoftwareIdentity do potoku do Install-PackageProviderelementu .

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-MaximumVersion

Określa maksymalną dozwoloną wersję dostawcy pakietów, którą chcesz zainstalować. Jeśli ten parametr nie zostanie dodany, Install-PackageProvider zainstaluje najwyższą dostępną wersję dostawcy.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Określa minimalną dozwoloną wersję dostawcy pakietów, którą chcesz zainstalować. Jeśli ten parametr nie zostanie dodany, zainstaluje najwyższą dostępną wersję pakietu, Install-PackageProvider która spełnia również wszelkie wymagania określone przez parametr MaximumVersion .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa co najmniej jedną nazwę modułu dostawcy pakietów. Rozdziel wiele nazw pakietów przecinkami. Symbole wieloznaczne nie są obsługiwane.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

Określa serwer proxy dla żądania, zamiast łączyć się bezpośrednio z zasobem internetowym.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProxyCredential

Określa konto użytkownika, które ma uprawnienia do używania serwera proxy określonego przez parametr serwera proxy .

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

Określa dokładną dozwoloną wersję dostawcy pakietów, którą chcesz zainstalować. Jeśli ten parametr nie zostanie dodany, zainstaluje najwyższą dostępną wersję dostawcy, Install-PackageProvider która spełnia również dowolną maksymalną wersję określoną przez parametr MaximumVersion .

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Określa zakres instalacji dostawcy. Dopuszczalne wartości dla tego parametru to:

  • AllUsers — instaluje dostawców w lokalizacji dostępnej 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ępne tylko dla bieżącego użytkownika. Domyślnie jest to $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.

Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Source

Określa jedno lub więcej źródeł pakietów. Użyj polecenia cmdlet , Get-PackageSource aby uzyskać listę dostępnych źródeł pakietów.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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ć potokiem 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 Galeria 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 ogłoszenie w blogu programu PowerShell.