Install-Package

  • Reference
Modul:
PackageManagement

Nainstaluje jeden nebo více softwarových balíčků.

Syntax

Install-Package
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Source <String[]>]
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ProviderName <String[]>]
       [<CommonParameters>]
Install-Package
       [-InputObject] <SoftwareIdentity[]>
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]
Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Description

Rutina Install-Package nainstaluje jeden nebo více softwarových balíčků do místního počítače. Pokud máte více zdrojů softwaru, použijte Get-PackageProvider a Get-PackageSource k zobrazení podrobností o poskytovatelích.

Důležité

Příkazy obsažené v modulu PackageManagement se liší od příkazů poskytovaných modulem NuGet v konzole Správce balíčků sady Visual Studio. Každý modul obsahuje příkazy, které nejsou k dispozici v druhém modulu. Příkazy se stejným názvem se liší v konkrétních argumentech. Další informace najdete v referenční dokumentaci k PowerShellu pro konzolu Správce balíčků sady Visual Studio.

Příklady

Příklad 1: Instalace balíčku podle názvu balíčku

Rutina Install-Package nainstaluje balíček softwaru a jeho závislosti.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package používá parametry k zadání názvu azdroje balíčků. Parametr Credential používá účet uživatele domény s oprávněními k instalaci balíčků. Příkaz vás vyzve k zadání hesla uživatelského účtu.

Příklad 2: Instalace balíčku pomocí Find-Package

V tomto příkladu se objekt vrácený nástrojem Find-Package odešle do kanálu a nainstaluje ho .Install-Package

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package používá parametry Name a Source k vyhledání balíčku. Objekt se odešle kanálem a Install-Package nainstaluje balíček do místního počítače.

Příklad 3: Instalace balíčků zadáním rozsahu verzí

Install-Package používá parametry MinimumVersion a MaximumVersion k určení rozsahu verzí softwaru.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package použije k vyhledání balíčku parametry Name a Source . Parametry MinimumVersion a MaximumVersion určují rozsah verzí softwaru. Je nainstalována nejvyšší verze v rozsahu.

Parametry

-AcceptLicense

AcceptLicense automaticky přijme licenční smlouvu během instalace.

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

-AllowClobber

Přepíše upozornění na konflikty s existujícími příkazy. Přepíše existující příkazy, které mají stejný název jako instalované příkazy.

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

-AllowPrereleaseVersions

Umožňuje instalaci balíčků označených jako předběžné verze.

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

-AllVersions

Install-Package nainstaluje všechny dostupné verze balíčku. Ve výchozím nastavení se nainstaluje jenom nejnovější verze.

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

-Command

Určuje jeden nebo více příkazů, které Install-Package budou prohledávat.

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

-ConfigFile

Určuje cestu, která obsahuje konfigurační soubor.

Type:String
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

-Contains

Install-Package získá objekty, pokud parametr Contains určuje hodnotu, která odpovídá některé z hodnot vlastností objektu.

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

-Credential

Určuje uživatelský účet, který má oprávnění pro přístup k počítači a spouštění příkazů. Zadejte uživatelské jméno, například User01, Domain01\User01, nebo objekt PSCredential vygenerovaný rutinou Get-Credential . Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.

Pokud není parametr Credential zadaný, Install-Package použije aktuálního uživatele.

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

-Destination

Určuje cestu ke vstupnímu objektu.

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

-DscResource

Určuje jeden nebo více prostředků Desired State Configuration (DSC), které prohledá .Install-Package Find-DscResource K vyhledání prostředků DSC použijte rutinu .

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

-ExcludeVersion

Přepnutím vyloučíte číslo verze v cestě ke složce.

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

-Filter

Určuje termíny, které se mají vyhledat ve vlastnostech Název a Popis .

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

-FilterOnTag

Určuje značku, která filtruje výsledky a vyloučí výsledky, které neobsahují zadanou značku.

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele. Přepíše omezení, která brání Install-Package úspěšnému dokončení, s výjimkou zabezpečení.

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

-ForceBootstrap

Vynutí , aby packageManagement automaticky nainstaloval zprostředkovatele balíčku pro zadaný balíček.

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

-Headers

