windows-itpro-docs/mdop/appv-v5/how-to-manage-app-v-50-packages-running-on-a-stand-alone-computer-by-using-powershell.md

title, description, author, ms.assetid, ms.reviewer, manager, ms.author, ms.pagetype, ms.mktglfcycl, ms.sitesec, ms.prod, ms.date

title	description	author	ms.assetid	ms.reviewer	manager	ms.author	ms.pagetype	ms.mktglfcycl	ms.sitesec	ms.prod	ms.date
How to Manage App-V 5.0 Packages Running on a Stand-Alone Computer by Using PowerShell	How to Manage App-V 5.0 Packages Running on a Stand-Alone Computer by Using PowerShell	dansimp	1d6c2d25-81ec-4ff8-9262-6b4cf484a376		dansimp	dansimp	mdop, appcompat, virtualization	deploy	library	w10	08/30/2016

How to Manage App-V 5.0 Packages Running on a Stand-Alone Computer by Using PowerShell

The following sections explain how to perform various management tasks on a stand-alone client computer by using PowerShell:

• To return a list of packages

• To add a package

• To publish a package

• To publish a package to a specific user

• To add and publish a package

• To unpublish an existing package

• To unpublish a package for a specific user

• To remove an existing package

• To enable only administrators to publish or unpublish packages

• Understanding pending packages (UserPending and GlobalPending)

To return a list of packages

Use the following information to return a list of packages that are entitled to a specific user:

Cmdlet: Get-AppvClientPackage

Parameters: -Name -Version -PackageID -VersionID

Example: Get-AppvClientPackage –Name “ContosoApplication” -Version 2

To add a package

Use the following information to add a package to a computer.

Important   This example only adds a package. It does not publish the package to the user or the computer.

 

Cmdlet: Add-AppvClientPackage

Example: $Contoso = Add-AppvClientPackage \\path\to\appv\package.appv

To publish a package

Use the following information to publish a package that has been added to a specific user or globally to any user on the computer.

Publishing method	Cmdlet and example
Publishing to the user	Cmdlet: Publish-AppvClientPackage Example: Publish-AppvClientPackage “ContosoApplication”
Publishing globally	Cmdlet: Publish-AppvClientPackage Example: Publish-AppvClientPackage “ContosoApplication” -Global

 

To publish a package to a specific user

Note   You must use App-V 5.0 SP2 Hotfix Package 5 or later to use this parameter.

 

An administrator can publish a package to a specific user by specifying the optional –UserSID parameter with the Publish-AppvClientPackage cmdlet, where -UserSID represents the end user’s security identifier (SID).

To use this parameter:

• You can run this cmdlet from the user or administrator session.

• You must be logged in with administrative credentials to use the parameter.

• The end user must be logged in.

• You must provide the end user’s security identifier (SID).

Cmdlet: Publish-AppvClientPackage

Example: Publish-AppvClientPackage “ContosoApplication” -UserSID S-1-2-34-56789012-3456789012-345678901-2345

To add and publish a package

Use the following information to add a package to a computer and publish it to the user.

Cmdlet: Add-AppvClientPackage

Example: Add-AppvClientPackage \\path\to\appv\package.appv | Publish-AppvClientPackage

To unpublish an existing package

Use the following information to unpublish a package which has been entitled to a user but not remove the package from the computer.

Cmdlet: Unpublish-AppvClientPackage

Example: Unpublish-AppvClientPackage “ContosoApplication”

To unpublish a package for a specific user

Note   You must use App-V 5.0 SP2 Hotfix Package 5 or later to use this parameter.

 

An administrator can unpublish a package for a specific user by using the optional –UserSID parameter with the Unpublish-AppvClientPackage cmdlet, where -UserSID represents the end user’s security identifier (SID).

To use this parameter:

• You can run this cmdlet from the user or administrator session.

• You must be logged in with administrative credentials to use the parameter.

• The end user must be logged in.

• You must provide the end user’s security identifier (SID).

Cmdlet: Unpublish-AppvClientPackage

Example: Unpublish-AppvClientPackage “ContosoApplication” -UserSID S-1-2-34-56789012-3456789012-345678901-2345

To remove an existing package

Use the following information to remove a package from the computer.

Cmdlet: Remove-AppvClientPackage

Example: Remove-AppvClientPackage “ContosoApplication”

Note   App-V cmdlets have been assigned to variables for the previous examples for clarity only; assignment is not a requirement. Most cmdlets can be combined as displayed in To add and publish a package. For a detailed tutorial, see App-V 5.0 Client PowerShell Deep Dive.

 

To enable only administrators to publish or unpublish packages

Note   This feature is supported starting in App-V 5.0 SP3.

 

Use the following cmdlet and parameter to enable only administrators (not end users) to publish or unpublish packages:

Cmdlet	Set-AppvClientConfiguration
Parameter	-RequirePublishAsAdmin Parameter values: 0 - False 1 - True Example:: Set-AppvClientConfiguration –RequirePublishAsAdmin1

 

To use the App-V Management console to set this configuration, see How to Publish a Package by Using the Management Console.

Understanding pending packages (UserPending and GlobalPending)

Starting in App-V 5.0 SP2: If you run a PowerShell cmdlet that affects a package that is currently in use, the task that you are trying to perform is placed in a pending state. For example, if you try to publish a package when an application in that package is being used, and then run Get-AppvClientPackage, the pending status appears in the cmdlet output as follows:

Cmdlet output item	Description
UserPending	Indicates whether the listed package has a pending task that is being applied to the user: True False
GlobalPending	Indicates whether the listed package has a pending task that is being applied globally to the computer: True False

 

The pending task will run later, according to the following rules:

Task type	Applicable rule
User-based task, e.g., publishing a package to a user	The pending task will be performed after the user logs off and then logs back on.
Globally based task, e.g., enabling a connection group globally	The pending task will be performed when the computer is shut down and then restarted.

 

For more information about pending tasks, see About App-V 5.0 SP2.

Got a suggestion for App-V? Add or vote on suggestions here. Got an App-V issue? Use the App-V TechNet Forum.

Related topics

Operations for App-V 5.0

Administering App-V by Using PowerShell