Add-ASPackageForConversion
Edition:Powershell cmdlets are enabled with AdminStudio Enterprise Edition and with Workflow Manager.
The Add-ASPackageForConversion cmdlet adds a package to the Automated Application Converter project file for conversion. It could be used to add a series of packages to an Automated Application Converter project file for conversion. This cmdlet allows you to make decisions in your script for a list of packages and choose which one you need to add for conversion.
Note:To make sure that the Automated Application Converter project file is cleaned of any packages in it, use the ‑CleanProjectFile parameter. Usually this is used the first time you add a package.
Examples
The following are examples of the Add-ASPackageForConversion cmdlet:
Add-ASPackageForConversion-PackagePath C:\Packages\Reader\Reader.msi-CleanProjectFile
Add-ASPackageForConversion-PackagePath C:\Packages\Orca\Orca.msi-AACSettings C:\Packages\test.aacx
In this example, two packages are added to the default Automated Application Converter project file (which is specified in the Automated Application Converter settings file using the Set‑ASConfigPlatform -AACSettings cmdlet).
This example includes the -CleanProjectFile parameter in the first cmdlet to clean up the list of packages in the project file when it is created. However, it is not necessary to specify the parameter in subsequent Add‑ASPackageForConversion cmdlets.
Parameters
The Add-ASPackageForConversion cmdlet has the following parameters:
|
Parameter |
Description |
|
PackagePath |
Mandatory parameter which specifies the path to the package that needs to be added to the Automated Application Converter settings file for conversion. |
|
[AACSettings] |
Use to specify the Automated Application Converter project file to use during conversion. If it is not supplied, a copy of the project file specified in the platform settings file will be used. |
|
[CleanProjectFile] |
Specify this parameter the first time you add a package so that references to any packages in the Automated Application Converter project file will be removed. |
|
[CommandLine] |
Use to specify command line parameters that can be used to silently install this package during repackaging. |
|
[HardTimeOut] |
Use to specify the hard time-out (in minutes) for the package installation. |
|
[SoftTimeout] |
Use to specify the soft time-out (in minutes) for the package installation. |
|
[Transforms] |
List of transforms to use during repackaging. When specifying multiple transform files, use commas to separate them. |
|
[UseSingleStepSnapshot] |
Use to specify that you want to use the Snapshot installation technology to repackage the package. If this parameter is not used, the Installation Monitoring installation technology will be used. |
|
[IsCompressed] |
Specifies that this package (mostly .exe files) is compressed, so the entire folder tree including this .exe will be copied for repackaging. For .exe files, the default value is Compressed=False. |
Return Values
The name and path to the Automated Application Converter settings file is returned in the following format:
[Path]/ProjectFileName.Copy.aacx