New features in configuration system and appcmd in IIS 7.5

ksingla — Wed, 25 Mar 2009 17:48:00 GMT

Following new features have been added to IIS configuration system and appcmd command line tool in IIS 7.5. Configuration System 1. Configuration system tracing and logging In IIS 7.5, IIS native configuration system can generate trace events capturing...(read more)

Things you can do by piping appcmd commands

ksingla — Mon, 18 Jun 2007 02:16:00 GMT

Here are some of the cool things you can do by piping appcmd commands together in IIS7. Application Pools 1. Recycle all application pools (replace recycle with start/stop to start/stop all apppools) appcmd list apppool /xml | appcmd recycle apppool ...(read more)

Steps to enable tracing using appcmd

ksingla — Thu, 17 May 2007 16:45:00 GMT

Here are the steps you need to enable tracing for a site using appcmd.

1.       Enable tracing for site.
2.       Enable tracing for all request paths and for all response codes.
3.       Appcmd leaves verbosity to default value “warning”. Get the providers count to change verbosity in step 4.
4.       Change verbosity to verbose for all providers.

@REM Step1
@REM Change site name in the commands if you need to

%windir%\System32\inetsrv\appcmd configure trace "Default Web Site" /enablesite

@REM Step2
@REM Change /statusCodes if you don’t want to enable tracing for all response codes.
@REM Status code range doesn’t work in vista client. Change accordingly.
@REM Use /path to enable tracing for requests to particular file. Eg. /path:*.aspx
@REM Use /timeTaken to enable tracing based on time taken to process request

%windir%\System32\inetsrv\appcmd configure trace "Default Web Site" /enable /statusCodes:100-999 -commit:apphost

@REM Step 3
@REM Change %%V to %V if you are not running in batch mode

%windir%\System32\inetsrv\appcmd list config "Default Web Site" -section:traceFailedRequests -text:* | findstr provider:> traceproviders.txt
SET PROCOUNT=-1
for /F %%V in (traceproviders.txt) do set /a PROCOUNT = PROCOUNT + 1

@REM Step 4
@REM Change %%V to %V if you are not running in batch mode

for /L %%V in (0,1,%PROCOUNT%) do %windir%\System32\inetsrv\appcmd set config "Default Web Site" /section:traceFailedRequests /[path='*'].traceAreas.[@%%V].verbosity:Verbose -commit:apphost

You can remove step3 and change step 4 to run blindly from 0 to 3. You might get invalid index errors from appcmd if you have less than 4 providers installed on your machine which you can ignore.

-Kanwal-

AppcmdUI - appcmd command autocompletion tool

ksingla — Sun, 15 Apr 2007 01:29:00 GMT

Do you always find yourself using “/?” in appcmd to find what switches you need? Do you always run “appcmd list” commands to see the list of apppools/sites/apps/traces etc before actually running the command? Do you always end up opening schema when working with "appcmd config" commands? Worry no more. I have written AppcmdUI to alleviate your pains. AppcmdUI provides you available options at each step so that you only need to pick the option from the list as in the snapshot below.

Features
§ Works with both “appcmd <object> <verb>” and “appcmd <verb> <object>” command styles.
§ Shows list of objects and verbs available. Builds auto complete list dynamically so that you see only few options.
§ Builds list of current application pools, sites, applications, virtual directories, backups, module, traces, worker processes and shows them as parameter values. Updates this list when “appcmd add/delete” commands are used.
§ Force update option for tool to pick latest configuration data when “appcmd set config” or other scripts/tools are used to add/delete apppools/sites/apps/vdirs.
§ Parses the schema and shows section names in commands which require section names. Custom defined sections are automatically picked.
§ When working with a particular section, shows list of attributes/elements/collections and helps you setting attributes and adding/removing collection elements.
§ Shows attributes, elements, collections which you can set using “appcmd set apppool|site|app|vdir|module” commands.
§ Shows general appcmd parameters. Uses –parameter for general parameters rather than /parameter to show they are different.
§ Shows possible attributes when “appcmd –text:” used.
§ Can execute command and see the output in the same window.
§ Shows examples of commands you are working with which are in “appcmd <verb> <object> /?” help.
§ Supports auto complete and command execution even when piping commands together.
§ Limited support for identifiers. There is a corresponding /parameter option for most of the identifiers. Uses /parameter:value.
§ NEW - Up-down lets you browse recently executed commands.
§ NEW - If you run the application without sufficient privileges, it shows UAC dialog box for you to grant access.

Installation
You can use AppcmdUI only on machines which has IIS7 and appcmd.exe installed. Download attached AppcmdUIInstall.zip and run self extracting package AppcmdUIInstall.exe. Extract files (AppcmdUI.exe and AppcmdUI.xml) to a folder on your machine and you are done.

How to Use
Run AppcmdUI.exe as elevated (newest version will demand administrator access if needed only if when you don't run it from command window). Running from an elevated command prompt is not enough because of UAC settings for applications which are not under windows directory. Start typing appcmd commands in the textbox. You will get list of available options as you go along. Use mouse or down/up arrow keys to select any of available options. Auto complete list is updated every time you type space/comma/colon/dot so that you only see few options which are valid in current context and helps you choose only next option. Snapshot below shows list of available objects in appcmd which are shown on typing “appcmd “.

AppcmdUI uses “appcmd <object> <verb>” format. So you see list of available objects after appcmd. If you type “appcmd <verb>” and then space, you will see list of objects which you can use with the verb you typed. If you want to get list of verbs and not objects when you type “appcmd “, you can set <verb> <object> option in the menu as shown below.

When you have the <verb> <object> option set, you will see the available verbs after appcmd as shown below.

Once you have selected verb and object, you will see list of available options which can be used with them.

Parameter Values
When you need the available application pools, sites, applications, virtual directories, backups, traces, worker processes in the command, AppcmdUI shows the values you can use. Next time when you need to start or stop apppools/sites, delete apps/vdirs or inspect traces, you won’t need “appcmd list” command first.

Force Update
AppcmdUI picks up list of application pools, sites, applications, virtual directories, backups once and update this list only when “appcmd add/delete” calls are made. If you use “appcmd set config” call or some other means of creating apppools/sites/apps etc, you would see the list is not updated. Eg. If a new application pool “AppcmdAppPool” is created using “appcmd set config /section:applicationPools /+[name='AppcmdAppPool']", that apppool is not shown in the list of available apppools.

You can use "Force Update" option to force AppcmdUI to update list of application pools, sites, applications etc.

After forcing an update, "AppcmdAppPool" is shown in the list of available application pools.

Working with configuration
When you are working with “appcmd list config” or “appcmd set config”, you get list of available sections as soon as you enter “/section:” as shown below.

AppcmdUI also shows you list of attributes, elements, collections when working with set/list commands. Adding a collection element is now a whole lot easier as you can see below.

List of attributes, elements, collections is also available when you work with “appcmd set <apppool|site|app|vdir”. In the snapshot below, I am getting attributes which can be set for a virtual directory.

Schema elements are available with various list commands as well after you type “-text:”. –text with list command allows you to print only particular attributes.

Hope you find working with appcmd much easier with this.

-Kanwal

Kanwaljeet Singla's Blog : Appcmd

New features in configuration system and appcmd in IIS 7.5

Things you can do by piping appcmd commands

Steps to enable tracing using appcmd

AppcmdUI - appcmd command autocompletion tool