Určuje hlavičky balíčku.

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

-Includes

Určuje, jestli Install-Package se mají najít všechny typy balíčků. Přijatelné hodnoty pro tento parametr jsou následující:

  • Rutina
  • DscResource
  • Funkce
  • RoleCapability
  • Pracovní postup
Type:String[]
Accepted values:Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Přijímá vstup kanálu. Určuje balíček pomocí typu SoftwareIdentity balíčku. Find-Package výstupem objektu SoftwareIdentity .

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

-InstallUpdate

Označuje, že Install-Package se instalují aktualizace.

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

-MaximumVersion

Určuje maximální povolenou verzi balíčku, kterou chcete nainstalovat. Pokud tento parametr nezadáte, Install-Package nástroj nainstaluje nejnovější verzi balíčku.

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

-MinimumVersion

Určuje minimální povolenou verzi balíčku, kterou chcete nainstalovat. Pokud tento parametr nepřidáte, Install-Package nástroj nainstaluje nejnovější verzi balíčku, která splňuje jakoukoli verzi určenou 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ů balíčků. Více názvů balíčků musí být odděleno čárkami.

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

-NoPathUpdate

NoPathUpdate se vztahuje pouze na rutinu Install-Script . NoPathUpdate je dynamický parametr přidaný zprostředkovatelem a nepodporuje ho Install-Package.

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

-PackageManagementProvider

Určuje název zprostředkovatele PackageManagement .

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

-ProviderName

Určuje jeden nebo více názvů zprostředkovatelů balíčků, na které se má nastavit rozsah vyhledávání balíčků. Názvy zprostředkovatelů balíčků můžete získat spuštěním rutiny Get-PackageProvider .

Type:String[]
Aliases:Provider
Accepted values:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Required:False
Accept pipeline input:True
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

-PublishLocation

Určuje cestu k publikovanému umístění balíčku.

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

-RequiredVersion

Určuje přesnou povolenou verzi balíčku, který chcete nainstalovat. Pokud tento parametr nepřidáte, Install-Package nástroj nainstaluje nejnovější verzi balíčku, která splňuje jakoukoli verzi určenou parametrem MaximumVersion .

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

-RoleCapability

Určuje pole schopností role.

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

-Scope

Určuje obor, pro který se má balíček nainstalovat. Přijatelné hodnoty pro tento parametr jsou následující:

  • Currentuser
  • Všichniuživatelé
Type:String
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScriptPublishLocation

Určuje cestu k publikovanému umístění skriptu.

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

-ScriptSourceLocation

Určuje umístění zdroje skriptu.

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

-SkipDependencies

Přeskočí instalaci závislostí softwaru.

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

-SkipPublisherCheck

Umožňuje získat verzi balíčku, která je novější než nainstalovaná verze. Například nainstalovaný balíček, který je digitálně podepsaný důvěryhodným vydavatelem, ale není digitálně podepsaný novou verzí.

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

-SkipValidate

Přepínač, který přeskočí ověřování přihlašovacích údajů balíčku.

Type:SwitchParameter
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ů. Více názvů zdrojů balíčků musí být oddělené čárkami. Názvy zdrojů balíčků můžete získat spuštěním rutiny Get-PackageSource .

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

-Tag

Určuje jeden nebo více řetězců, které se mají vyhledat v metadatech balíčku.

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

-Type

Určuje, jestli se mají hledat balíčky pomocí modulu, skriptu nebo obojího. Přijatelné hodnoty pro tento parametr jsou následující:

  • Modul
  • Skript
  • Vše
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Ukazuje, co by se stalo, kdyby Install-Package se rutina spustila. 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.

Výstupy

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Tato rutina vrátí objekt SoftwareIdentity pro každý balíček, který nainstaluje.

Poznámky

Zahrnutí poskytovatele balíčku do příkazu může rutině zpřístupnit dynamické parametry. Dynamické parametry jsou specifické pro zprostředkovatele balíčku. Rutina Get-Help vypíše sady parametrů rutiny a zahrne sadu parametrů zprostředkovatele. Má například Install-Package sadu parametrů PowerShellGet , která zahrnuje -NoPathUpdate, AllowClobbera SkipPublisherCheck.

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.