Tobin Titus Blog : SDK

IIS logging UI module sample added to CodePlex

TobinTitus — Fri, 03 Oct 2008 19:21:00 GMT

For those of you that remember that far back, I released a sample that also filled a need for Windows Vista. Since the original version of Windows Vista did not ship with a user interface for managing logging, and we needed samples of how to build UI modules available to the public, I released the Logging UI module. For some time, I've been hosting that downloadable release on my private web site (tobint.com). As I plan to make some major changes to my personal site over the next few months, I wanted to make sure the release was still reliably available. That said, I've now added the source code to CodePlex.

You may find the project at http://www.codeplex.com/iis70loggingui .

I have worked with our source asset management team and made this available under the <a href="http://www.codeplex.com/iis70loggingui/license">MS-PL</a>. I hope that this makes the download reliably available. I'm looking forward to developing more samples that I will also be releasing in the same manner.

Logging UI for Vista v1.1 Released

TobinTitus — Thu, 01 Feb 2007 20:45:00 GMT

I have completed the final pieces of the Logging UI for Vista and posted them on the DownloadCENTER. I've completed functionality to allow you to configure central binary logging, central W3C logging, and site defaults. I've modified the look and feel of some of the pages and I've even added tool tips that show what configuration is being changed with each control.

The source code for this project is also available in C#. If I get a few more moments of time and/or many requests in the next few weeks, I may also port the source to VB.NET and C++/CLI.

In the mean time, if you have any questions, feel free to contact me.

You can find the download containing both the source code and the MSI here: http://www.iis.net/downloads/default.aspx?tabid=34&g=6&i=1328

UPDATE: You can find screenshots of the UI module here: http://blogs.msdn.com/photos/tobint/category20627.aspx

Logging UI for IIS 7.0 on Vista: Available for download

TobinTitus — Tue, 30 Jan 2007 20:25:00 GMT

As many of you already know, the management console for IIS 7.0 on Windows Vista does not have a UI for logging. Since this was a pain point for several customers, I decided to test out the extensibility APIs by creating a logging UI module.

I've posted a preview version of my logging UI on the newly opened IIS Download Center. I will be releasing a few updates throughout the week with changes. The module also contains the source code for my UI module under the Microsoft Permissive License. This code will also be updated in future releases.

You can find the download at: http://www.iis.net/downloads/default.aspx?tabid=34&i=1328&g=6

If you have any questions, please feel free to contact me.

Accessing Microsoft.Web.Administration through PowerShell (Part I)

TobinTitus — Fri, 01 Dec 2006 04:09:00 GMT

I've caught the PowerShell bug. In between stints with my ever-expanding code samples, I play with PowerShell a lot. I thought I'd share a quick example of how to load Microsoft.Web.Administration.dll and use it to perform some basic tasks.

Note: I'm running these samples on Windows Vista RTM, but I have no reason to believe this will not work on the PowerShell release candidates for the Vista RC* builds that are available now.

So let's get started.

First, PowerShell has no idea where Microsoft.Web.Administration.DLL is so you have to tell it how to load it. Anyone who has written code to dynamically load an assembly should be familiar with this syntax. Type the following command

PS C:\> [System.Reflection.Assembly]::LoadFrom( "C:\windows\system32\inetsrv\Microsoft.Web.Administration.dll" )

The path to your assembly may change depending on your install. I'll show you later how to use environment variables to calculate the correct path. In the mean time the out put of the line above display something like the following:

GAC Version Location

--- ------- --------

True v2.0.50727 C:\Windows\assembly\GAC_MSIL\Microsoft.Web.Administration\7.0.0.0__31bf3856ad364e35\Microsoft....

Once the assembly is loaded you can use PowerShell's "New-Object" command to create a ServerManager object that is defined in Microsoft.Web.Administration.

PS C:\> (New-Object Microsoft.Web.Administration.ServerManager)

This doesn't give you much except the list of properties the ServerManager exposes:

ApplicationDefaults      : Microsoft.Web.Administration.ApplicationDefaults
ApplicationPoolDefaults :
ApplicationPools         :
SiteDefaults             : Microsoft.Web.Administration.SiteDefaults
Sites                    : {Default Web Site}
VirtualDirectoryDefaults : Microsoft.Web.Administration.VirtualDirectoryDefaults
WorkerProcesses          : {}

