Change logging settings

Author: PaulStovell

examples/09-ChangeLogging/IIS.ps1

@@ -0,0 +1,43 @@
+# -----------------------------------------------------------------------------
+# Setup
+# -----------------------------------------------------------------------------
+$here = Split-Path -Parent $MyInvocation.MyCommand.Path
+cd $here
+
+. ..\_Setup.IIS.ps1
+
+mkdir "C:\Sites\Website1" -ErrorAction SilentlyContinue
+mkdir "C:\Sites\Logs" -ErrorAction SilentlyContinue
+
+$manager = Get-IISServerManager
+$manager.Sites.Add("Website1", "http", "*:8022:", "C:\Sites\Website1")
+$manager.CommitChanges()
+
+# -----------------------------------------------------------------------------
+# Example
+# -----------------------------------------------------------------------------
+Import-Module IISAdministration
+
+$manager = Get-IISServerManager
+
+$site = $manager.Sites["Website1"]
+$logFile = $site.LogFile
+$logFile.LogFormat = "W3c"               # Formats:   W3c, Iis, Ncsa, Custom
+$logFile.Directory = "C:\Sites\Logs"     
+$logFile.Enabled = $true
+$logFile.Period = "Daily"
+
+$manager.CommitChanges()
+
+# -----------------------------------------------------------------------------
+# Assert
+# -----------------------------------------------------------------------------
+if ($manager.Sites["Website1"].LogFile.Directory -ne "C:\Sites\Logs") { Write-Error "Our logic is wrong" }
+
+# -----------------------------------------------------------------------------
+# Clean up
+# -----------------------------------------------------------------------------
+
+. ..\_Teardown.IIS.ps1
+
+Remove-IISSite -Name "Website1" -Confirm:$false

examples/09-ChangeLogging/README.md

@@ -0,0 +1,22 @@
+### Changing logging settings
+
+HTTP request logging is provided by IIS and can be specified server-wide or on an individual site level. Applications and virtual directories can disable logging, but they can't do any logging of their own. The examples below show how to set logging at the site level. 
+
+Logging settings are stored in `applicationHost.config` underneath the site:
+
+```xml
+<system.applicationHost>
+    <!-- ... -->
+    <sites>
+        <site name="Default Web Site" id="1">
+            <bindings>
+                <binding protocol="http" bindingInformation="*:80:" />
+            </bindings>
+            <logFile logFormat="IIS" directory="%SystemDrive%\inetpub\logs\LogFiles1" period="Hourly" />
+        </site>
+        <siteDefaults>
+            <logFile logFormat="W3C" directory="%SystemDrive%\inetpub\logs\LogFiles" />
+            <traceFailedRequestsLogging directory="%SystemDrive%\inetpub\logs\FailedReqLogFiles" />
+        </siteDefaults>
+        <!-- ... -->
+```

examples/09-ChangeLogging/Web.ps1

@@ -0,0 +1,41 @@
+# -----------------------------------------------------------------------------
+# Setup
+# -----------------------------------------------------------------------------
+$here = Split-Path -Parent $MyInvocation.MyCommand.Path
+cd $here
+
+. ..\_Setup.Web.ps1
+
+mkdir "C:\Sites\Website1" -ErrorAction SilentlyContinue
+mkdir "C:\Sites\Logs" -ErrorAction SilentlyContinue
+
+New-Website -Name "Website1" -Port 80 -IPAddress "*" -HostHeader "" -PhysicalPath "C:\Sites\Website1"
+
+# -----------------------------------------------------------------------------
+# Example
+# -----------------------------------------------------------------------------
+
+Import-Module WebAdministration
+
+$settings = @{ `
+    logFormat="W3c";                `   # Formats:   W3c, Iis, Ncsa, Custom
+    enabled=$true;                  `
+    directory="C:\Sites\Logs";      `
+    period="Daily";                 `
+}
+
+Set-ItemProperty "IIS:\Sites\Website1" -name "logFile" -value $settings
+
+# -----------------------------------------------------------------------------
+# Assert
+# -----------------------------------------------------------------------------
+
+if ((Get-ItemProperty "IIS:\Sites\Website1" -name "logFile.directory") -ne "C:\Sites\Logs") { Write-Error "Our logic is wrong" }
+
+# -----------------------------------------------------------------------------
+# Clean up
+# -----------------------------------------------------------------------------
+
+. ..\_Teardown.Web.ps1
+
+Remove-Item -Path "IIS:\Sites\Website1" -Recurse -Force