Dela via

Uninstall-PSResource

  • Referens
Modul:
Microsoft.PowerShell.PSResourceGet

Avinstallerar en resurs som har installerats med 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

Den här cmdleten kombinerar funktionerna i Uninstall-Module cmdletarna och Uninstall-Script från PowerShellGet v2. Cmdleten söker i paketinstallationssökvägarna efter resurser som har PowerShellGet XML-metadatafilen. Matchande resurser avinstalleras från systemet.

Som standard kontrollerar cmdleten om resursen som tas bort är ett beroende för en annan resurs.

Exempel

Exempel 1

Avinstallera den senaste versionen av Az-modulen .

Uninstall-PSResource Az

Exempel 2

Avinstallera en specifik version av Az-modulen .

Uninstall-PSResource -name Az -version "5.0.0"

Exempel 3

Avinstallerar alla versioner av Az-modulen inom det angivna versionsintervallet.

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

Exempel 4

Det här exemplet förutsätter att följande versioner av Az-modulen redan är installerade:

  • 4.0.1-förhandsversion
  • 4.1.0
  • 4.0.2-förhandsversion

Cmdleten Uninstall-PSResource tar bort en stabil version och förhandsversion som ligger inom det angivna versionsintervallet. Enligt NuGetVersion-regler är en förhandsversion mindre än en stabil version, så 4.0.1-preview är faktiskt mindre än 4.0.1-versionen i det angivna intervallet. Därför tas inte 4.0.1-förhandsversionen bort. Versionerna 4.1.0 och 4.0.2-preview tas bort eftersom de ligger inom intervallet.

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

Exempel 5

Det här exemplet förutsätter att följande versioner av Az-modulen redan är installerade:

  • 4.0.1-förhandsversion
  • 4.1.0
  • 4.0.2-förhandsversion

Detta är samma som i föregående exempel, förutom att parametern Prerelease innebär att endast förhandsversioner tas bort. Endast version 4.0.2-preview tas bort eftersom version 4.0.1-preview ligger utanför intervallet och version 4.1.0 inte är en förhandsversion.

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

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Används för pipelineindata.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Namnet på en resurs eller de resurser som ska tas bort. Jokertecken stöds men NuGet accepterar * bara tecknet.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:True

-Prerelease

Anger att endast förhandsversionsresurser ska tas bort.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Scope

Anger omfånget för resursen som ska avinstalleras.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Godkända värden:CurrentUser, AllUsers
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-SkipDependencyCheck

Som standard kontrollerar cmdleten om resursen som tas bort är ett beroende för en annan resurs. Med den här parametern hoppar över beroendetestet.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Version

Anger vilken version av resursen som ska tas bort. Värdet kan vara en exakt version eller ett versionsintervall med hjälp av syntaxen för NuGet-versionshantering.

Mer information om NuGet-versionsintervall finns i Paketversionshantering.

PowerShellGet stöder alla utom den lägsta inkluderande versionen som anges i dokumentationen för NuGet-versionsintervallet. Användning 1.0.0.0 som version ger inte versionerna 1.0.0.0 och senare (minsta inkluderande intervall). I stället anses värdet vara den version som krävs. Om du vill söka efter ett minsta inklusivintervall använder [1.0.0.0, ] du som versionsintervall.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:True

-WhatIf

Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

String[]

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Utdata

Object