To get more detail, you need to use the properties and methods of the ServerManager object to drill down and get the information we want. The ServerManager provides access to all of the sites on your machine through a SiteCollection object. This SiteCollection is made available through the "Sites" property of the ServerManager.

PS C:\> (New-Object Microsoft.Web.Administration.ServerManager).Sites

Which will produce a list view of all the sites and their associated property names/values.

ApplicationDefaults        : Microsoft.Web.Administration.ApplicationDefaults
Applications               : {DefaultAppPool, Classic .NET AppPool}
Bindings                   : {}
Id                         : 1
Limits                     : Microsoft.Web.Administration.SiteLimits
LogFile                    : Microsoft.Web.Administration.SiteLogFile
Name                       : Default Web Site
ServerAutoStart            : True
State                      : Started
TraceFailedRequestsLogging : Microsoft.Web.Administration.SiteTraceFailedRequestsLogging
VirtualDirectoryDefaults   : Microsoft.Web.Administration.VirtualDirectoryDefaults
ElementTagName             : site
IsLocallyStored            : True
RawAttributes              : {name, id, serverAutoStart}

ApplicationDefaults        : Microsoft.Web.Administration.ApplicationDefaults
Applications               : {DefaultAppPool}
Bindings                   : {}
Id                         : 2
Limits                     : Microsoft.Web.Administration.SiteLimits
LogFile                    : Microsoft.Web.Administration.SiteLogFile
Name                       : Test Web Site 1
ServerAutoStart            : False
State                      : Stopped
TraceFailedRequestsLogging : Microsoft.Web.Administration.SiteTraceFailedRequestsLogging
VirtualDirectoryDefaults   : Microsoft.Web.Administration.VirtualDirectoryDefaults
ElementTagName             : site
IsLocallyStored            : True
RawAttributes              : {name, id, serverAutoStart}

Of course, this isn't the easiest view to read, so let's say we just list the site names by piping our site list to the "ForEach-Object" command in PowerShell and display a list of site names only:

PS C:\> (New-Object Microsoft.Web.Administration.ServerManager).Sites | ForEach-Object {$_.Name}

This looks much more concise:

Default Web Site
Test Web Site 1

We could also use the Select-Object syntax to query the list into a table format:

PS C:\> (New-Object Microsoft.Web.Administration.ServerManager).Sites | Select Id, Name

        Id Name
        -- ----
         1 Default Web Site
         2 Test Web Site 1

Now lets use PowerShell to manage application pools. We can fit several commands on one line by using the semi-colon. The following command-line is actually four different operations: Storing the application pool collection into a variable, displaying the name and runtime status of the first application pool, stopping the first application pool, then displaying the name and status again.

PS C:\> $pools=(New-Object Microsoft.Web.Administration.ServerManager).ApplicationPools; $pools.Item(0) | Select Name, State;$pools.Item(0).Stop(); $pools.Item(0) | Select Name, State

Running this sample should display the following:

Name                                         State
----                                         -----
DefaultAppPool                               Started
Stopped
DefaultAppPool                               Stopped

This is nice, but we can do this already with appcmd.exe right? Well, to some extent. We don't get the features of PowerShell that allow us to format our output the data to our liking. Also, as a developer, I find it much easier to use the API syntax I'm already familiar with than to remember appcmd.exe syntax. Furthermore, PowerShell allows us to use WMI alongside our managed code calls, and unlike appcmd.exe, you can extend PowerShell and cmdlets. PowerShell gives you the ability to easily manage multiple servers from one command prompt on one machine. Watch the PowerShell/IIS 7 interview on Channel9 if you want to see this remote administration in action.

One last thing that PowerShell brings to the table is the ability to "spot-weld" our object models (as Scott Hanselman quipped). You can create/modify/extend type data and formatting to your hearts desire. For more information on this, check out the PowerShell documentation found in the PowerShell install, or in the PowerShell documentation set.

So, I would be remiss in this post if I didn't try to make your PowerShell / IIS 7.0 life easier. As such, I've created a profile script that loads all the IIS 7.0 managed assemblies for you. The script is simple and contains more echo commands than actual working script lines.

