Dela via


Uninstall-Module

Avinstallerar en modul.

Syntax

NameParameterSet (Standard)

Uninstall-Module
    [-Name] <String[]>
    [-MinimumVersion <String>]
    [-RequiredVersion <String>]
    [-MaximumVersion <String>]
    [-AllVersions]
    [-Force]
    [-AllowPrerelease]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObject

Uninstall-Module
    [-InputObject] <PSObject[]>
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Cmdleten Uninstall-Module avinstallerar en angiven modul från den lokala datorn. Du kan inte avinstallera en modul om andra moduler är beroende av den eller om modulen inte har installerats med cmdleten Install-Module .

Du kan ta bort modulfiler manuellt, men det kan bryta alla moduler som är beroende av den borttagna modulen.

Parametrarna som tar modulversionsnummer förväntar sig strängar som formateras som versionsnummer.

  • Standardversionsnummer x.y.z har ett format där x, y och z är tal
  • Förhandsversioner har ett format x.y.z-<prerelease_label> där <prerelease_label> är godtycklig sträng tilldelad till den versionen.

Exempel

Exempel 1: Avinstallera en modul

I det här exemplet avinstalleras en modul.

Uninstall-Module -Name SpeculationControl

Uninstall-Module använder parametern Name för att ange modulen som ska avinstalleras från den lokala datorn.

Exempel 2: Använd pipelinen för att avinstallera en modul

I det här exemplet används pipelinen för att avinstallera en modul.

Get-InstalledModule -Name SpeculationControl | Uninstall-Module

Get-InstalledModule använder parametern Name för att ange modulen. Objektet skickas ned pipelinen till Uninstall-Module och avinstalleras.

Parametrar

-AllowPrerelease

Gör att du kan avinstallera en modul som är markerad som en förhandsversion.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
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

-AllVersions

Anger att du vill inkludera alla tillgängliga versioner av en modul. Du kan inte använda parametern AllVersions med parametrarna MinimumVersion, MaximumVersioneller RequiredVersion.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
Stöder jokertecken:False
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

-Confirm

Uppmanar dig att bekräfta innan du kör Uninstall-Module.

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

-Force

Tvingar Uninstall-Module att köra utan att be om användarbekräftelse.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:None
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

-InputObject

Accepterar ett PSRepositoryItemInfo- objekt. Till exempel Get-InstalledModule utdata till en variabel och använder variabeln som argumentet InputObject.

Parameteregenskaper

Typ:

PSObject[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

InputObject
Position:0
Obligatorisk:True
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-MaximumVersion

Anger den högsta eller senaste versionen av modulen som ska avinstalleras. Parametrarna MaximumVersion och RequiredVersion kan inte användas i samma kommando.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NameParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-MinimumVersion

Anger den lägsta versionen av modulen som ska avinstalleras. Parametrarna MinimumVersion och RequiredVersion kan inte användas i samma kommando.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NameParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

Anger en matris med modulnamn som ska avinstalleras.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NameParameterSet
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-RequiredVersion

Anger det exakta versionsnumret för modulen som ska avinstalleras.

Parameteregenskaper

Typ:String
Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

NameParameterSet
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

Visar vad som skulle hända om Uninstall-Module kördes. 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.

Indata

String

PSObject

String

Utdata

Object