Editar

Partilhar via


Remove-AppxPackage

Removes an app package from one or more user accounts.

Syntax

Remove-AppxPackage
      [-Package] <String>
      [-PreserveApplicationData]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AppxPackage
      [-Package] <String>
      [-PreserveRoamableApplicationData]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AppxPackage
      [-Package] <String>
      [-AllUsers]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
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.

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

-Package

Specifies an AppxPackage object or the full name of a package.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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).

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

-PreserveRoamableApplicationData

Preserves the roamable portion of the app's data when the package is removed. This parameter is incompatible with PreserveApplicationData.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet isn't run.

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

Inputs

String[]

Microsoft.Windows.Appx.PackageManager.Commands.AppxPackage

An AppxPackage object that contain information, including the full name of the app package.

Outputs

None