Command Line Support

AdminStudio 2023 | 25.0 | Automated Application Converter

You can choose to run an Automated Application Converter project file via command line using the following command:

    aacx.exe projectname.aacx

where projectname.aacx is the project file to load and execute. Results are displayed in console mode.

You can also use the following command line parameters to override project file settings:

Command Line Parameters

Parameter

Description

/create

Use the /create parameter to indicate the virtual formats to create, such as:

    aacx.exe /create formattype projectname.aacx

where formattype can be any of the following (case-insensitive):

    AppV
    Citrix
    ThinApp

    MSI

    xpf

and projectname.aacx is the project file to load and execute.

For example, to create an App-V package, enter:

    aacx.exe /create AppV myproject.aacx

Multiple create commands can be specified in the same command line. For example, to create all virtual formats, enter:

    aacx.exe /create AppV /create Citrix /create ThinApp myproject.aacx

Note:Settings made using the /create parameter override the selections you made on the Select Output Formats panel, which are saved in the project file.

/help

/?

To view command line help, enter either of the following:

    aacx.exe /?
    aacx.exe /help

/log

To create a unicode text file to contain output messages, enter the /log parameter followed by an output file name:

    aacx.exe /log output.txt myproject.aacx

Note: These are the same output messages that would appear in the Output window when using the Automated Application Converter interface,

/options

To specify an alternate options.ini file for repackaging with Automated Application Converter, enter the /options parameter followed by the path to the options.ini file that you want to use, such as:

/options C:\options.ini

Using this option enables you to specify a different options.ini file when repackaging with Automated Application Converter than the options.ini file that you use when performing standard repackaging with Repackager (which could have custom options in it).

The specified options.ini file will be copied to the guest image during repackaging and will overwrite the default Repackager options.ini file.

/outdir

To override the output directory for built and converted packages that was set in the project file on the Select Output Formats wizard panel, use the /outdir parameter:

    aacx.exe /outdir "C:\output\aacxoutput" myproject.aacx

where C:\output\aacxoutput is the name of the directory that will contain the output.

/report

To specify the name of the HTML report that is generated after conversion, use the /report parameter:

    aacx.exe /report reportname.html myproject.aacx

/showreport

To specify the name of the HTML report that is generated after conversion and to automatically display that report, use the /showreport parameter:

    aacx.exe /showreport reportname.html myproject.aacx

/vmplatform

To specify the platform to use when performing automated repackaging, overriding the VMs selected in the project file, use the /vmplatform parameter:

    aacx.exe /vmplatform platformvalue proj.aacx

where platformvalue is constructed from a version integer using the formula of MajorVersion * 100 + MinorVersion of the operating system (such as 600 for Windows Vista), followed optionally by s (for server) and/or x64 (for 64-bit). Examples are below.

Windows Vista 32-bit

aacx.exe /vmplatform 600 myproject.aacx

Windows Vista 64-bit

aacx.exe /vmplatform 600x64 myproject.aacx

Windows Server 2008 R2 64-bit

aacx.exe /vmplatform 601sx64 myproject.aacx

All enabled machines

aacx.exe /vmplatform any myproject.aacx

Note:The version integer described above is similar to the Windows Installer VersionNT property. See Operating System Property Values on the MSDN website.