Share via

Install-Package

  • Referencia
Modul:
PackageManagement

Egy vagy több szoftvercsomag telepítése.

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

A Install-Package parancsmag egy vagy több szoftvercsomagot telepít a helyi számítógépre. Ha több szoftverforrással rendelkezik, a és Get-PackageSource a használatával Get-PackageProvider megjelenítheti a szolgáltatók adatait.

Fontos

A PackageManagement modulban található parancsok eltérnek a Visual Studio Csomagkezelő konzolján található NuGet-modul parancsaitól. Mindegyik modul olyan parancsokkal rendelkezik, amelyek nem érhetők el a másikban. Az azonos nevű parancsok az argumentumaikban különböznek. További információkért tekintse meg a Visual Studio Package Manager-konzoljának PowerShell-referenciadokumentációját .

Példák

1. példa: Csomag telepítése csomagnév alapján

A Install-Package parancsmag egy szoftvercsomagot és annak függőségeit telepíti.

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

Install-Package paraméterekkel adja meg a csomagok nevét és forrását. A hitelesítőadat-paraméter egy tartományi felhasználói fiókot használ a csomagok telepítéséhez szükséges engedélyekkel. A parancssorban meg kell adnia a felhasználói fiók jelszavát.

2. példa: Csomag telepítése Find-Package használatával

Ebben a példában a által visszaadott Find-Package objektumot a rendszer elküldi a folyamatnak, és telepíti a következővel Install-Package: .

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

Find-Package a Name (Név ) és a Source (Forrás) paramétereket használja a csomag megkereséséhez. A rendszer elküldi az objektumot a folyamatnak, és Install-Package telepíti a csomagot a helyi számítógépre.

3. példa: Csomagok telepítése verziók tartományának megadásával

Install-Package a MinimumVersion és a MaximumVersion paramétereket használja a szoftververziók tartományának megadásához.

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

Install-Package a Name (Név ) és a Source (Forrás) paramétereket használja a csomag megkereséséhez. A MinimumVersion és a MaximumVersion paraméterek a szoftververziók tartományát határozzák meg. A tartomány legmagasabb verziója van telepítve.

Paraméterek

-AcceptLicense

Az AcceptLicense automatikusan elfogadja a licencszerződést a telepítés során.

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

-AllowClobber

Felülbírálja a meglévő parancsokkal való ütközésekre vonatkozó figyelmeztető üzeneteket. Felülírja azokat a meglévő parancsokat, amelyek neve megegyezik a telepített parancsokkal.

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

-AllowPrereleaseVersions

Lehetővé teszi az előzetesként megjelölt csomagok telepítését.

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

-AllVersions

Install-Package telepíti a csomag összes elérhető verzióját. Alapértelmezés szerint csak a legújabb verzió van telepítve.

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

-Command

Egy vagy több olyan parancsot ad meg, amely Install-Package keres.

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

-ConfigFile

Konfigurációs fájlt tartalmazó elérési utat ad meg.

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

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

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

-Contains

Install-Package objektumokat kap, ha a Contains paraméter olyan értéket ad meg, amely megfelel az objektum bármely tulajdonságértékének.

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

-Credential

Olyan felhasználói fiókot ad meg, amely engedéllyel rendelkezik a számítógép eléréséhez és a parancsok futtatásához. Írjon be egy felhasználónevet (például User01, Domain01\User01), vagy írjon be egy PSCredential objektumot, amelyet a Get-Credential parancsmag hoz létre. Ha beír egy felhasználónevet, a rendszer jelszót kér.

Ha a hitelesítőadat-paraméter nincs megadva, Install-Package az aktuális felhasználót használja.

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

-Destination

Egy bemeneti objektum elérési útját adja meg.

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

-DscResource

Egy vagy több, a által Install-Packagekeresett Desired State Configuration (DSC) erőforrást határoz meg. A DSC-erőforrások megkereséséhez használja a Find-DscResource parancsmagot.

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

-ExcludeVersion

Váltson úgy, hogy kizárja a verziószámot a mappa elérési útján.

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

-Filter

A Név és a Leírás tulajdonságban keresendő kifejezéseket adja meg.

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

-FilterOnTag

Olyan címkét ad meg, amely szűri az eredményeket, és kizárja azokat az eredményeket, amelyek nem tartalmazzák a megadott címkét.

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

-Force

Kényszeríti a parancs futtatását a felhasználó megerősítésének kérése nélkül. Felülbírálja azokat a korlátozásokat, amelyek nem járnak Install-Package sikerrel, a biztonság kivételével.

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

-ForceBootstrap

A PackageManagement kényszeríti a megadott csomag csomagszolgáltatójának automatikus telepítését.

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

-Headers

Megadja a csomagfejléceket.

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

