Edit

Uninstall-Script

  • Reference
Module:
PowerShellGet

Uninstalls a script.

Syntax 

Uninstall-Script
         [-Name] <String[]>
         [-MinimumVersion <String>]
         [-RequiredVersion <String>]
         [-MaximumVersion <String>]
         [-Force]
         [-AllowPrerelease]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]
Uninstall-Script
         [-InputObject] <PSObject[]>
         [-Force]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

The Uninstall-Script cmdlet uninstalls a specified script from the local computer.

Examples

Example 1: Uninstall a script

This example uninstalls a script. 

Uninstall-Script -Name UpdateManagement-Template

Uninstall-Script uses the Name parameter to specify the script to uninstall from the local computer.

Example 2: Use the pipeline to uninstall a script

In this example, the pipeline is used to uninstall a script. 

Get-InstalledScript -Name UpdateManagement-Template | Uninstall-Script

Get-InstalledScript uses the Name parameter to specify the script. The object is sent down the pipeline to Uninstall-Script and the script is uninstalled.

Parameters

-AllowPrerelease

Allows you to uninstall a script marked as a prerelease.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Confirm

Prompts you for confirmation before running Uninstall-Script .

Type: SwitchParameter
Aliases: cf
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

-Force

Forces Uninstall-Script to run without asking for user confirmation.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-InputObject

Accepts a PSRepositoryItemInfo object. For example, output Get-InstalledScript to a variable and use that variable as the InputObject argument.

Type: PSObject [ ]
Position: 0
Default value: None
Accept pipeline input: True
Accept wildcard characters: False

-MaximumVersion

Specifies the maximum, or newest, version of the script to uninstall. The MaximumVersion and RequiredVersion parameters can't be used in the same command.

Type: String
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False

-MinimumVersion

Specifies the minimum version of the script to uninstall. The MinimumVersion and RequiredVersion parameters can't be used in the same command.

Type: String
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False

-Name

Specifies an array of script names to uninstall.

Type: String [ ]
Position: 0
Default value: None
Accept pipeline input: True
Accept wildcard characters: False

-RequiredVersion

Specifies the exact version number of the script to uninstall.

Type: String
Position: Named
Default value: None
Accept pipeline input: True
Accept wildcard characters: False

-WhatIf

Shows what would happen if Uninstall-Script runs. The cmdlet isn't run.

Type: SwitchParameter
Aliases: wi
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Inputs

String [ ]

PSObject [ ]

String

Outputs

Object