Uninstall-Package

Menghapus instalan satu atau beberapa paket perangkat lunak.

Sintaks

Uninstall-Package
         [-InputObject] <SoftwareIdentity[]>
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-Package
         [-Name] <String[]>
         [-RequiredVersion <String>]
         [-MinimumVersion <String>]
         [-MaximumVersion <String>]
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-ProviderName <String[]>]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Destination <String>]
         [-ExcludeVersion]
         [-Scope <String>]
         [-SkipDependencies]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Destination <String>]
         [-ExcludeVersion]
         [-Scope <String>]
         [-SkipDependencies]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Scope <String>]
         [-PackageManagementProvider <String>]
         [-Type <String>]
         [-AllowClobber]
         [-SkipPublisherCheck]
         [-InstallUpdate]
         [-NoPathUpdate]
         [-AllowPrereleaseVersions]
         [<CommonParameters>]
Uninstall-Package
         [-AllVersions]
         [-Force]
         [-ForceBootstrap]
         [-WhatIf]
         [-Confirm]
         [-Scope <String>]
         [-PackageManagementProvider <String>]
         [-Type <String>]
         [-AllowClobber]
         [-SkipPublisherCheck]
         [-InstallUpdate]
         [-NoPathUpdate]
         [-AllowPrereleaseVersions]
         [<CommonParameters>]

Deskripsi

Uninstall-Package Cmdlet menghapus instalasi satu atau beberapa paket perangkat lunak dari komputer lokal. Untuk menemukan paket yang diinstal, gunakan Get-Package cmdlet .

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: Menghapus instalan paket

Uninstall-Package Cmdlet menghapus instalan paket. Parameter Nama menentukan paket yang akan dibongkar. Jika beberapa versi paket diinstal, versi terbaru akan dihapus instalannya.

PS> Uninstall-Package -Name NuGet.Core

Contoh 2: Gunakan alur untuk menghapus instalan paket

Get-Package menemukan paket tertentu dan mengirim objek SoftwareIdentity ke bawah alur ke Uninstall-Package cmdlet.

PS> Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 | Uninstall-Package

Get-Package Cmdlet menggunakan parameter Nama dan RequiredVersion untuk menentukan paket. Objek SoftwareIdentity dikirimkan ke alur. Uninstall-Package Cmdlet menerima objek sebagai InputObject dan menghapus paket.

Sebagai alternatif, Uninstall-Package cmdlet dapat menentukan nilai untuk parameter InputObject :

Uninstall-Package -InputObject ( Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 )

Parameter

-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 paket yang ditandai sebagai prarilis dihapus instalannya.

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

-AllVersions

Menunjukkan bahwa cmdlet ini menghapus semua versi paket.

Type:SwitchParameter
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

-Destination

Menentukan string jalur ke objek input.

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

-Force

Memaksa perintah untuk berjalan tanpa meminta konfirmasi pengguna.

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

-InputObject

Menerima input alur yang menentukan objek SoftwareIdentity paket dari Get-Package cmdlet . InputObject menerima objek SoftwareIdentity sebagai Get-Package nilai atau variabel yang berisi objek .

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

-InstallUpdate

Menunjukkan bahwa Uninstall-Package menghapus instalasi 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 hapus instalannya. Jika Anda tidak menentukan parameter ini, Uninstall-Package hapus instalan 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 hapus instalasinya. Jika Anda tidak menambahkan parameter ini, Uninstall-Package hapus instalan 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 Uninstall-Package.

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

-PackageManagementProvider

Menentukan 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 mencari paket. 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

-RequiredVersion

Menentukan versi paket yang diperbolehkan yang tepat yang ingin Anda hapus instalasinya. Jika Anda tidak menambahkan parameter ini, Uninstall-Package hapus instalan 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

-Scope

Menentukan cakupan untuk menghapus instalan 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

-SkipDependencies

Melewati penghapusan instalan 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

-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 Uninstall-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 dihapus instalasinya.

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, Uninstall-Package memiliki set parameter PowerShellGet yang mencakup -NoPathUpdate, , AllowClobberdan SkipPublisherCheck.