Edit

Share via

Get-AppxPackage

  • Reference
Module:
Appx

Gets a list of the app packages that are installed in a user profile.

Syntax

Get-AppxPackage
   [-AllUsers]
   [-PackageTypeFilter <PackageTypes>]
   [[-Name] <String>]
   [[-Publisher] <String>]
   [-User <String>]
   [-Volume <AppxVolume>]
   [<CommonParameters>]

Description

The Get-AppxPackage cmdlet gets a list of the app packages that are installed in a user profile. An app package has an .msix or .appx file name extension. To get the list of packages for a user profile other than the profile for the current user, you must run this command by using administrator permissions.

Examples

Example 1: Get all app packages for every user account

PS C:\> Get-AppxPackage -AllUsers

This command lists the app packages that are installed for every user account on the computer.

Example 2: Get an app package for a specific a user

PS C:\> Get-AppxPackage -Name "Package17" -User "Contoso\EvanNarvaez"

This command displays information about Package17 if it is installed in the specified user profile.

Parameters

-AllUsers

Indicates that this cmdlet lists app packages for all user accounts on the computer. To use this parameter, you must run the command by using administrator permissions.

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

-Name

Specifies the name of a particular package. If you specify this parameter, the cmdlet returns results for this package only. Wildcards are permitted.

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

-PackageTypeFilter

Specifies one or more comma-separated types of packages that the cmdlet gets from the package repository.

By default, this cmdlet returns only packages of types Main and Framework.

Type:PackageTypes
Accepted values:None, Main, Framework, Resource, Bundle, Xap, Optional
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Publisher

Specifies the publisher of a particular package. If you specify this parameter, the cmdlet returns results only for this publisher. Wildcards are permitted.

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

-User

Specifies a user. If you specify this parameter, the cmdlet returns a list of app packages that are installed for only the user that this cmdlet specifies. To get the list of packages for a user profile other than the profile for the current user, you must run this command by using administrator permissions. The user name can be in one of these formats:

  • domain\user_name
  • user_name@fqn.domain.tld
  • user_name
  • SID-string
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Volume

Specifies an AppxVolume object. If you specify this parameter, this cmdlet returns only packages that are relative to volume that this parameter specifies.

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

Inputs

String[]

Outputs

Microsoft.Windows.Appx.PackageManager.Commands.AppxPackage

This cmdlet returns an AppxPackage object that contains information, including the full name of the app package.