New-ASCatalog

AdminStudio 2020 | 19.0 | AdminStudio PowerShell Cmdlets

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

You can use the New-ASCatalog cmdlet to create a new Application Catalog.

Examples

The following is the syntax used to create a new Application Catalog:

New-ASCatalog-CatalogName NameOfNewCatalog

For example:

New-ASCatalog-CatalogName CAT2016FEB

Important:When AdminStudio executes the New-ASCatalog cmdlet, it uses the upgrade.xml file, which contains a list of the SQL scripts that need to be run to create a new Application Catalog. By default, the upgrade.xml file is installed in the Support subdirectory of the AdminStudio installation directory. If you want to create a new Application Catalog using an upgrade.xml file in a different location, you need to provide the path to that file in the New-ASCatalog cmdlet, such as:

New-ASCatalog C:\MyScripts -CatalogName MyNewCatalog

Note:Before using the New-ASCatalog cmdlet to create a new Application Catalog, you need to have already used the Set-ASConfigPlatform cmdlet with the ConnectionString parameter to enter the connection information to the SQL database.

Parameters

The New-ASCatalog cmdlet has the following parameters:

New-ASCatalog Parameters

Parameter

Description

CatalogName

Use to enter a name for the new Application Catalog. Upon successful creation, you will be automatically connected to the new Application Catalog.

[UseSoftwareRepository]

Use to enable the software repository in the new Application Catalog. This parameter requires you to also supply the user name, password, and path to the repository. for example:

New-ASCatalog -CatalogName mycatalog -UseSoftwareRepository SoftwareRepositoryUser=JoeSmith; SoftwareRepositoryPassword=mypassword123; SoftwareRepositoryPath=C:\MyRepository;

[ScriptPath]

When AdminStudio executes the New-ASCatalog cmdlet, it uses the upgrade.xml file, which contains a list of the SQL scripts that need to be run to create a new Application Catalog. By default, the upgrade.xml file is installed in the Support subdirectory of the AdminStudio installation directory. If you want to create an Application Catalog using an upgrade.xml file in a different location, you need to use this parameter to provide the path to that file:

New-ASCatalog -ScriptPath C:\MyScripts

Return Values

A success or failure message is returned.