Uninstall-Module

Uninstalls a module.
Uninstall-Module [-Name*] <String[]> [-AllVersions] [-Force] [-MaximumVersion [<Version>]] [-MinimumVersion[<Version>]] [-RequiredVersion [<Version>]] [-Confirm] [-WhatIf] [<CommonParameters>]
Uninstall-Module [-Force] [-Confirm] [-WhatIf] [<CommonParameters>]

The Uninstall-Module cmdlet uninstalls the specified module from the local computer. You cannot uninstall a module if it has other modules as dependencies.

Parameters
-AllVersions [<SwitchParameter>]

Specifies that you want to include all available versions of a module. You cannot use the AllVersions parameter with the MinimumVersion, MaximumVersion, or RequiredVersion parameters.

-Force [<SwitchParameter>]

Forces the command to run without asking for user confirmation.

-MaximumVersion [<Version>]

Specifies the maximum, or newest, version of the module to uninstall. The MaximumVersion and RequiredVersion parameters are mutually exclusive; you cannot use both parameters in the same command.

-MinimumVersion [<Version>]

Specifies the minimum version of the script to uninstall. The MinimumVersion and RequiredVersion parameters are mutually exclusive; you cannot use both parameters in the same command.

-Name <String[]>

Specifies an array of names of modules to uninstall.

-RequiredVersion [<Version>]

Specifies the exact version number of the module to uninstall.

-Confirm [<SwitchParameter>]

  • Default value is false

Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.

-WhatIf [<SwitchParameter>]

  • Default value is false

Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs. The cmdlet is not run.

<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,ErrorAction, ErrorVariable, WarningAction, WarningVariable,OutBuffer, PipelineVariable, and OutVariable.

Examples
  1. Get a module and uninstall it:
    PS C:> Get-InstalledModule -Name "xPSDesiredStateConfiguration" -RequiredVersion 3.6.0.0 | Uninstall-Module
    

    This command gets version 3.6.0.0 of the module named xPSDesiredStateConfiguration, and then uses the pipeline operator to pass it to the Uninstall-Module cmdlet, which uninstalls it.

Related Links

Find-Module
Get-InstalledModule
Publish-Module
Save-Module
Update-Module