Sdílet prostřednictvím

Install-PackageProvider

  • Reference
Modul:
PackageManagement

Nainstaluje jednoho nebo více zprostředkovatelů balíčků Správa balíčků.

Syntax

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>]

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í rutiny PowerShellGet. Ve výchozím nastavení to zahrnuje moduly dostupné v galerii 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í zaváděcí aplikace Správa balíčků.

Tato rutina také nainstaluje odpovídající zprostředkovatele správy balíčků, kteří jsou k dispozici v úložišti objektů blob Azure správa balíčků. Pomocí poskytovatele zaváděcího nástroje je vyhledejte a nainstalujte.

K prvnímu spuštění packageManagement vyžaduje připojení k internetu ke stažení zprostředkovatele balíčku NuGet. Pokud ale váš počítač nemá připojení k internetu a potřebujete použít zprostředkovatele NuGet nebo PowerShellGet, můžete je stáhnout do jiného počítače a zkopírovat do cílového počítače. Postupujte následovně:

  1. Spuštěním příkazu Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force nainstalujte poskytovatele z počítače s připojením k internetu.
  2. Po instalaci najdete nainstalovaného poskytovatele v $env:ProgramFiles\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion> nebo $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies\<ProviderName>\<ProviderVersion>.
  3. <ProviderName> Složku, která je v tomto případě složkou NuGet, umístěte do odpovídajícího umístění v cílovém počítači. Pokud je cílovým počítačem Nano Server, musíte z Nano Serveru spustit příkaz Install-PackageProvider , abyste stáhli správné binární soubory NuGet.
  4. Restartujte PowerShell, aby se poskytovatel balíčku automaticky načetl. Případně spusťte příkaz Get-PackageProvider -ListAvailable a vypište všechny poskytovatele balíčků, kteří jsou v počítači k dispozici. Pak pomocí příkazu Import-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 importujte zprostředkovatele do aktuální relace Windows PowerShell.

Příklady

Příklad 1: Instalace zprostředkovatele balíčků z Galerie prostředí PowerShell

Tento příkaz nainstaluje zprostředkovatele balíčků GistProvider z Galerie prostředí PowerShell.

Install-PackageProvider -Name "GistProvider" -Verbose

Příklad 2: Instalace zadané verze zprostředkovatele balíčků

Tento příklad nainstaluje zadanou verzi zprostředkovatele balíčků NuGet.

První příkaz vyhledá všechny verze zprostředkovatele balíčků s názvem NuGet. Druhý příkaz nainstaluje zadanou verzi zprostředkovatele balíčků NuGet.

Find-PackageProvider -Name "NuGet" -AllVersions
Install-PackageProvider -Name "NuGet" -RequiredVersion "2.8.5.216" -Force

Příklad 3: Vyhledání poskytovatele a jeho instalace

Tento příklad používá Find-PackageProvider kanál a 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 do $env:LOCALAPPDATA\PackageManagement\ProviderAssemblies , aby ho mohl používat jenom 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íčku. Ve výchozím nastavení Install-PackageProvider vrátí pouze nejvyšší dostupnou verzi.

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Credential

Určuje uživatelský účet, který má oprávnění k instalaci zprostředkovatelů balíčků.

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

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

-ForceBootstrap

Označuje, že tato rutina automaticky nainstaluje zprostředkovatele balíčku.

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

-InputObject

Určuje Objekt SoftwareIdentity . Pomocí rutiny Find-PackageProvider získejte objekt SoftwareIdentity , který se má připojit k Install-PackageProviderobjektu .

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

-MaximumVersion

Určuje maximální povolenou verzi zprostředkovatele balíčků, který chcete nainstalovat. Pokud tento parametr nepřidáte, Install-PackageProvider nástroj nainstaluje nejvyšší dostupnou verzi zprostředkovatele.

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

-MinimumVersion

Určuje minimální povolenou verzi zprostředkovatele balíčků, který chcete nainstalovat. Pokud tento parametr nepřidáte, Install-PackageProvider nástroj nainstaluje nejvyšší dostupnou verzi balíčku, která také splňuje všechny požadavky určené parametrem MaximumVersion .

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

-Name

Určuje jeden nebo více názvů modulů poskytovatele balíčků. Více názvů balíčků oddělte čárkami. Zástupné znaky nejsou podporovány.

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

-Proxy

Určuje proxy server pro požadavek místo přímého připojení k internetovému prostředku.

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

-ProxyCredential

Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem Proxy .

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

-RequiredVersion

Určuje přesnou povolenou verzi zprostředkovatele balíčku, který chcete nainstalovat. Pokud tento parametr nepřidáte, Install-PackageProvider nástroj nainstaluje nejvyšší dostupnou verzi zprostředkovatele, která také splňuje jakoukoli maximální verzi určenou parametrem MaximumVersion .

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

-Scope

Určuje rozsah instalace zprostředkovatele. Tento parametr přijímá tyto hodnoty:

  • 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í jenom aktuálnímu uživateli. Ve výchozím nastavení je 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

Určuje jeden nebo více zdrojů balíčků. Pomocí rutiny Get-PackageSource získáte seznam dostupných zdrojů balíčků.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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

Vstupy

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Objekt SoftwareIdentity můžete předvést do této rutiny. Slouží Find-PackageProvider k získání objektu SoftwareIdentity , který lze převést do Install-PackageProviderobjektu .

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 novější, při pokusu o přístup k Galerie 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 tomto oznámení na blogu o PowerShellu.