-Includes

Meghatározza, hogy az összes csomagtípust meg kell-e Install-Package találni. A paraméter elfogadható értékei a következők:

  • Parancsmag
  • DscResource
  • Függvény
  • RoleCapability
  • Munkafolyamat
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

Folyamatbemenetet fogad el. A csomag SoftwareIdentity típusával adja meg a csomagot. Find-PackageEgy SoftwareIdentity objektumot ad ki.

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

-InstallUpdate

Azt jelzi, hogy Install-Package telepíti a frissítéseket.

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

-MaximumVersion

Megadja a telepíteni kívánt maximálisan engedélyezett csomagverziót. Ha nem adja meg ezt a paramétert, Install-Package telepíti a csomag legújabb verzióját.

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

-MinimumVersion

Megadja a telepíteni kívánt minimálisan engedélyezett csomagverziót. Ha nem adja hozzá ezt a paramétert, Install-Package telepíti a csomag legújabb verzióját, amely megfelel a MaximumVersion paraméter által megadott bármely verziónak.

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

-Name

Egy vagy több csomagnevet ad meg. Több csomagnevet vesszővel kell elválasztani.

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

-NoPathUpdate

A NoPathUpdate csak a Install-Script parancsmagra vonatkozik. A NoPathUpdate egy dinamikus paraméter, amelyet a szolgáltató ad hozzá, és a nem támogatja.Install-Package

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

-PackageManagementProvider

Megadja a PackageManagement szolgáltató nevét.

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

-ProviderName

Egy vagy több csomagszolgáltatónevet ad meg, amelyre a csomagkeresés hatókörét ki kell terjednie. A csomagszolgáltató nevét a Get-PackageProvider parancsmag futtatásával szerezheti be.

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

Proxykiszolgálót ad meg a kéréshez ahelyett, hogy közvetlenül csatlakozik egy internetes erőforráshoz.

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

-ProxyCredential

Olyan felhasználói fiókot ad meg, amely jogosult a Proxy paraméter által megadott proxykiszolgáló használatára.

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

-PublishLocation

Megadja a csomag közzétett helyének elérési útját.

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

-RequiredVersion

Megadja a telepíteni kívánt csomag pontos engedélyezett verzióját. Ha nem adja hozzá ezt a paramétert, Install-Package telepíti a csomag legújabb verzióját, amely megfelel a MaximumVersion paraméter által megadott bármely verziónak.

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

-RoleCapability

A szerepkör-képességek tömbjének megadása.

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

-Scope

Megadja a csomag telepítési hatókörét. A paraméter elfogadható értékei a következők:

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

-ScriptPublishLocation

Megadja a szkript közzétett helyének elérési útját.

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

-ScriptSourceLocation

Megadja a szkript forráshelyét.

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

-SkipDependencies

Kihagyja a szoftverfüggőségek telepítését.

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

-SkipPublisherCheck

Lehetővé teszi, hogy a telepített verziónál újabb csomagverziót kapjon. Például egy megbízható közzétevő által digitálisan aláírt, de új verziójú telepített csomag nincs digitálisan aláírva.

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

-SkipValidate

Váltás, amely kihagyja egy csomag hitelesítő adatainak érvényesítését.

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

-Source

Egy vagy több csomagforrást határoz meg. Több csomagforrás nevét vesszővel kell elválasztani. A csomag forrásnevét a Get-PackageSource parancsmag futtatásával szerezheti be.

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

-Tag

Egy vagy több sztringet ad meg a csomag metaadataiban való kereséshez.

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

-Type

Meghatározza, hogy modullal, szkripttel vagy mindkettővel szeretne-e csomagokat keresni. A paraméter elfogadható értékei a következők:

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

-WhatIf

Megjeleníti, mi történne, ha Install-Package a parancsmag futna. A parancsmag nem fut.

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

Bevitelek

Microsoft.PackageManagement.Packaging.SoftwareIdentity

A SoftwareIdentity objektumot erre a parancsmagra helyezheti.

Kimenetek

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Ez a parancsmag egy SoftwareIdentity objektumot ad vissza minden telepített csomaghoz.

Jegyzetek

A csomagszolgáltató parancsba való felvétele dinamikus paramétereket tesz elérhetővé a parancsmagok számára. A dinamikus paraméterek egy csomagszolgáltatóra vonatkoznak. A Get-Help parancsmag felsorolja a parancsmag paraméterkészleteit, és tartalmazza a szolgáltató paraméterkészletét. Például Install-Package a PowerShellGet paraméterkészlete tartalmazza a következőt: -NoPathUpdate, AllowClobberés SkipPublisherCheck.

Fontos

2020 áprilisától a PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2-t vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-galéria elérésekor. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

További információt a PowerShell-blog közleményében talál.