New-ASCatalog
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:
|
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.