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.

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

-InputObject

Służy do wprowadzania potoku.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Prerelease

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

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

-Scope

Określa zakres zasobu do odinstalowania.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu 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

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Dane wyjściowe

Object