Skip to main content

25 de agosto de 2026

App Volumes PowerShell Cmdlets for Delivering Applications to Windows Endpoints

When delivering applications to a Windows endpoint using device management tools (Standalone mode), you can either use the App Volumes application package in the .msi or .vhd format. If you want to use your own delivery mechanism, you must use the .vhd format and PowerShell Cmdlets that allow you to install, swap, and uninstall the applications.

For more information about delivering applications to Windows endpoints, see the Application delivery in Standalone Mode section in Deliver App Volumes Applications to Windows Endpoints.

PowerShell Cmdlets

Command line ArgumentTask
Install-AppVolumesPackage -Path VHD_path -ClassicDelivery -StoreOfflineInstalls the application on the Windows endpoint, using the .vhd package from the path specified in the command. The .vhd and .json files must be at the same location and have the same file name.

The following are optional parameters:
  • -ClassicDelivery
    Use this parameter to change the package delivery mode to classic.
    Delivery type can be changed to classic at the time of installing the application on the endpoint.
    If the application package has on-demand data available during capture, then by default the delivery type is on-demand. Else, the delivery type is classic.

  • -StoreOffline
    When this parameter is used, the .vhd and .json files of the application package are locally stored on the Windows endpoint at this location C:\ProgramData\Omnissa\AppVolumes\OfflineCache\Volume ID, where Volume ID is the package volume ID. The package gets virtualized from this location and then the application is delivered.

    If this parameter is not provided, by default, the package gets virtualized and application is delivered from the path as defined by the -Path parameter.
    Note: In earlier versions of App Volumes, the .vhd and .json files are always locally stored on the Windows endpoint.

Uninstall-AppVolumesPackage -Path VHD pathUninstalls the application from the Windows endpoint.

To enhance end user experience, notifications can be presented to the end user before the application gets uninstalled from the Windows endpoint. EnableAppChangeNotification, an svservice parameter, allows you to enable such notifications.
Depending on the parameter value, the uninstall behavior varies.
To understand how the parameter helps in end user experience during uninstall, see Enable Notification in a Windows Endpoint During Application Change.
Swap-AppVolumesPackage -OldPath Old VHD path -NewPath New VHD path -ClassicDelivery -StoreOfflineThis command swaps or replaces an existing application package with a new application package. An existing package can be swapped with another version of the application package or a different application package.

To enhance end user experience, notifications can be presented to the end user before the application gets swapped from the Windows endpoint. EnableAppChangeNotification, an svservice parameter, allows you to enable such notifications.

Depending on the EnableAppChangeNotification parameter value, the swap behavior varies.
To understand how the parameter helps in end user experience during application swap, see Enable Notification in a Windows Endpoint During Application Change.

-ClassicDelivery and -StoreOffline are optional parameters. When these optional parameters are used, the swap occurs immediately, the delivery mode of the swapped package is classic, and the .vhd and .json files of the new application package are locally stored on the Windows endpoint. For information about these parameters, see the other rows in this table.
Get-AppVolumesPackages -OutputFile path_of_json_outputUse this command to list application packages which are assigned to a particular session. Application details such as package name, package version, and other package identifier details are retrieved and displayed on the command line.

With this command, you can use the -OutputFile file_path parameter.
file_path indicates where the json output must be stored.
When this parameter is used, in addition to the output getting displayed on the command line, the output also gets stored in the json format in a file at the location as mentioned in the parameter.

Example:

In the following example, application package details such as package name, package version, volume ID, App Product ID, path from where the .vhd package is virtualized, and so on are fetched for Adobe Reader XI and Mozilla.
At the Windows PowerShell prompt, the command and output are as follows:

C:\Users\Administrator> Get-AppVolumesPackages

Package Name : Adobe Reader XI (11.0.23)
Package Version : 11.0.23
Volume ID : {b7a2615a-b5d7-4c05-ac2e-59116be2f21a}
App ID : {cc1271b6-8e79-4ae4-9648-4b0c833d93a3}
App Product ID : {000a9960-1c3e-5000-0000-00002349760e}
Package File Path : c:\users\administrator\desktop\adobevhd\adobexi.vhd
Metadata File Path : c:\users\administrator\desktop\adobevhd\adobexi.json


For more information about App Product ID (upgradecode), see Windows Command-Line Arguments for the App Volumes Application Capture Command-Line Program.
Extract-AppVolumesPackageShortcuts -Path VHD_file_path/json_file_path -IncludeIcons -IconFormat ico|png -IconSize Size -IconExtractPath folder_path -OutputFile file_pathUse this command to list all the shortcuts of an application package and retrieve information related to the shortcut.

