Uninstall-PSResource
Avinstallerar en resurs som installerades med hjälp av PowerShellGet-.
Syntax
NameParameterSet (Standard)
Uninstall-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObjectParameterSet
Uninstall-PSResource
[-InputObject] <PSResourceInfo[]>
[-Prerelease]
[-SkipDependencyCheck]
[-Scope <ScopeType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Den här cmdleten kombinerar funktionerna i cmdletarna Uninstall-Module och Uninstall-Script från PowerShellGet v2. Cmdleten söker i paketinstallationssökvägarna efter resurser som har PowerShellGet- XML-metadatafil. 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 modulen Az.
Uninstall-PSResource Az
Exempel 2
Avinstallera en specifik version av modulen Az.
Uninstall-PSResource -name Az -version "5.0.0"
Exempel 3
Avinstallerar alla versioner av modulen Az 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 modulen Az redan är installerade:
- 4.0.1-preview
- 4.1.0
- 4.0.2-förhandsversion
Cmdleten Uninstall-PSResource tar bort en stabil 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-preview 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 modulen Az redan är installerade:
- 4.0.1-preview
- 4.1.0
- 4.0.2-förhandsversion
Detta är samma som i föregående exempel förutom 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | jfr |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-InputObject
Används för pipelineindata.
Parameteregenskaper
| Typ: | Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
InputObjectParameterSet
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Name
Namn på en resurs eller resurser att ta bort. Jokertecken stöds men NuGet accepterar bara *-tecknet.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Prerelease
Anger att endast förhandsversionsresurser ska tas bort.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Scope
Anger omfånget för resursen som ska avinstalleras.
Parameteregenskaper
| Typ: | Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType |
| Standardvärde: | None |
| Godkända värden: | CurrentUser, AllUsers |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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 du över beroendetestet.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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 NuGet-versionssyntaxen.
Mer information om NuGet-versionsintervall finns i Paketversioner.
PowerShellGet stöder alla utom den lägsta inkluderande versionen som anges i dokumentationen för NuGet-versionsintervallet. Att använda 1.0.0.0 som version ger inte version 1.0.0.0 och högre (minsta inkluderande intervall). I stället anses värdet vara den version som krävs. Om du vill söka efter ett minsta inkluderande intervall använder du [1.0.0.0, ] som versionsintervall.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
NameParameterSet
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-WhatIf
Visar vad som skulle hända om kommandot körs. Cmdleten körs inte.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | False |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | Wi |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
