Remove-AppxPackage
Removes an app package from one or more user accounts.
Syntax
RemoveByPackageSet (Default)
Remove-AppxPackage
[-Package] <String>
[-PreserveApplicationData]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
RemoveByPackageForRoamingSet
Remove-AppxPackage
[-Package] <String>
[-PreserveRoamableApplicationData]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
AllUsersSet
Remove-AppxPackage
[-Package] <String>
[-AllUsers]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
UserSet
Remove-AppxPackage
[-Package] <String>
-User <String>
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
The Remove-AppxPackage
cmdlet removes an app package from a user account. An app package has an
.msix
or .appx
file extension.
Examples
Example 1: Remove an app package
Remove-AppxPackage -Package 'package1_1.0.0.0_neutral__8wekyb3d8bbwe'
This command removes an app package named package1_1.0.0.0_neutral__8wekyb3d8bbwe
from the
account of the current user.
Parameters
-AllUsers
This parameter removes the app package for all user accounts on the computer. The parameter works
off the parent package type. If it's a bundle, use PackageTypeFilter with the Get-AppxPackage
command and specify the bundle. To use this parameter, you must run the command with administrator
permissions.
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
AllUsersSet
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 cmdlet.
Parameter properties
Type: | SwitchParameter |
Default value: | False |
Supports wildcards: | False |
DontShow: | False |
Aliases: | cf |
Parameter sets
(All)
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-Package
Specifies an AppxPackage object or the full name of a package.
Parameter properties
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
(All)
Position: | 0 |
Mandatory: | True |
Value from pipeline: | True |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-PreserveApplicationData
Specifies that the cmdlet preserves the application data during the package removal. The application data is available for later use. Note that this is only applicable for apps that are under development so this option can only be specified for apps that are registered from file layout (Loose file registered).
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
RemoveByPackageSet
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-PreserveRoamableApplicationData
Preserves the roamable portion of the app's data when the package is removed. This parameter is incompatible with PreserveApplicationData.
Parameter properties
Type: | SwitchParameter |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
RemoveByPackageForRoamingSet
Position: | Named |
Mandatory: | False |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-User
If you specify this parameter, the cmdlet removes the app package for only the user that this cmdlet specifies. To remove a package for a user profile other than the profile of the current user, you must run this command with administrator permissions.
Note
This parameter only accepts user SIDs. Use the whoami /user command to display the current SID of a user. See whoami syntax for details.
Parameter properties
Type: | String |
Default value: | None |
Supports wildcards: | False |
DontShow: | False |
Parameter sets
UserSet
Position: | Named |
Mandatory: | True |
Value from pipeline: | False |
Value from pipeline by property name: | False |
Value from remaining arguments: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet isn't run.
Parameter properties
Type: | SwitchParameter |
Default value: | False |
Supports wildcards: | False |
DontShow: | False |
Aliases: | 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.
Inputs
String
Microsoft.Windows.Appx.PackageManager.Commands.AppxPackage
An AppxPackage object that contain information, including the full name of the app package.