Uninstall-Module
Uninstalls a module.
Syntaxe
NameParameterSet (Default)
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
The Uninstall-Module cmdlet uninstalls a specified module from the local computer. You can't
uninstall a module if other modules depend on it or the module wasn't installed with the
Install-Module cmdlet.
This is a proxy cmdlet for the Uninstall-PSResource cmdlet in the
Microsoft.PowerShell.PSResourceGet. For more information, see
Uninstall-PSResource.
Exemples
Example 1: Uninstall a module
This example uninstalls a module.
Uninstall-Module -Name SpeculationControl
Uninstall-Module uses the Name parameter to specify the module to uninstall from the local
computer.
Example 2: Use the pipeline to uninstall a module
In this example, the pipeline is used to uninstall a module.
Get-InstalledModule -Name SpeculationControl | Uninstall-Module
Get-InstalledModule uses the Name parameter to specify the module. The object is sent down the
pipeline to Uninstall-Module and is uninstalled.
Paramètres
-AllowPrerelease
Allows you to uninstall a module marked as a prerelease.
The proxy cmdlet maps this parameter to the Prerelease parameter of Uninstall-PSResource
Parameter properties
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
NameParameterSet
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-AllVersions
Specifies that you want to include all available versions of a module. You can't use the AllVersions parameter with the MinimumVersion, MaximumVersion, or RequiredVersion parameters.
The proxy cmdlet transforms this parameter to -Version * before calling Uninstall-PSResource.
Parameter properties
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
NameParameterSet
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Confirm
Prompts you for confirmation before running the Uninstall-Module.
Parameter properties
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Alias: | cf |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Force
The proxy cmdlet ignores this parameter since it's not supported by Uninstall-PSResource.
Parameter properties
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-InputObject
Accepts a PSRepositoryItemInfo object. For example, output Get-InstalledModule to a variable
and use that variable as the InputObject argument.
Parameter properties
| Type: | PSObject[] |
| Valeur par défaut: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
InputObject
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-MaximumVersion
The proxy cmdlet uses the value of this parameter to create a NuGet version search string for use
with the Version parameter of Uninstall-PSResource.
Parameter properties
| Type: | String |
| Valeur par défaut: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
NameParameterSet
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-MinimumVersion
The proxy cmdlet uses the value of this parameter to create a NuGet version search string for use
with the Version parameter of Uninstall-PSResource.
Parameter properties
| Type: | String |
| Valeur par défaut: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
NameParameterSet
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Name
Specifies an array of module names to uninstall.
Parameter properties
| Type: | String[] |
| Valeur par défaut: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
NameParameterSet
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-RequiredVersion
The proxy cmdlet uses the value of this parameter to create a NuGet version search string for use
with the Version parameter of Uninstall-PSResource.
Parameter properties
| Type: | String |
| Valeur par défaut: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
NameParameterSet
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-WhatIf
Shows what would happen if Uninstall-Module runs. The cmdlet isn't run.
Parameter properties
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Supports wildcards: | False |
| DontShow: | False |
| Alias: | wi |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
