Export (0) Print
Expand All

Get-AppxPackage

Windows Server 2012 R2 and Windows 8.1

Updated: March 3, 2014

Applies To: Windows 8.1, Windows PowerShell 4.0, Windows Server 2012 R2

Get-AppxPackage

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

Syntax

Parameter Set: Default
Get-AppxPackage [[-Name] <String> ] [[-Publisher] <String> ] [-AllUsers] [-PackageTypeFilter <PackageTypes> {Bundle | Framework | Main | None | Resource} ] [-User <String> ] [ <CommonParameters>]




Detailed Description

The Get-AppxPackage cmdlet gets a list of the app packages (.appx) that are installed in a user profile. 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

Lists app packages (.appx) for all user accounts on the computer. To use this parameter, you must run the command by using administrator permissions.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a particular package. If you use this parameter, the cmdlets will return only results for this package. Wildcards are permitted.


Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-PackageTypeFilter<PackageTypes>

Specifies one or multiple types of packages that should be returned from the package repository. The PackageTypeFilter value can be:

     -- bundle

     -- framework

     -- main

     -- resource

     -- none



By default, Get-AppxPackage only returns packages of type: Main and Framework.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-Publisher<String>

Specifies the publisher of a particular package. If you use this parameter, the cmdlets will return only results for this publisher. Wildcards are permitted.


Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-User<String>

Specifies a user name. If you use this parameter, the cmdlets will return only a list of app packages (.appx) that are installed for the specified user. 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


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters.

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

  • System.String[]

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Microsoft.Windows.Appx.PackageManager.Commands.AppxPackage

    An AppxPackage object that contain information, including the full name of the app package.


Examples

Example 1

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


PS C:\> Get-AppxPackage -AllUsers

Example 2

This command displays information about Package1 if it's installed in the specified user profile.


PS C:\> Get-AppxPackage -Name Package1 –User domain\username

Related topics

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft