Install-Package
Nainstaluje jeden nebo více softwarových balíčků.
Syntaxe
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 na místní počítač jeden nebo více softwarových balíčků. Pokud máte více zdrojů softwaru, použijte Get-PackageProvider a Get-PackageSource zobrazte podrobnosti o vašich 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 jejich konkrétních argumentech. Další informace najdete v referenční dokumentaci 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 softwarový balíček 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 balíčků a zdroje. Parametr Credential používá uživatelský účet 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 je objekt vrácený Find-Package odesláním kanálu a nainstalován .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 do kanálu 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 k vyhledání balíčku používá parametry Name a Source . Parametry MinimumVersion a MaximumVersion určují rozsah verzí softwaru. Nainstaluje se nejvyšší verze v rozsahu.
Parametry
-AcceptLicense
AcceptLicense automaticky přijme licenční smlouvu během instalace.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-AllowClobber
Přepíše zprávy upozornění týkající se konfliktů s existujícími příkazy. Přepíše existující příkazy, které mají stejný název jako nainstalované příkazy.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-AllowPrereleaseVersions
Umožňuje instalaci balíčků označených jako předběžné verze.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-AllVersions
Install-Package nainstaluje všechny dostupné verze balíčku. Ve výchozím nastavení se nainstaluje jenom nejnovější verze.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Command
Určuje jeden nebo více příkazů, které Install-Package prohledávají.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ConfigFile
Určuje cestu, která obsahuje konfigurační soubor.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Confirm
Před spuštěním cmdletu vás vyzve k potvrzení.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Contains
Install-Package získá objekty, pokud Obsahuje parametr určuje hodnotu, která odpovídá libovolné z hodnot vlastností objektu.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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 zadejte objekt PSCredential vygenerovaný rutinou Get-Credential . Pokud zadáte uživatelské jméno, zobrazí se výzva k zadání hesla.
Pokud není zadaný parametr Credential , Install-Package použije aktuálního uživatele.
| Typ: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Destination
Určuje cestu ke vstupnímu objektu.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-DscResource
Určuje jeden nebo více prostředků DSC (Desired State Configuration), které prohledávají Install-Package. Pomocí rutiny Find-DscResource vyhledejte prostředky DSC.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ExcludeVersion
Přepněte na vyloučení čísla verze v cestě ke složce.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Filter
Určuje termíny, které se mají vyhledat ve vlastnostech Název a Popis .
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-FilterOnTag
Určuje značku, která filtruje výsledky a vyloučí výsledky, které neobsahují zadanou značku.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Force
Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele. Přepíše omezení, která brání Install-Package úspěšnému dokončení, s výjimkou zabezpečení.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ForceBootstrap
Vynutí PackageManagement , aby automaticky nainstaloval zprostředkovatele balíčku pro zadaný balíček.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Headers
Určuje hlavičky balíčku.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Includes
Určuje, zda Install-Package mají být nalezeny všechny typy balíčků. Přijatelné hodnoty pro tento parametr jsou následující:
- cmdlet
- DscResource
- Funkce
- RoleCapability
- Pracovní postup
| Typ: | String[] |
| Přípustné hodnoty: | Cmdlet, DscResource, Function, RoleCapability, Workflow |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-InputObject
Přijímá vstup kanálu. Určuje balíček pomocí typu SoftwareIdentity balíčku.
Find-Package vypíše objekt SoftwareIdentity .
| Typ: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-InstallUpdate
Označuje, že Install-Package instaluje aktualizace.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-MaximumVersion
Určuje maximální povolenou verzi balíčku, kterou chcete nainstalovat. Pokud tento parametr nezadáte, Install-Package nainstaluje nejnovější verzi balíčku.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-MinimumVersion
Určuje minimální povolenou verzi balíčku, kterou chcete nainstalovat. Pokud tento parametr nepřidáte, Install-Package nainstaluje nejnovější verzi balíčku, která splňuje jakoukoli verzi určenou parametrem MaximumVersion .
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Name
Určuje jeden nebo více názvů balíčků. Více názvů balíčků musí být odděleno čárkami.
| Typ: | String[] |
| Position: | 0 |
| Default value: | None |
| Vyžadováno: | True |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-NoPathUpdate
NoPathUpdate se vztahuje pouze na rutinu Install-Script .
NoPathUpdate je dynamický parametr přidaný poskytovatelem a není podporován Install-Package.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PackageManagementProvider
Určuje název zprostředkovatele PackageManagement .
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ProviderName
Určuje jeden nebo více názvů zprostředkovatelů balíčků, na které se má nastavit obor hledání balíčků. Spuštěním rutiny Get-PackageProvider můžete získat názvy zprostředkovatelů balíčků.
| Typ: | String[] |
| Aliasy: | Provider |
| Přípustné hodnoty: | Bootstrap, NuGet, PowerShellGet |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Proxy
Určuje proxy server pro požadavek místo přímého připojení k internetovému prostředku.
| Typ: | Uri |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ProxyCredential
Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem proxy .
| Typ: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-PublishLocation
Určuje cestu k publikovanému umístění balíčku.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-RequiredVersion
Určuje přesnou povolenou verzi balíčku, kterou chcete nainstalovat. Pokud tento parametr nepřidáte, Install-Package nainstaluje nejnovější verzi balíčku, která splňuje jakoukoli verzi určenou parametrem MaximumVersion .
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-RoleCapability
Určuje pole funkcí rolí.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Scope
Určuje obor, pro který se má balíček nainstalovat. Přijatelné hodnoty pro tento parametr jsou následující:
- Aktuální uživatel
- AllUsers
| Typ: | String |
| Přípustné hodnoty: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ScriptPublishLocation
Určuje cestu k publikovanému umístění skriptu.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-ScriptSourceLocation
Určuje umístění zdroje skriptu.
| Typ: | String |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-SkipDependencies
Přeskočí instalaci závislostí softwaru.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-SkipPublisherCheck
Umožňuje získat verzi balíčku, která je novější než vaše nainstalovaná verze. Například nainstalovaný balíček, který je digitálně podepsaný důvěryhodným vydavatelem, ale nová verze není digitálně podepsaná.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-SkipValidate
Přepněte, který přeskočí ověřování přihlašovacích údajů balíčku.
| Typ: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-Source
Určuje jeden nebo více zdrojů balíčků. Více názvů zdrojů balíčků musí být odděleno čárkami.
Názvy zdrojů balíčků můžete získat spuštěním rutiny Get-PackageSource .
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | True |
| Přijmout zástupné znaky: | False |
-Tag
Určuje jeden nebo více řetězců, které se mají vyhledat v metadatech balíčku.
| Typ: | String[] |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | 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
- Scénář
- Všechno
| Typ: | String |
| Přípustné hodnoty: | Module, Script, All |
| Position: | Named |
| Default value: | None |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
-WhatIf
Ukazuje, co se stane, když Install-Package se rutina spustí. Příkazový modul nebyl spuštěn.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Default value: | False |
| Vyžadováno: | False |
| Přijmout vstup kanálu: | False |
| Přijmout zástupné znaky: | False |
Vstupy
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Objekt SoftwareIdentity můžete do této rutiny převést.
Výstupy
Microsoft.PackageManagement.Packaging.SoftwareIdentity
Tato rutina vrátí objekt SoftwareIdentity pro každý balíček, který nainstaluje.
Poznámky
Zahrnutí zprostředkovatele balíčku do příkazu může zpřístupnit dynamické parametry rutině. Dynamické parametry jsou specifické pro zprostředkovatele balíčku. Rutina Get-Help zobrazí seznam sad parametrů rutiny a zahrnuje sadu parametrů poskytovatele. 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 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.
