Uninstall-Module
Uninstalls a module.
Sintassi
NameParameterSet (impostazione predefinita).
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>]
Descrizione
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.
You can manually delete module files, but doing so may break any modules that depend on the deleted module.
The parameters that take module version numbers expect strings formatted as version numbers.
- Standard version numbers have a format of
x.y.z
where x, y, and z are numbers - Prerelease versions have a format of
x.y.z-<prerelease_label>
where the<prerelease_label>
is arbitrary string assigned to that release.
Esempio
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.
Parametri
-AllowPrerelease
Allows you to uninstall a module marked as a prerelease.
Proprietà dei parametri
Tipo: | SwitchParameter |
Valore predefinito: | None |
Supporta i caratteri jolly: | False |
DontShow: | False |
Set di parametri
NameParameterSet
Posizione: | Named |
Obbligatorio: | False |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | False |
Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
Tipo: | SwitchParameter |
Valore predefinito: | None |
Supporta i caratteri jolly: | False |
DontShow: | False |
Set di parametri
NameParameterSet
Posizione: | Named |
Obbligatorio: | False |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | False |
Valore dagli argomenti rimanenti: | False |
-Confirm
Prompts you for confirmation before running the Uninstall-Module
.
Proprietà dei parametri
Tipo: | SwitchParameter |
Valore predefinito: | False |
Supporta i caratteri jolly: | False |
DontShow: | False |
Alias: | cf |
Set di parametri
(All)
Posizione: | Named |
Obbligatorio: | False |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | False |
Valore dagli argomenti rimanenti: | False |
-Force
Forces Uninstall-Module
to run without asking for user confirmation.
Proprietà dei parametri
Tipo: | SwitchParameter |
Valore predefinito: | None |
Supporta i caratteri jolly: | False |
DontShow: | False |
Set di parametri
(All)
Posizione: | Named |
Obbligatorio: | False |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | False |
Valore dagli argomenti rimanenti: | False |
-InputObject
Accepts a PSRepositoryItemInfo object. For example, output Get-InstalledModule
to a variable
and use that variable as the InputObject argument.
Proprietà dei parametri
Tipo: | PSObject[] |
Valore predefinito: | None |
Supporta i caratteri jolly: | False |
DontShow: | False |
Set di parametri
InputObject
Posizione: | 0 |
Obbligatorio: | True |
Valore dalla pipeline: | True |
Valore dalla pipeline in base al nome della proprietà: | True |
Valore dagli argomenti rimanenti: | False |
-MaximumVersion
Specifies the maximum, or newest, version of the module to uninstall. The MaximumVersion and RequiredVersion parameters can't be used in the same command.
Proprietà dei parametri
Tipo: | String |
Valore predefinito: | None |
Supporta i caratteri jolly: | False |
DontShow: | False |
Set di parametri
NameParameterSet
Posizione: | Named |
Obbligatorio: | False |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | True |
Valore dagli argomenti rimanenti: | False |
-MinimumVersion
Specifies the minimum version of the module to uninstall. The MinimumVersion and RequiredVersion parameters can't be used in the same command.
Proprietà dei parametri
Tipo: | String |
Valore predefinito: | None |
Supporta i caratteri jolly: | False |
DontShow: | False |
Set di parametri
NameParameterSet
Posizione: | Named |
Obbligatorio: | False |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | True |
Valore dagli argomenti rimanenti: | False |
-Name
Specifies an array of module names to uninstall.
Proprietà dei parametri
Tipo: | String[] |
Valore predefinito: | None |
Supporta i caratteri jolly: | False |
DontShow: | False |
Set di parametri
NameParameterSet
Posizione: | 0 |
Obbligatorio: | True |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | True |
Valore dagli argomenti rimanenti: | False |
-RequiredVersion
Specifies the exact version number of the module to uninstall.
Proprietà dei parametri
Tipo: | String |
Valore predefinito: | None |
Supporta i caratteri jolly: | False |
DontShow: | False |
Set di parametri
NameParameterSet
Posizione: | Named |
Obbligatorio: | False |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | True |
Valore dagli argomenti rimanenti: | False |
-WhatIf
Shows what would happen if Uninstall-Module
runs. The cmdlet isn't run.
Proprietà dei parametri
Tipo: | SwitchParameter |
Valore predefinito: | False |
Supporta i caratteri jolly: | False |
DontShow: | False |
Alias: | wi |
Set di parametri
(All)
Posizione: | Named |
Obbligatorio: | False |
Valore dalla pipeline: | False |
Valore dalla pipeline in base al nome della proprietà: | False |
Valore dagli argomenti rimanenti: | 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.