Install-PackageProvider
Nainstaluje jednoho nebo více zprostředkovatelů balíčků pro správu balíčků.
Syntaxe
PackageBySearch (Výchozí)
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
Rutina Install-PackageProvider nainstaluje odpovídající zprostředkovatele správy balíčků, kteří jsou k dispozici ve zdrojích balíčků registrovaných pomocí modulu PowerShellGet. Ve výchozím nastavení to zahrnuje moduly dostupné v galerii prostředí Windows PowerShell se značkou PackageManagement . Zprostředkovatel správy balíčků PowerShellGet se používá k vyhledání zprostředkovatelů v těchto úložištích.
Tato rutina také nainstaluje odpovídající zprostředkovatele správy balíčků, kteří jsou k dispozici pomocí spouštěcí aplikace Správa balíčků.
Příklady
Příklad 1: Instalace zprostředkovatele balíčku z galerie Prostředí PowerShell
Tento příkaz nainstaluje z galerie Prostředí PowerShell zprostředkovatele balíčků GistProvider.
Install-PackageProvider -Name "GistProvider" -Verbose
Příklad 2: Instalace zadané verze zprostředkovatele balíčku
Tento příklad nainstaluje zadanou verzi zprostředkovatele balíčku NuGet.
První příkaz najde všechny verze zprostředkovatele balíčku s názvem NuGet. Druhý příkaz nainstaluje zadanou verzi zprostředkovatele balíčku NuGet.
Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force
Poskytovatele balíčku NuGet je třeba nainstalovat pouze v případě, že používáte PackageManagement verze 1.1.0.0 v prostředí Windows PowerShell. Novější verze PowerShellGet a PackageManagement ve výchozím nastavení zahrnují poskytovatele balíčků NuGet.
Příklad 3: Vyhledání zprostředkovatele a jeho instalace
Tento příklad používá Find-PackageProvider a kanál k vyhledání zprostředkovatele Gist a jeho instalaci.
Find-PackageProvider -Name "GistProvider" | Install-PackageProvider -Verbose
Příklad 4: Instalace zprostředkovatele do složky modulu aktuálního uživatele
Tento příkaz nainstaluje zprostředkovatele balíčku, aby $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies ho mohl používat pouze aktuální uživatel.
Install-PackageProvider -Name GistProvider -Verbose -Scope CurrentUser
Parametry
-AllVersions
Označuje, že tato rutina nainstaluje všechny dostupné verze zprostředkovatele balíčků. Ve výchozím nastavení Install-PackageProvider vrátí pouze nejvyšší dostupnou verzi.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | viz |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Credential
Určuje uživatelský účet, který má oprávnění k instalaci zprostředkovatelů balíčků.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PackageBySearch
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Force
Označuje, že tato rutina vynutí všechny akce s touto rutinou, které je možné vynutit. V současné době to znamená, že parametr Force funguje stejně jako forceBootstrap parametr.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ForceBootstrap
Označuje, že tato rutina automaticky nainstaluje zprostředkovatele balíčku.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InputObject
Určuje objekt SoftwareIdentity . Pomocí rutiny Find-PackageProvider získejte objekt SoftwareIdentity , do který se má kanálovat Install-PackageProvider.
Vlastnosti parametru
| Typ: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PackageByInputObject
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MaximumVersion
Určuje maximální povolenou verzi zprostředkovatele balíčku, kterého chcete nainstalovat. Pokud tento parametr nepřidáte, Install-PackageProvider nainstaluje nejvyšší dostupnou verzi poskytovatele.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PackageBySearch
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-MinimumVersion
Určuje minimální povolenou verzi zprostředkovatele balíčku, kterého chcete nainstalovat. Pokud tento parametr nepřidáte, Install-PackageProvider nainstaluje nejvyšší dostupnou verzi balíčku, která také splňuje všechny požadavky zadané parametrem MaximumVersion .
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PackageBySearch
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje jeden nebo více názvů modulů zprostředkovatele balíčků. Více názvů balíčků oddělte čárkami. Zástupné znaky nejsou podporovány.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PackageBySearch
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Proxy
Určuje proxy server pro požadavek místo přímého připojení k internetovému prostředku.
Vlastnosti parametru
| Typ: | Uri |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-ProxyCredential
Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem Proxy.
Vlastnosti parametru
| Typ: | PSCredential |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-RequiredVersion
Určuje přesnou povolenou verzi zprostředkovatele balíčku, kterého chcete nainstalovat. Pokud tento parametr nepřidáte, nainstaluje se nejvyšší dostupná verze poskytovatele, Install-PackageProvider která také splňuje všechny maximální verze určené parametrem MaximumVersion .
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PackageBySearch
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Scope
Určuje rozsah instalace poskytovatele. Přijatelné hodnoty pro tento parametr jsou:
AllUsers – nainstaluje poskytovatele do umístění, které je přístupné všem uživatelům počítače. Ve výchozím nastavení je to $env:ProgramFiles\PackageManagement\ProviderAssemblies.
CurrentUser – nainstaluje poskytovatele do umístění, kde jsou přístupní pouze aktuálnímu uživateli. Ve výchozím nastavení je to $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Přípustné hodnoty: | CurrentUser, AllUsers |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Source
Určuje jeden nebo více zdrojů balíčků. Pomocí této rutiny Get-PackageSource získáte seznam dostupných zdrojů balíčků.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
PackageBySearch
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-WhatIf
Ukazuje, co se stane, když se příkaz spustí. Cmdlet se nespustil.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | False |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
| Aliasy: | Wi |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Vstupy
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Objekt SoftwareIdentity můžete do této rutiny převést. Slouží Find-PackageProvider k získání objektu SoftwareIdentity , který lze vložit do Install-PackageProvider.
Poznámky
Důležité
Od dubna 2020 galerie Prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k galerii Prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Další informace najdete v oznámení v blogu PowerShellu.
