Udostępnij za pośrednictwem


Install-Package

Instaluje co najmniej jeden pakiet oprogramowania.

Składnia

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

Opis

Polecenie Install-Package cmdlet instaluje co najmniej jeden pakiet oprogramowania na komputerze lokalnym. Jeśli masz wiele źródeł oprogramowania, użyj Get-PackageProvider polecenia i Get-PackageSource wyświetlić szczegółowe informacje o dostawcach.

Ważne

Polecenia zawarte w module PackageManagement różnią się od poleceń udostępnianych przez moduł NuGet w konsoli Menedżera pakietów programu Visual Studio. Każdy moduł zawiera polecenia, które nie są dostępne w drugiej. Polecenia o tej samej nazwie różnią się w swoich konkretnych argumentach. Aby uzyskać więcej informacji, zobacz dokumentację referencyjną programu PowerShell dla konsoli Menedżera pakietów programu Visual Studio.

Przykłady

Przykład 1. Instalowanie pakietu według nazwy pakietu

Polecenie Install-Package cmdlet instaluje pakiet oprogramowania i jego zależności.

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

Install-Package używa parametrów do określania nazw pakietów i źródła. Parametr Credential używa konta użytkownika domeny z uprawnieniami do instalowania pakietów. Polecenie wyświetla monit o hasło konta użytkownika.

Przykład 2. Instalowanie pakietu przy użyciu Find-Package

W tym przykładzie obiekt zwrócony przez Find-Package program jest wysyłany w dół potoku i instalowany przez program Install-Package.

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

Find-Package używa parametrów Nazwa i Źródło do zlokalizowania pakietu. Obiekt jest wysyłany w dół potoku i Install-Package instaluje pakiet na komputerze lokalnym.

Przykład 3. Instalowanie pakietów przez określenie zakresu wersji

Install-Package używa parametrów MinimumVersion i MaximumVersion , aby określić zakres wersji oprogramowania.

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

Install-Package używa parametrów Nazwa i Źródło , aby znaleźć pakiet. Parametry MinimumVersion i MaximumVersion określają zakres wersji oprogramowania. Zainstalowano najwyższą wersję w zakresie.

Parametry

-AcceptLicense

AcceptLicense automatycznie akceptuje umowę licencyjną podczas instalacji.

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

-AllowClobber

Zastępuje komunikaty ostrzegawcze dotyczące konfliktów z istniejącymi poleceniami. Zastępuje istniejące polecenia o tej samej nazwie co instalowane polecenia.

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

-AllowPrereleaseVersions

Umożliwia instalację pakietów oznaczonych jako wersje wstępne.

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

-AllVersions

Install-Package instaluje wszystkie dostępne wersje pakietu. Domyślnie jest zainstalowana tylko najnowsza wersja.

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

-Command

Określa co najmniej jedno polecenie, które Install-Package wyszukuje.

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

-ConfigFile

Określa ścieżkę zawierającą plik konfiguracji.

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Contains

Install-Package pobiera obiekty, jeśli parametr Contains określa wartość zgodną z dowolnymi wartościami właściwości obiektu.

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

-Credential

Określa konto użytkownika, które ma uprawnienia dostępu do komputera i uruchamiania poleceń. Wpisz nazwę użytkownika, taką jak User01, Domain01\User01 lub wprowadź obiekt PSCredential wygenerowany przez Get-Credential polecenie cmdlet. Jeśli wpiszesz nazwę użytkownika, zostanie wyświetlony monit o podanie hasła.

Jeśli parametr Credential nie zostanie określony, Install-Package użyje bieżącego użytkownika.

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

-Destination

Określa ścieżkę do obiektu wejściowego.

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

-DscResource

Określa co najmniej jeden Desired State Configuration zasobów (DSC), które są przeszukiwane przez Install-Package. Find-DscResource Użyj polecenia cmdlet , aby znaleźć zasoby DSC.

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

-ExcludeVersion

Przełącz się, aby wykluczyć numer wersji w ścieżce folderu.

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

-Filter

Określa terminy do wyszukania we właściwościach Nazwa i Opis .

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

-FilterOnTag

Określa tag, który filtruje wyniki i wyklucza wyniki, które nie zawierają określonego tagu.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika. Zastępuje ograniczenia, które uniemożliwiają Install-Package powodzenie, z wyjątkiem zabezpieczeń.

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

-ForceBootstrap

Wymusza pakietManagement , aby automatycznie zainstalować dostawcę pakietów dla określonego pakietu.

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

-Headers

Określa nagłówki pakietu.

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

-Includes

Określa, czy Install-Package powinny znajdować wszystkie typy pakietów. Dopuszczalne wartości tego parametru są następujące:

  • Polecenie cmdlet
  • DscResource
  • Funkcja
  • RolaCapability
  • Przepływ pracy
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

Akceptuje dane wejściowe potoku. Określa pakiet przy użyciu typu SoftwareIdentity pakietu. Find-Package generuje obiekt SoftwareIdentity .

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

-InstallUpdate

Wskazuje, że Install-Package instaluje aktualizacje.

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

-MaximumVersion

Określa maksymalną dozwoloną wersję pakietu, którą chcesz zainstalować. Jeśli nie określisz tego parametru, Install-Package zainstaluje najnowszą wersję pakietu.

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

-MinimumVersion

Określa minimalną dozwoloną wersję pakietu, którą chcesz zainstalować. Jeśli ten parametr nie zostanie dodany, zainstaluje najnowszą wersję pakietu, Install-Package która spełnia dowolną wersję określoną przez parametr MaximumVersion .

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

-Name

Określa co najmniej jedną nazwę pakietu. Wiele nazw pakietów musi być rozdzielonych przecinkami.

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

-NoPathUpdate

NoPathUpdate dotyczy Install-Script tylko polecenia cmdlet. NoPathUpdate jest parametrem dynamicznym dodanym przez dostawcę i nie jest obsługiwany przez Install-Packageprogram .

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

-PackageManagementProvider

Określa nazwę dostawcy PackageManagement .

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

-ProviderName

Określa co najmniej jedną nazwę dostawcy pakietów, do której należy ograniczyć zakres wyszukiwania pakietów. Nazwy dostawców pakietów można uzyskać, uruchamiając Get-PackageProvider polecenie cmdlet.

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

Określa serwer proxy dla żądania, zamiast łączyć się bezpośrednio z zasobem internetowym.

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

-ProxyCredential

Określa konto użytkownika, które ma uprawnienia do używania serwera proxy określonego przez parametr proxy .

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

-PublishLocation

Określa ścieżkę do opublikowanej lokalizacji pakietu.

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

-RequiredVersion

Określa dokładną dozwoloną wersję pakietu, który chcesz zainstalować. Jeśli ten parametr nie zostanie dodany, zainstaluje najnowszą wersję pakietu, Install-Package która spełnia dowolną wersję określoną przez parametr MaximumVersion .

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

-RoleCapability

Określa tablicę możliwości roli.

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

-Scope

Określa zakres, dla którego ma zostać zainstalowany pakiet. Dopuszczalne wartości tego parametru są następujące:

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

-ScriptPublishLocation

Określa ścieżkę do lokalizacji opublikowanej skryptu.

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

-ScriptSourceLocation

Określa lokalizację źródłową skryptu.

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

-SkipDependencies

Pomija instalację zależności oprogramowania.

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

-SkipPublisherCheck

Umożliwia uzyskanie wersji pakietu nowszej niż zainstalowana wersja. Na przykład zainstalowany pakiet podpisany cyfrowo przez zaufanego wydawcę, ale nowa wersja nie jest podpisana cyfrowo.

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

-SkipValidate

Przełącz, który pomija sprawdzanie poprawności poświadczeń pakietu.

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

-Source

Określa co najmniej jedno źródło pakietu. Wiele nazw źródłowych pakietów musi być rozdzielonych przecinkami. Nazwy źródeł pakietów można uzyskać, uruchamiając Get-PackageSource polecenie cmdlet .

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

-Tag

Określa co najmniej jeden ciąg do wyszukania w metadanych pakietu.

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

-Type

Określa, czy wyszukiwać pakiety za pomocą modułu, skryptu, czy obu. Dopuszczalne wartości tego parametru są następujące:

  • Moduł
  • Skrypt
  • Wszystko
Type:String
Accepted values:Module, Script, All
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Pokazuje, co się stanie w przypadku Install-Package uruchomienia polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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

Dane wejściowe

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Do tego polecenia cmdlet można przekazać obiekt SoftwareIdentity .

Dane wyjściowe

Microsoft.PackageManagement.Packaging.SoftwareIdentity

To polecenie cmdlet zwraca obiekt SoftwareIdentity dla każdego instalowanego pakietu.

Uwagi

Dołączenie dostawcy pakietów w poleceniu może udostępnić parametry dynamiczne do polecenia cmdlet. Parametry dynamiczne są specyficzne dla dostawcy pakietów. Polecenie Get-Help cmdlet wyświetla zestawy parametrów polecenia cmdlet i zawiera zestaw parametrów dostawcy. Na przykład Install-Package zestaw parametrów PowerShellGet , który zawiera -NoPathUpdate, AllowClobberi SkipPublisherCheck.

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.