Install-Package

  • Referensi
Modul:
PackageManagement

Menginstal satu atau beberapa paket perangkat lunak.

Sintaks

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

Deskripsi

Install-Package Cmdlet menginstal satu atau beberapa paket perangkat lunak di komputer lokal. Jika Anda memiliki beberapa sumber perangkat lunak, gunakan Get-PackageProvider dan Get-PackageSource untuk menampilkan detail tentang penyedia Anda.

Penting

Perintah yang terkandung dalam modul PackageManagement berbeda dari perintah yang disediakan oleh modul NuGet di Package Manager Console di Visual Studio. Setiap modul memiliki perintah yang tidak tersedia di modul lainnya. Perintah dengan nama yang sama berbeda dalam argumen spesifiknya. Untuk informasi selengkapnya, lihat dokumentasi referensi PowerShell untuk Konsol Manajer Paket Visual Studio.

Contoh

Contoh 1: Menginstal paket berdasarkan nama paket

Install-Package Cmdlet menginstal paket perangkat lunak dan dependensinya.

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

Install-Package menggunakan parameter untuk menentukan Nama dan Sumber paket. Parameter Info masuk menggunakan akun pengguna domain dengan izin untuk menginstal paket. Perintah meminta kata sandi akun pengguna kepada Anda.

Contoh 2: Gunakan Find-Package untuk menginstal paket

Dalam contoh ini, objek yang dikembalikan oleh Find-Package dikirim ke bawah alur dan diinstal oleh Install-Package.

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

Find-Package menggunakan parameter Nama dan Sumber untuk menemukan paket. Objek dikirim ke alur dan Install-Package menginstal paket di komputer lokal.

Contoh 3: Menginstal paket dengan menentukan rentang versi

Install-Package menggunakan parameter MinimumVersion dan MaximumVersion untuk menentukan berbagai versi perangkat lunak.

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

Install-Package menggunakan parameter Nama dan Sumber untuk menemukan paket. Parameter MinimumVersion dan MaximumVersion menentukan berbagai versi perangkat lunak. Versi tertinggi dalam rentang diinstal.

Parameter

-AcceptLicense

AcceptLicense secara otomatis menerima perjanjian lisensi selama penginstalan.

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

-AllowClobber

Mengambil alih pesan peringatan tentang konflik dengan perintah yang ada. Menimpa perintah yang ada yang memiliki nama yang sama dengan perintah yang diinstal.

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

-AllowPrereleaseVersions

Memungkinkan penginstalan paket yang ditandai sebagai prarilis.

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

-AllVersions

Install-Package menginstal semua versi paket yang tersedia. Secara default, hanya versi terbaru yang diinstal.

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

-Command

Menentukan satu atau beberapa perintah yang Install-Package dicari.

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

-ConfigFile

Menentukan jalur yang berisi file konfigurasi.

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

-Confirm

Meminta Anda mengonfirmasi sebelum menjalankan cmdlet.

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

-Contains

Install-Package mendapatkan objek jika parameter Contains menentukan nilai yang cocok dengan salah satu nilai properti objek.

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

-Credential

Menentukan akun pengguna yang memiliki izin untuk mengakses komputer dan menjalankan perintah. Ketik nama pengguna, seperti User01, Domain01\User01, atau masukkan objek PSCredential , yang dihasilkan oleh Get-Credential cmdlet . Jika Anda mengetikkan nama pengguna, Anda akan dimintai kata sandi.

Ketika parameter Kredensial tidak ditentukan, Install-Package menggunakan pengguna saat ini.

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

-Destination

Menentukan jalur ke objek input.

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

-DscResource

Menentukan satu atau beberapa sumber daya Desired State Configuration (DSC) yang dicari oleh Install-Package. Find-DscResource Gunakan cmdlet untuk menemukan sumber daya DSC.

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

-ExcludeVersion

Beralih untuk mengecualikan nomor versi di jalur folder.

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

-Filter

Menentukan istilah yang akan dicari dalam properti Nama dan Deskripsi .

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

-FilterOnTag

Menentukan tag yang memfilter hasil dan mengecualikan hasil yang tidak berisi tag yang ditentukan.

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

-Force

Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna. Mengambil alih pembatasan yang mencegah Install-Package keberhasilan, dengan pengecualian keamanan.

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

-ForceBootstrap

Forces PackageManagement untuk menginstal penyedia paket secara otomatis untuk paket yang ditentukan.

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

-Headers

Menentukan header paket.

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

-Includes

Menentukan apakah Install-Package harus menemukan semua jenis paket. Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:

  • Cmdlet
  • DscResource
  • Fungsi
  • RoleCapability
  • Alur kerja
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

