< Back
Get-AppxPackage
Post
NAME Get-AppxPackage
SYNOPSIS
Gets a list of the app packages that are installed in a user profile.
SYNTAX
Get-AppxPackage [[-Name] <String>] [[-Publisher] <String>] [-AllUsers] [-PackageTypeFilter {None | Main | Framework | Resource | Bundle | Xap}]
[-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.
PARAMETERS
-AllUsers [<SwitchParameter>]
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.
Required? false
Position? named
Default value False
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-Name <String>
Specifies the name of a particular package. If you specify this parameter, the cmdlet returns results for this package only. Wildcards are
permitted.
Required? false
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-PackageTypeFilter <PackageTypes>
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.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-Publisher <String>
Specifies the publisher of a particular package. If you specify this parameter, the cmdlet returns results only for this publisher. Wildcards
are permitted.
Required? false
Position? 2
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-User <String>
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
Required? false
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Volume <AppxVolume>
Specifies an AppxVolume object. If you specify this parameter, this cmdlet returns only packages that are relative to volume that this
parameter specifies.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
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.
NOTES
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.
RELATED LINKS
Package Manager API http://go.microsoft.com/fwlink/?LinkId=245447
How to Add and Remove Apps http://go.microsoft.com/fwlink/?LinkID=231020
Add-AppxPackage
Get-AppxPackageManifest
Move-AppxPackage
Remove-AppxPackage
SYNOPSIS
Gets a list of the app packages that are installed in a user profile.
SYNTAX
Get-AppxPackage [[-Name] <String>] [[-Publisher] <String>] [-AllUsers] [-PackageTypeFilter {None | Main | Framework | Resource | Bundle | Xap}]
[-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.
PARAMETERS
-AllUsers [<SwitchParameter>]
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.
Required? false
Position? named
Default value False
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-Name <String>
Specifies the name of a particular package. If you specify this parameter, the cmdlet returns results for this package only. Wildcards are
permitted.
Required? false
Position? 1
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-PackageTypeFilter <PackageTypes>
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.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
-Publisher <String>
Specifies the publisher of a particular package. If you specify this parameter, the cmdlet returns results only for this publisher. Wildcards
are permitted.
Required? false
Position? 2
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-User <String>
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
Required? false
Position? named
Default value None
Accept pipeline input? True (ByValue)
Accept wildcard characters? false
-Volume <AppxVolume>
Specifies an AppxVolume object. If you specify this parameter, this cmdlet returns only packages that are relative to volume that this
parameter specifies.
Required? false
Position? named
Default value None
Accept pipeline input? True (ByPropertyName, ByValue)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
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.
NOTES
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.
RELATED LINKS
Package Manager API http://go.microsoft.com/fwlink/?LinkId=245447
How to Add and Remove Apps http://go.microsoft.com/fwlink/?LinkID=231020
Add-AppxPackage
Get-AppxPackageManifest
Move-AppxPackage
Remove-AppxPackage