Udostępnij za pośrednictwem

Uninstall-PSResource

  • Odwołanie
Moduł:
Microsoft.PowerShell.PSResourceGet

Odinstalowuje zasób, który został zainstalowany przy użyciu modułu PowerShellGet.

Składnia

Uninstall-PSResource
         [-Name] <String[]>
         [-Version <String>]
         [-Prerelease]
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-PSResource
         [-Prerelease]
         [-InputObject] <PSResourceInfo[]>
         [-SkipDependencyCheck]
         [-Scope <ScopeType>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Opis

To polecenie cmdlet łączy funkcje poleceń cmdlet i Uninstall-Script z modułu Uninstall-ModulePowerShellGet w wersji 2. Polecenie cmdlet przeszukuje ścieżki instalacji pakietu dla zasobów, które mają plik metadanych XML PowerShellGet . Pasujące zasoby są odinstalowywane z systemu.

Domyślnie polecenie cmdlet sprawdza, czy usuwany zasób jest zależnością dla innego zasobu.

Przykłady

Przykład 1

Odinstaluj najnowszą wersję modułu Az .

Uninstall-PSResource Az

Przykład 2

Odinstaluj określoną wersję modułu Az .

Uninstall-PSResource -name Az -version "5.0.0"

Przykład 3

Odinstalowuje wszystkie wersje modułu Az w określonym zakresie wersji.

Uninstall-PSResource -name Az -version "(5.0.0, 7.5.0)"

Przykład 4

W tym przykładzie przyjęto założenie, że następujące wersje modułu Az są już zainstalowane:

  • 4.0.1 —wersja zapoznawcza
  • 4.1.0
  • 4.0.2 —wersja zapoznawcza

Polecenie Uninstall-PSResource cmdlet usuwa stabilną i wstępną wersję, która mieści się w określonym zakresie wersji. Zgodnie z regułami NuGetVersion wersja wstępna jest mniejsza niż stabilna, więc wersja 4.0.1-preview jest faktycznie mniejsza niż wersja 4.0.1 w określonym zakresie. W związku z tym wersja 4.0.1-preview nie jest usuwana. Wersje 4.1.0 i 4.0.2-preview są usuwane, ponieważ należą do zakresu.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]"

Przykład 5

W tym przykładzie przyjęto założenie, że następujące wersje modułu Az są już zainstalowane:

  • 4.0.1 —wersja zapoznawcza
  • 4.1.0
  • 4.0.2 —wersja zapoznawcza

Jest to takie samo jak w poprzednim przykładzie z wyjątkiem parametru Wersja wstępna oznacza, że tylko wersje wstępne są usuwane. Usunięto tylko wersję 4.0.2-preview, ponieważ wersja 4.0.1-preview wykracza poza zakres i wersja 4.1.0 nie jest wersją wstępną.

Uninstall-PSResource -name Az -version "[4.0.1, 4.1.0]" -Prerelease

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InputObject

Służy do wprowadzania potoku.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Nazwa zasobu lub zasobów do usunięcia. Symbole wieloznaczne są obsługiwane, ale program NuGet akceptuje * tylko znak .

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Prerelease

Wskazuje, że należy usunąć tylko zasoby wersji wstępnej.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Scope

Określa zakres zasobu do odinstalowania.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Dopuszczalne wartości:CurrentUser, AllUsers
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-SkipDependencyCheck

Domyślnie polecenie cmdlet sprawdza, czy usuwany zasób jest zależnością dla innego zasobu. Użycie tego parametru pomija test zależności.

Typ:SwitchParameter
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Version

Określa wersję zasobu do usunięcia. Wartość może być dokładną wersją lub zakresem wersji przy użyciu składni przechowywania wersji NuGet.

Aby uzyskać więcej informacji na temat zakresów wersji nuGet, zobacz Przechowywanie wersji pakietów.

Moduł PowerShellGet obsługuje wszystkie wersje, ale minimalną inkluzywną wymienioną w dokumentacji zakresu wersji NuGet. Użycie 1.0.0.0 jako wersji nie daje wersji 1.0.0.0 i nowszych (minimalny zakres włącznie). Zamiast tego wartość jest uznawana za wymaganą wersję. Aby wyszukać minimalny zakres inkluzywny, użyj jako [1.0.0.0, ] zakresu wersji.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:True

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie jest uruchamiane.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Dane wyjściowe

Object