Uninstall-PSResource

  • Reference
Modul:
Microsoft.PowerShell.PSResourceGet

Odinstaluje prostředek nainstalovaný pomocí rutiny PowerShellGet.

Syntax

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

Description

Tato rutina kombinuje funkce Uninstall-Module rutin a Uninstall-Script z PowerShellGet v2. Rutina vyhledá instalační cesty balíčku pro prostředky, které mají soubor metadat XML PowerShellGet . Odpovídající prostředky se odinstalují ze systému.

Ve výchozím nastavení rutina zkontroluje, jestli je odebraný prostředek závislostí pro jiný prostředek.

Příklady

Příklad 1

Odinstalujte nejnovější verzi modulu Az .

Uninstall-PSResource Az

Příklad 2

Odinstalujte konkrétní verzi modulu Az .

Uninstall-PSResource -name Az -version "5.0.0"

Příklad 3

Odinstaluje všechny verze modulu Az v zadaném rozsahu verzí.

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

Příklad 4

V tomto příkladu se předpokládá, že následující verze modulu Az jsou již nainstalovány:

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

Rutina Uninstall-PSResource odebere stabilní a předběžnou verzi, která spadá do zadaného rozsahu verzí. Podle pravidel NuGetVersion je předběžná verze menší než stabilní verze, takže verze 4.0.1-Preview je ve skutečnosti menší než verze 4.0.1 v zadaném rozsahu. Proto se verze 4.0.1 preview neodebere. Verze 4.1.0 a 4.0.2-preview se odeberou, protože spadají do rozsahu.

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

Příklad 5

V tomto příkladu se předpokládá, že následující verze modulu Az jsou již nainstalovány:

  • 4.0.1-preview
  • 4.1.0
  • 4.0.2-preview

To je stejné jako v předchozím příkladu s tím rozdílem, že parametr Prerelease znamená, že se odeberou jenom předběžné verze. Odebere se jenom verze 4.0.2-preview, protože verze 4.0.1-preview je mimo rozsah a verze 4.1.0 není předběžná verze.

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

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-InputObject

Používá se pro vstup kanálu.

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

-Name

Název prostředku nebo prostředků, které chcete odebrat. Zástupné znaky jsou podporované, ale NuGet přijímá * pouze znak.

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

-Prerelease

Označuje, že by měly být odebrány pouze prostředky předběžné verze.

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

-Scope

Určuje rozsah prostředku, který se má odinstalovat.

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

Ve výchozím nastavení rutina zkontroluje, jestli je odebraný prostředek závislostí pro jiný prostředek. Použití tohoto parametru přeskočí test závislostí.

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

-Version

Určuje verzi prostředku, který se má odebrat. Hodnota může být přesná verze nebo rozsah verzí pomocí syntaxe správy verzí NuGet.

Další informace o rozsahech verzí NuGet najdete v tématu Správa verzí balíčků.

PowerShellGet podporuje všechny kromě minimální inkluzivní verze uvedené v dokumentaci k rozsahu verzí NuGet. Použití 1.0.0.0 jako verze nedává verze 1.0.0.0 a vyšší (minimální rozsah včetně). Místo toho se hodnota považuje za požadovanou verzi. Pokud chcete vyhledat minimální inkluzivní rozsah, použijte [1.0.0.0, ] jako rozsah verzí.

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina se nespustí.

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

Vstupy

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Výstupy

Object