Get-AppxPackage
Gets a list of the app packages that are installed in a user profile.
Syntax
Default (Default)
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 extension. To get the list of packages for a user
profile other than the profile for the current user, you must run this command with administrator
permissions.
Examples
Example 1: Get all app packages for every user account
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
Get-AppxPackage -Name "Package17" -User "Contoso\EvanNarvaez"
This command displays information about Package17 if it's installed in the specified user
profile.
Example 3: Get a particular app package information
Get-AppxPackage -Name Microsoft.ScreenSketch
This command displays information about the ScreenSketch app.
Example 4: Get all app packages for a particular Publisher
Get-AppxPackage -Publisher "CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US"
This command lists all the Microsoft app packages that are installed on the computer.
Example 5: Get all app packages with PackageTypeFilter
Get-AppxPackage -PackageTypeFilter Bundle,Framework,Main,Resource
This command lists all the app packages with PackageTypeFilter installed on the computer.
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 with administrator permissions.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | PackageTypes |
| Default value: | None |
| Accepted values: | None, Main, Framework, Resource, Bundle, Xap, Optional |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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 with administrator permissions. The user name can be in one of these formats:
___domain\user_nameuser_name@fqn.___domain.tlduser_nameSID-string
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | 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.
Parameter properties
| Type: | AppxVolume |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | True |
| 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
Outputs
Microsoft.Windows.Appx.PackageManager.Commands.AppxPackage
This cmdlet returns an AppxPackage object that contains information, including the full name of the app package.