Bagikan melalui


Paket Pembaruan (Konsol Manajer Paket di Visual Studio)

Hanya tersedia dalam Konsol Manajer Paket NuGet di Visual Studio di Windows.

Memperbarui paket dan dependensinya, atau semua paket dalam proyek, ke versi yang lebih baru.

Sintaks

Update-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [-Version <string>]
    [-Safe] [-Source <string>] [-IncludePrerelease] [-Reinstall] [-FileConflictAction]
    [-DependencyVersion] [-ToHighestPatch] [-ToHighestMinor] [-WhatIf] [<CommonParameters>]

Di NuGet 2.8+, Update-Package dapat digunakan untuk menurunkan tingkat paket yang ada di proyek Anda. Misalnya, jika Anda menginstal Microsoft.AspNet.MVC 5.1.0-rc1, perintah berikut akan menurunkannya menjadi 5.0.0:

Update-Package Microsoft.AspNet.MVC -Version 5.0.0.

Parameter

Parameter Deskripsi
Id Pengidentifikasi paket yang akan diperbarui. Jika dihilangkan, perbarui semua paket. Sakelar -Id itu sendiri bersifat opsional.
IgnoreDependencies Melompati pembaruan dependensi paket.
ProjectName Nama proyek yang berisi paket yang akan diperbarui, default ke semua proyek.
Versi Versi yang digunakan untuk peningkatan, default ke versi terbaru. Di NuGet 3.0+, nilai versi harus salah satu Dari Terendah, Tertinggi, HighestMinor, atau HighestPatch (setara dengan -Brankas).
Aman Membatasi peningkatan ke hanya versi dengan versi Mayor dan Minor yang sama dengan paket yang saat ini diinstal.
Sumber URL atau jalur folder untuk sumber paket yang akan dicari. Jalur folder lokal bisa absolut, atau relatif terhadap folder saat ini. Jika dihilangkan, Update-Package cari sumber paket yang saat ini dipilih.
SertakanPrerelease Menyertakan paket prarilis untuk pembaruan.
Menginstal ulang Instal ulang paket menggunakan versi yang saat ini diinstal. Lihat Menginstal ulang dan memperbarui paket.
FileConflictAction Tindakan yang harus diambil ketika diminta untuk menimpa atau mengabaikan file yang ada yang dirujuk oleh proyek. Nilai yang mungkin adalah Timpa, Abaikan, Tidak Ada, TimpaSemua, dan AbaikanSemua (3.0+).
DependencyVersion Versi paket dependensi yang akan digunakan, yang bisa menjadi salah satu dari berikut ini:
  • Terendah (default): versi terendah
  • HighestPatch: versi dengan patch utama terendah, minor terendah, tertinggi
  • HighestMinor: versi dengan patch mayor terendah, minor tertinggi, tertinggi
  • Tertinggi (default untuk Update-Package tanpa parameter): versi tertinggi
Anda dapat mengatur nilai default menggunakan dependencyVersion pengaturan dalam Nuget.Config file.
ToHighestPatch setara dengan -Brankas.
ToHighestMinor Membatasi peningkatan ke hanya versi dengan versi Utama yang sama dengan paket yang saat ini diinstal.
WhatIf Menunjukkan apa yang akan terjadi saat menjalankan perintah tanpa benar-benar melakukan pembaruan.

Tidak ada parameter ini yang menerima input alur atau karakter kartubebas.

Parameter Umum

Update-Packagemendukung parameter PowerShell umum berikut: Debug, Tindakan Kesalahan, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction, dan WarningVariable.

Contoh

# Updates all packages in every project of the solution
Update-Package

# Updates every package in the MvcApplication1 project
Update-Package -ProjectName MvcApplication1

# Updates the Elmah package in every project to the latest version
Update-Package Elmah

# Updates the Elmah package to version 1.1.0 in every project showing optional -Id usage
Update-Package -Id Elmah -Version 1.1.0

# Updates the Elmah package within the MvcApplication1 project to the highest "safe" version.
# For example, if Elmah version 1.0.0 of a package is installed, and versions 1.0.1, 1.0.2,
# and 1.1 are available in the feed, the -Safe parameter updates the package to 1.0.2 instead
# of 1.1 as it would otherwise.
Update-Package Elmah -ProjectName MvcApplication1 -Safe

# Reinstall the same version of the original package, but with the latest version of dependencies
# (subject to version constraints). If this command rolls a dependency back to an earlier version,
# use Update-Package <dependency_name> to reinstall that one dependency without affecting the
# dependent package.
Update-Package Elmah –reinstall 

# Reinstall the Elmah package in just MyProject
Update-Package Elmah -ProjectName MyProject -reinstall

# Reinstall the same version of the original package without touching dependencies.
Update-Package Elmah –reinstall -ignoreDependencies