Menerima input alur. Menentukan paket dengan menggunakan jenis SoftwareIdentity paket. Find-Package menghasilkan objek SoftwareIdentity .

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

-InstallUpdate

Menunjukkan bahwa Install-Package menginstal pembaruan.

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

-MaximumVersion

Menentukan versi paket maksimum yang diizinkan yang ingin Anda instal. Jika Anda tidak menentukan parameter ini, Install-Package instal versi terbaru paket.

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

-MinimumVersion

Menentukan versi paket minimum yang diizinkan yang ingin Anda instal. Jika Anda tidak menambahkan parameter ini, Install-Package instal versi terbaru paket yang memenuhi versi apa pun yang ditentukan oleh parameter MaximumVersion .

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

-Name

Menentukan satu atau beberapa nama paket. Beberapa nama paket harus dipisahkan dengan koma.

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

-NoPathUpdate

NoPathUpdate hanya berlaku untuk Install-Script cmdlet . NoPathUpdate adalah parameter dinamis yang ditambahkan oleh penyedia dan tidak didukung oleh Install-Package.

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

-PackageManagementProvider

Menentukan nama penyedia PackageManagement .

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

-ProviderName

Menentukan satu atau beberapa nama penyedia paket untuk mencakup pencarian paket Anda. Anda bisa mendapatkan nama penyedia paket dengan menjalankan Get-PackageProvider 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

Menentukan server proksi untuk permintaan, daripada menyambungkan langsung ke sumber daya internet.

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

-ProxyCredential

Menentukan akun pengguna yang memiliki izin untuk menggunakan server proksi yang ditentukan oleh parameter Proksi .

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

-PublishLocation

Menentukan jalur ke lokasi paket yang diterbitkan.

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

-RequiredVersion

Menentukan versi paket yang diperbolehkan yang tepat yang ingin Anda instal. Jika Anda tidak menambahkan parameter ini, Install-Package instal versi terbaru paket yang memenuhi versi apa pun yang ditentukan oleh parameter MaximumVersion .

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

-RoleCapability

Menentukan array kemampuan peran.

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

-Scope

Menentukan cakupan untuk menginstal paket. Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:

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

-ScriptPublishLocation

Menentukan jalur ke lokasi skrip yang diterbitkan.

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

-ScriptSourceLocation

Menentukan lokasi sumber skrip.

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

-SkipDependencies

Melompati penginstalan dependensi perangkat lunak.

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

-SkipPublisherCheck

Memungkinkan Anda mendapatkan versi paket yang lebih baru dari versi yang diinstal. Misalnya, paket terinstal yang ditandatangani secara digital oleh penerbit tepercaya tetapi versi baru tidak ditandatangani secara digital.

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

-SkipValidate

Alihkan yang melewati validasi kredensial paket.

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

-Source

Menentukan satu atau beberapa sumber paket. Beberapa nama sumber paket harus dipisahkan dengan koma. Anda bisa mendapatkan nama sumber paket dengan menjalankan Get-PackageSource cmdlet .

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

-Tag

Menentukan satu atau beberapa string untuk dicari dalam metadata paket.

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

-Type

Menentukan apakah akan mencari paket dengan modul, skrip, atau keduanya. Nilai yang dapat diterima untuk parameter ini adalah sebagai berikut:

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

-WhatIf

Menunjukkan apa yang akan terjadi jika Install-Package cmdlet dijalankan. Cmdlet tidak dijalankan.

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

Input

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Anda dapat menyalurkan objek SoftwareIdentity ke cmdlet ini.

Output

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Cmdlet ini mengembalikan objek SoftwareIdentity untuk setiap paket yang diinstalnya.

Catatan

Menyertakan penyedia paket dalam perintah dapat membuat parameter dinamis tersedia untuk cmdlet. Parameter dinamis khusus untuk penyedia paket. Get-Help Cmdlet mencantumkan set parameter cmdlet dan menyertakan kumpulan parameter penyedia. Misalnya, Install-Package memiliki set parameter PowerShellGet yang mencakup -NoPathUpdate, , AllowClobberdan SkipPublisherCheck.

Penting

Mulai April 2020, PowerShell Gallery tidak lagi mendukung Transport Layer Security (TLS) versi 1.0 dan 1.1. Jika Anda tidak menggunakan TLS 1.2 atau yang lebih tinggi, Anda akan menerima kesalahan saat mencoba mengakses Galeri PowerShell. Gunakan perintah berikut untuk memastikan Anda menggunakan TLS 1.2:

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

Untuk informasi selengkapnya, lihat pengumuman di blog PowerShell.