To enhance user experience, Extract-AppVolumesPackageShortcuts also retrieves the Run-AppVolumesApp command line and the executable for that particular package. As a result, both the command line and executable can be saved and used later to deliver and launch the application.

Note:.vhd and .json (metadata) files must be present at the same location. The files must also have the same name.


The following parameters can be used with this command:

-OutputFile file_path parameter.
file_path indicates where the json output must be stored.
When this parameter is used, in addition to the output getting displayed on the command line, the output also gets stored in the json format in a file at the location as mentioned in the parameter.

-IncludeIcons
This is an optional parameter which can be used to extract the application icon. When this parameter is used, an icon is extracted to the current working directory by default. If a location is specified using the -IconExtractPath parameter, then the icon is extracted to the location specified in the parameter. If the -IncludeIcons parameter is not used, then no icon is extracted.

Other icon-related, optional parameters which can be used only with -IncludeIcons are as follows:
  • -IconFormat ico|png
    Use this parameter to extract the icon as .ico or .png. By default, the icon format is .ico.

  • -IconSize
    Use this parameter to change the icon size to any of the supported dimension values which are as follows: "16x16", "32x32", "48x48", "64x64", "128x128", and "256x256".
    By default, the icon size is 64X64.
    Note: This parameter can be used only when the icon format is .png.

  • -IconExtractPath folder_path
    This optional parameter is used to indicate the location to which the icon is extracted. When this parameter is used, an application icon is extracted to the location mentioned in the folder path.

Example:

In the following example, shortcut and related information such as name, actual path of the application shortcut, description, publisher, and so on are listed for Office 2016. As -IncludeIcon and related parameters are used, icons are extracted to the C:\Users\Administrator\Desktop\temp location in the png format and are of size 256x256. For more information about these details, see the Run-AppVolumesApp description.



At the Windows PowerShell prompt, the command and output are as follows:

C:\Users\Administrator\Desktop> Extract-AppVolumesPackageShortcuts -Path "C:\Users\Administrator\Desktop\Office2016.vhd" -IncludeIcons -IconFormat png -IconSize 256x256 -IconExtractPath "C:\Users\Administrator\Desktop\temp" -OutputFile "C:\Users\Administrator\Desktop\temp\Outputfile.txt"

Name: Access 2016
Path: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Access 2016.lnk
Description:
Publisher : Microsoft Corporation
Version : 16.0.4266.1001
Launch PS Command : Run-AppVolumesApp -Path C:\Users\Administrator\Desktop\Office2016.vhd -LaunchId 7d7c275d-979a-fe73-ff7f-d4c31ff40dbe
Launch Command : AppVolumes.exe runapp -Path C:\Users\Administrator\Desktop\Office2016.vhd -LaunchId 7d7c275d-979a-fe73-ff7f-d4c31ff40dbe
Icon Path : C:\Users\Administrator\Desktop\temp\Access 2016.png

Name: Excel 2016
Path: C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Excel 2016.lnk
Description :
Publisher : Microsoft Corporation
Version : 16.0.4266.1001
Launch PS Command : Run-AppVolumesApp -Path C:\Users\Administrator\Desktop\Office2016.vhd -LaunchId 62a238b4-ec17-94ba-8e9d-43582311b265
Launch Command : AppVolumes.exe runapp -Path C:\Users\Administrator\Desktop\Office2016.vhd -LaunchId 62a238b4-ec17-94ba-8e9d-43582311b265
Icon Path : C:\Users\Administrator\Desktop\temp\Excel 2016.png

Run-AppVolumesApp -Path VHD_path -LaunchID Launch ID-LaunchID: A unique GUID identifier which represents an application shortcut in a package.

When this command is run, an application is delivered and the application shortcut is launched. When an end user clicks the shortcut, the application is launched. Each application shortcut is associated with a unique launch ID (GUID), which is captured at the time of application packaging. As the application is delivered only for that user session, this application is not available for the user after reboot.


Prerequisites:
  • Ensure that you have run the Extract-AppVolumesPackageShortcuts command which retrieves the application shortcut and associated launch ID.
  • Ensure that the .vhd package and the .json (metadata) file are present at the same location and have the same name.

Esta página foi útil?

Enviar feedback sobre este tópico

Este tópico foi útil?

Não inclua informações pessoais ou confidenciais.

Gerando o link…