To install this script run the following command inside PowerShell:

PS C:> if ( test-path $profile ) { echo "Path exists." } else { new-item -path $profile -itemtype file -force }; notepad $profile

This will create a profile path for you if you don't already have one, then open up your profile in notepad. If you haven't added anything to the file, it will obviously display an empty file. Paste the following in notepad when it opens:

echo "Microsoft IIS 7.0 Environment Loader"
echo "Copyright (C) 2006 Microsoft Corporation. All rights reserved."
echo " Loading IIS 7.0 Managed Assemblies"

$inetsrvDir = (join-path -path $env:windir -childPath "\system32\inetsrv\")
Get-ChildItem -Path (join-path -path $inetsrvDir -childPath "Microsoft*.dll") | ForEach-Object {[System.Reflection.Assembly]::LoadFrom( (join-path -path $inetsrvDir -childPath $_.Name)) }

echo " Assemblies loaded."

Now, save the profile and close notepad. You will likely have to sign this script or change your script execution policy to something very weak to make this script run properly (obviously I'm not recommending the latter). To find out more about signing scripts, type "get-help about_signing" in PowerShell. The instructions to create a self-signed certificate found in that help file are as follows:

In an SDK Command Prompt window, run the following commands.
The first command creates a local certificate authority for your computer.
The second command generates a personal certificate from the certificate authority:

makecert -n "CN=PowerShell Local Certificate Root" -a sha1 `
   -eku 1.3.6.1.5.5.7.3.3 -r -sv root.pvk root.cer `
   -ss Root -sr localMachine
makecert -pe -n "CN=PowerShell User" -ss MY -a sha1 `
   -eku 1.3.6.1.5.5.7.3.3 -iv root.pvk -ic root.cer
   MakeCert will prompt you for a private key password.

Go ahead and make a certificate for yourself following those instructions. To sign your profile, within PowerShell type the following:

PS C:\>Set-AuthenticodeSignature $profile @(get-childitem cert:\CurrentUser\My -codesigning)[0] 

So far, you've created a certificate and signed your script. Now, you will have to change your script execution policy down at least one level from the default. The default doesn't allow scripts at all. To get scripts to execute, at the minimum you'll have to set it to "AllSigned" to allow only signed scripts to execute. In this mode, each time you execute a script from a new publisher, you'll be asked what level of trust to assign to the publisher (unless you respond to the prompt to "Always Run" or "Never Run" scripts from that publisher)

Do you want to run software from this untrusted publisher?
File C:\Users\TobinT\Documents\WindowsPowerShell\Microsoft.PowerShell_profile.ps1 is published by CN=PowerShell User
and is not trusted on your system. Only run scripts from trusted publishers.
[V] Never run [D] Do not run [R] Run once [A] Always run [?] Help (default is "D"):

Now, each new instance of PowerShell that you run will automatically load the IIS 7.0 managed assemblies. I know it seems like a great deal of work, but it really isn't once you've made a few rounds around inside PowerShell. Consider that you only have to create the script once and then you have full the full range of the managed IIS 7.0 SDK at your fingertips inside PowerShell.

If you have problems, feel free to leave comments and I'll do my best to help you.

SDK Sample: Changing the runtime version of an application pool in IIS 7

TobinTitus — Thu, 29 Jun 2006 03:03:00 GMT

The following quick SDK sample demonstrates how to list and change the managed runtime version of application pools programatically in IIS 7.

[VB]

Imports System
Imports Microsoft.Web.Administration

Public Class AppPoolSample
    Shared manager As ServerManager = New ServerManager()

    ' Main application processing
    Public Shared Sub Main(ByVal args As String())
        ' Get the apppool to change
        Dim iPool As Integer = GetAppPool()

        ' Get the framework version desired
        Dim rtVersion As String = GetVersion()

        ' Set the apppool runtime
        Dim poolToSet As ApplicationPool = manager.ApplicationPools(iPool)

        Console.WriteLine("Setting application pool '{0}' to runtime version: {1}...", _
            poolToSet.Name, rtVersion)
        poolToSet.ManagedRuntimeVersion = rtVersion

        ' Commit the changes and recycle the application pool
        manager.CommitChanges()
        poolToSet.Recycle()

        Console.WriteLine("Your changes have been committed.")
    End Sub

    ' Prompts the user to select an application pool
    Public Shared Function GetAppPool() As Integer

        Dim pool As String = String.Empty
        Dim iPool As Integer = 0

        While (Not Integer.TryParse(pool, iPool))
            Console.WriteLine("Available ApplicationPools: Managed runtime version")
            Dim i As Integer
            For i = 0 To manager.ApplicationPools.Count - 1 Step i + 1
                Dim appPool As ApplicationPool = manager.ApplicationPools(i)
                Console.WriteLine("{3}{0,3}.{3}{1}: {2}", i + 1, _
                    appPool.Name, appPool.ManagedRuntimeVersion, vbTab)
            Next
            Console.Write("{0}Choose an application pool to change: ", vbCrLf)
            pool = Console.ReadLine()
        End While
        Return iPool - 1
    End Function

    ' Prompts a user to select the version of runtime they would like
    ' the application pool to use
    Public Shared Function GetVersion() As String
        Dim rtVersion As String = String.Empty
        Dim iVersion As Integer = 0

        While (Not Integer.TryParse(rtVersion, iVersion))
            Console.WriteLine("{0}  1.{0}Framework version 1.0", vbTab)
            Console.WriteLine("{0}  2.{0}Framework version 1.1", vbTab)
            Console.WriteLine("{0}  3.{0}Framework version 2.0", vbTab)
            Console.Write("Choose the new managed runtime version: ")
            rtVersion = Console.ReadLine()
        End While

        Select Case iVersion
            Case 1
                rtVersion = "v1.0"
            Case 2
                rtVersion = "v1.1"
            Case 3
                rtVersion = "v2.0"
        End Select

        Return rtVersion
    End Function
End Class

[C#

using System;
using Microsoft.Web.Administration;

public class AppPoolSample 
{
    static ServerManager manager = new ServerManager();
    
    // Main application processing
    public static void Main(string[] args)  
    {
        // Get the apppool to change
        int iPool = GetAppPool();

        // Get the framework version desired
        string rtVersion = GetVersion();

        // Set the apppool runtime
        ApplicationPool poolToSet = manager.ApplicationPools[iPool];

        Console.WriteLine("Setting application pool '{0}' to runtime version: {1}...",
            poolToSet.Name, rtVersion);
        poolToSet.ManagedRuntimeVersion = rtVersion;

        // Commit the changes and recycle the application pool
        manager.CommitChanges();
        poolToSet.Recycle();

        Console.WriteLine("Your changes have been committed.");
    }

    // Prompts the user to select an application pool
    public static int GetAppPool()
    {
        string pool = String.Empty;
        int iPool = 0;

        while ((!int.TryParse(pool, out iPool)) ||
                (iPool > manager.ApplicationPools.Count || iPool <= 0))
        {
            Console.WriteLine("Available ApplicationPools: Managed runtime version");
            for (int i = 0; i <= manager.ApplicationPools.Count - 1; i++)
            {
                ApplicationPool appPool = manager.ApplicationPools[i];
                Console.WriteLine("\t{0,3}.\t{1}: {2}", i + 1, 
                    appPool.Name, appPool.ManagedRuntimeVersion);
            }
            Console.Write("\r\nChoose an application pool to change: ");
            pool = Console.ReadLine();
        }
        return iPool -1;
    }

    // Prompts a user to select the version of runtime they would like
    // the application pool to use
    public static string GetVersion()
    {
        string rtVersion = String.Empty;
        int iVersion = 0;

        while ((!int.TryParse(rtVersion, out iVersion)) ||
                (iVersion > 3 || iVersion < 1))
        {
            Console.WriteLine("\r\n\t   1.\tFramework version 1.0");
            Console.WriteLine("\t   2.\tFramework version 1.1");
            Console.WriteLine("\t   3.\tFramework version 2.0");
            Console.Write("Choose the new managed runtime version: ");
            rtVersion = Console.ReadLine();
        }

        switch (iVersion)
        {
            case 1:
                rtVersion  = "v1.0";
                break;
            case 2:
                rtVersion = "v1.1";
                break;
            case 3:
                rtVersion = "v2.0";
                break;
        }

        return rtVersion;
    }
}