Install-Package
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-Package
keresett 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-Package
Egy 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.