Use the WebPICmd Command-Line Tool
Updated: April 13, 2011
The WebPICmdLine command-line tool (WebPICmdLine.exe) that enables you to automate the application and service installation for the Windows Azure web role. WebPICmdLine is a command line front end to the Microsoft Web Platform Installer. To download WebPICmdLine, see Microsoft Web Platform Installer 3.0.
WebPICmdLine [options]
When you use the Web PI command-line tool with Windows Azure, there are several parameter options available. For each call to WebPICmdline one of the options listed in the following table is required.
| Option | Description | ||
|---|---|---|---|
|
/Applications:<ApplicationTitle or AppID>[@AppParameterFile.app] |
Specifies the applications to install. This is a required parameter, and you can use either the application name or the product ID.
Multiple applications can be specified by providing a comma separated list. The AppParameterFile.app is an optional file that contains the application configuration information. The /Applications option takes a list of applications@app-parameter-file pairs that specify installation parameters for the application being installed.
|
||
|
/List:[Installed|All|Available|Feeds|Languages] |
Not used for Windows Azure installations. |
||
|
/Products:<ProductTitle or ProductID or ALL> |
Specifies the products to install.
|
The following table lists parameters that can be combined with the required parameters to provide additional functionality.
| Option | Description | ||
|---|---|---|---|
|
/XML:<FilePath> |
Specifies the path to the Web PI XML file that you can use to retrieve the list of applications and products that are available to install. If this parameter is not specified, the installer uses the Web PI XML file available at the following Microsoft web site: Web Platform Installer 3.0 Feed. The <FilePath> parameter can specify an absolute path or a URL. |
||
|
/Feeds: <UR to a custom feed> |
Specifies the custom feed locations for applications and products that are available to install. This parameter is a comma separated list that contains the location of Microsoft supported feeds and custom feed locations. The /Feeds parameter can be combined with the following options:
|
||
|
/Language:<Language of the installer> |
Specifies the language to install for products and applications.
|
||
|
/Log:<LogPath> |
Specifies the location to store the log file. By default, WebPICmdLine produces a brief command line output and creates a verbose log file. If this option is not specified, the log file is saved to the location from which the tool was run. The log file is created with the datetime stamp as the file name. |
||
|
/SQLPassword:<password> |
Specifies the system administrator password to set when installing Microsoft SQL Server 2008 R2 Express and is only used when installing SQL Server Express. If the parameter is not specified and WebPICmdLine detects that SQL Server Express is being installed (as a dependency for another product or explicitly as a /Products parameter input), it will prompt the user for the system administrator password. |
||
|
/MySQLPassword:<password> |
Specifies the root password to set when installing MySQL software. If the parameter is not specified and WebPICmdLine detects that MySQL software is being installed (as a dependency for another product or explicitly as a /Products parameter input), it will prompt the user for the root password. |
||
|
/accepteula |
Automatically accept the End User License Agreement (EULA) for the product being installed. |
||
|
/IISExpress |
Not used for Windows Azure installations. |
To install the x86 version of PHP:
WebPICmdLine.exe /Products: PHP
To install default document, directory browse and static content:
WebPICmdLine.exe /Products: StaticContent, DefaultDocument, DirectoryBrowse
To install a product by using a specific Web PI friendly XML file:
WebPICmdLine.exe /Products: MyProduct /XML: MyXML
To install the application DasBlog:
WebPICmdLine.exe /Applications: DasBlog
To install a valid application package (zip file):
Webpicmdline.exe /package:[path to app.zip][@parameters.app]
To install all products from specified feeds:
WebPICmdLine.exe /Products:All /Feeds:Media, http://localhost/feelist.xml
To install specified products and applications from specific feeds along with product and applications:
WebPICmdLine.exe /Products:A,B,FastCGI /Applications:app1@app1.app,app2@app2.app,DasBlog /XML:http://localhost/myProductList.xml /Feeds: Enterprise, http://localhost/myfeed.xml
To install products in a specific language:
WebPICmdLine.exe /Products:A,B,C /Language:fr
Note