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