Get-Appx Package

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 .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.

Optional 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
Accept pipeline input: True (ByPropertyName, ByValue)
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
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-PackageTypeFilter

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

  • Bundle
  • Framework
  • Main
  • Resource
  • None

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

Type: PackageTypes
Parameter Sets: None, Main, Framework, Resource, Bundle, Xap
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
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
Accept pipeline input: True (ByValue)
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
Accept pipeline input: True (ByValue)
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
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

Inputs

System.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.