Udostępnij za pośrednictwem

Uninstall-Package

  • Odwołanie
Moduł:
PackageManagement

Odinstalowuje co najmniej jeden pakiet oprogramowania.

Składnia

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

Opis

Polecenie Uninstall-Package cmdlet odinstalowuje co najmniej jeden pakiet oprogramowania z komputera lokalnego. Aby znaleźć zainstalowane pakiety, użyj Get-Package polecenia cmdlet .

Ważne

Polecenia zawarte w module PackageManagement różnią się od poleceń dostarczonych przez moduł NuGet w konsoli menedżera pakietów programu Visual Studio. Każdy moduł ma 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 dotyczącą konsoli menedżera pakietów programu Visual Studio.

Przykłady

Przykład 1: Odinstalowywanie pakietu

Polecenie Uninstall-Package cmdlet odinstalowuje pakiety. Parametr Name określa pakiet do odinstalowania. Jeśli zainstalowano wiele wersji pakietu, najnowsza wersja zostanie odinstalowana.

PS> Uninstall-Package -Name NuGet.Core

Przykład 2: odinstalowanie pakietu przy użyciu potoku

Get-Package lokalizuje określony pakiet i wysyła obiekt SoftwareIdentity w dół potoku Uninstall-Package do polecenia cmdlet.

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

Polecenie Get-Package cmdlet używa parametrów Name i RequiredVersion do określenia pakietu. Obiekt SoftwareIdentity jest wysyłany w dół potoku. Polecenie Uninstall-Package cmdlet odbiera obiekt jako obiekt InputObject i usuwa pakiet.

Alternatywnie Uninstall-Package polecenie cmdlet może określić wartość parametru InputObject :

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

Parametry

-AllowClobber

Zastępuje komunikaty ostrzegawcze dotyczące konfliktów z istniejącymi poleceniami. Zastępuje istniejące polecenia, które mają taką samą nazwę jak instalowane polecenia.

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

-AllowPrereleaseVersions

Umożliwia odinstalowanie 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

Wskazuje, że to polecenie cmdlet odinstalowuje wszystkie wersje pakietu.

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

-Destination

Określa ciąg ścieżki do obiektu wejściowego.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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

-ForceBootstrap

Wymusza pakiet PackageManagement , 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

-InputObject

Akceptuje dane wejściowe potoku określające obiekt SoftwareIdentity pakietu z Get-Package polecenia cmdlet . Obiekt InputObject akceptuje obiekt SoftwareIdentity jako Get-Package wartość lub zmienną zawierającą obiekt .

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

-InstallUpdate

Wskazuje, że Uninstall-Package odinstalowuje 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 odinstalować. Jeśli nie określisz tego parametru, Uninstall-Package odinstaluje 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 odinstalować. Jeśli nie dodasz tego parametru, Uninstall-Package odinstaluje najnowszą wersję pakietu, która spełnia wszystkie wersje określone 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

Program NoPathUpdate ma zastosowanie tylko do Install-Script polecenia cmdlet . NoPathUpdate jest parametrem dynamicznym dodanym przez dostawcę i nie jest obsługiwany przez Uninstall-Packageprogram .

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

-PackageManagementProvider

Określa dostawcę 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 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

-RequiredVersion

Określa dokładną dozwoloną wersję pakietu, który chcesz odinstalować. Jeśli nie dodasz tego parametru, Uninstall-Package odinstaluje najnowszą wersję pakietu, która spełnia wszystkie wersje określone przez parametr MaximumVersion .

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

-Scope

Określa zakres, dla którego należy odinstalować 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

-SkipDependencies

Pomija odinstalowywanie 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

-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 Uninstall-Package uruchomienia polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

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ć obiekty SoftwareIdentity .

Dane wyjściowe

Microsoft.PackageManagement.Packaging.SoftwareIdentity

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

Uwagi

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