Install-Package
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
, , AllowClobber
dan 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.
Link Terkait
PowerShellGet
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk