Set-ASConfigPlatform

AdminStudio 2020 | 19.0 | AdminStudio PowerShell Cmdlets

Edition:Powershell cmdlets are enabled with AdminStudio Enterprise Edition and with Workflow Manager.

Use this cmdlet to set defaults for most of the parameters. These defaults will be used when a specific argument/setting is not overridden in various other PowerShell cmdlets under AdminStudio Platform.

For example, if you want to set the default virtual technology to use for all your conversions, then use:

    Set-ASConfigPlatform-BuildAppV 1

Then during conversion, if you do not specify any virtual technology parameter, the above defaults will be used.

Example

The following is an example of the Set-ASConfigPlatform cmdlet and its ConnectionString parameter with SQL Server authentication:

Set-ASConfigPlatform-ConnectionString "PROVIDER=SQLOLEDB.1;Data Source=SCHLTENG01\MSSQL_5500; User ID=jsmith; Password=admin8032 InitialCatalog=MKTGCAT2016;"

The following is an example of the Set-ASConfigPlatform cmdlet and its ConnectionString parameter with Windows NT authentication:

Set-ASConfigPlatform-ConnectionString "PROVIDER=SQLOLEDB.1;Data Source=SCHLTENG01\MSSQL_5500; Integrated Security=SSPI; InitialCatalog=MKTGCAT2016;"

Parameters

The Set-ASConfigPlatform cmdlet has the following parameters:

Set-ASConfigPlatform Parameters

Parameter

Description

[ConnectionString]

Sets the default connection string for the AdminStudio Platform. A connection string consists of a set of elements, separated by semi-colons.

PROVIDER—Because AdminStudio only supports SQL Server databases, this element must always be set to SQLOLEDB.1.
Data Source—Identifies the database server.
Initial Catalog—Identifies the Application Catalog name.

The elements used in the connection string vary depending upon the authentication method you are using.

SQL Server Authentication

When using this authentication method, you need to include the User ID and Password elements to provide the SQL Server login credentials:

PROVIDER=SQLOLEDB.1;
Data Source=SCHLTENG01\MSSQL_5500;
User ID=UserName;
Password=passwd;
Initial Catalog=CatalogName;

Windows NT Authentication

When using this authentication method, you need to include the Integrated Security=SSPI element to specify that you are using Windows NT authentication:

PROVIDER=SQLOLEDB.1;
Data Source=SCHLTENG01\MSSQL_5500;
Initial Catalog=CatalogName;
Integrated Security=SSPI;

Note:The connection string is encrypted before setting in the PlatformSettings.xml file.

[Group]

Use to specify the default group name where all imported packages should be placed.

Note:This setting can be overridden by the Invoke-ASImportPackage cmdlet.

Note:This default group does not need to already exist in Application Catalog in order for the platform cmdlets to work.

Also, when specifying the Group parameter, you need to include the Applications root group in the path to the group. For example:

Set-ASConfigPlatform -BuildAppV 1 -Group "Applications\SubGroup\SubGroup1"

If you do not include the Applications root group in the path, the packages will be imported under the root node instead of the specified folder path.

[AACSettingsFile]

Specify the Automated Application Converter project file (.aacx) to use for all conversion tasks. This setting can be overridden by individual conversion cmdlets.

[OutputPath]

Specify the default output folder under which all virtualized packages will be stored. This setting can be overridden by individual conversion cmdlets.

[HardTimeout]

Hard time-out (in minutes) for the package installation.

[SoftTimeout]

Soft time-out (in minutes) for the package installation.

[BuildAppV]

Build Microsoft App-V packages (*.sft). Specify 0 (do not build) or 1 (build).

[BuildXenApp]

Build Citrix XenApp profiles (*.profile). Specify 0 (do not build) or 1 (build).

[BuildThinApp]

Build VMWare ThinApp packages (*.exe). Specify 0 (do not build) or 1 (build).

[BuildMSI]

Build Windows Installer packages (*.msi). Specify 0 (do not build) or 1 (build).

[AppVServerHost]

Host name portion of the server location for App-V packages.

[AppVServerPort]

Port number portion of the server location for App-V packages.

[AppVServerProtocol]

Protocol portion of the server location for App-V packages.

Return Values

No values are returned.