Command Line for PowerShell Script

FlexNet Manager Suite 2023 R2 (On-Premises)

The AppVMgmtSvr.ps1 PowerShell script is required only when importing inventory from Microsoft App-V release 5.0 or later. (It is not required if you are using App-V release 4.6.)

For applicable releases, AppVMgmtSvr.ps1 is installed on the App-V Management Server, where, on a schedule that you determine, it collects details of the available App-V packages, and the users and computers that have access to the packages. (Separately, usage information is collected by the App-V server adapter, with its separate configuration described in Configuring the Adapter.)

The following options are supported, both for running AppVMgmtSvr.ps1 manually and for executing it from a scheduled task or other scheduling tool. None of the options is mandatory, although some are required for normal operation.

Syntax

AppVMgmtSvr.ps1 [options...]

Options

-beaconUrl validURL
        -logFilePath log_file
        -outputFilePath output_file
        -password password
        -upload $true | $false
        -username account

where

-beaconUrl validURL

The URL to the appropriate inventory beacon to which the script should upload the generated .raa file. Include the protocol (HTTP or HTTPS), and if your inventory beacon uses a non-default port, include the port number in the standard way.

Note: Include only the basic URL of the server. No internal paths are needed, as these details are added automatically by AppVMgmtSvr.ps1.

There is no default value for beaconUrl, so that in production use (when -upload $true), a value must be supplied. It can be omitted for local testing on the server when uploading is not required. If -upload $true and beaconUrl is not set, obviously the upload must fail.

Example values:

http://flexnetbeacon.example.com
https://flexnetbeacon.example.com:499

-logFilePath log_file

A file path (either absolute, or relative to the folder in which the script is executing) and file name for the log file generated by AppVMgmtSvr.ps1. Enclose the path in double quotation marks. A file with consistent name and path over time is replaced at each execution, containing only the results of the last execution, thus preventing unmanaged storage requirements. When this option is not specified, the default value is AppVMgmtSvr.log, saved in the folder where the script is executing.

-outputFilePath output_file

A file path (either absolute, or relative to the folder in which the script is executing) and file name for the output remote application access (.raa) file generated by AppVMgmtSvr.ps1. Enclose the path in double quotation marks. If the same name and path is used, the file is overwritten at each run of the script. When the option is not specified, the default value is FNMS_AppV.raa, saved in the folder where the script is executing.

-password "password"

The password (in plain text) for the account specified in username. Omitted when that option is not required. If specified, enclose the value in double quotation marks. When required and not specified, the script uses details of the account running the process.

-upload $true | $false

A Boolean that determines whether to attempt uploading the output file to an inventory beacon identified in beaconUrl. When not specified, the default is true, requiring that beaconUrl is specified so that the upload can succeed.

-username "account"

The account name used to upload the generated .raa file to the inventory beacon identified in beaconUrl. This is not required for inventory beacons using anonymous authentication. It may be specified for inventory beacons using Windows Basic Authentication. If specified, enclose the value in double quotation marks. When it is specified, the matching password must be provided in the -password option. When required and not specified, the script uses details of the account running the process.

Examples

(Examples here may be line-wrapped for convenient presentation; but should be entered on a single command line.)

Collect the inventory from the App-V Management Server, saving the file locally for inspection:

.\AppVMgmtSvr.ps1 -upload $false

Similarly, collect the inventory, saving the output and logs to temporary locations to avoid overwriting the normal output:

.\AppVMgmtSvr.ps1 -outputFilePath "C:\temp\FNMS_AppV.raa"
                  -logFilePath "C:\temp\AppVMgmtSvr.log"
                  -upload $false

Collect the inventory, and upload it to the specified inventory beacon, using the username and password for the account currently running the script:

.\AppVMgmtSvr.ps1 -beaconUrl http://flexnetbeacon.example.com

Upload the collected inventory to the specified inventory beacon, using the testdomain\administrator account:

.\AppVMgmtSvr.ps1 -beaconUrl http://flexnetbeacon.example.com
                  -username "testdomain\administrator" 
                  -password "somepassword"