Add example for changing physical paths

Author: PaulStovell

examples/07-ChangePaths/IIS.ps1

@@ -0,0 +1,53 @@
+# -----------------------------------------------------------------------------
+# Setup
+# -----------------------------------------------------------------------------
+$here = Split-Path -Parent $MyInvocation.MyCommand.Path
+cd $here
+
+. ..\_Setup.IIS.ps1
+
+mkdir "C:\Sites\Website1" -ErrorAction SilentlyContinue
+mkdir "C:\Sites\Website1\1.0" -ErrorAction SilentlyContinue
+mkdir "C:\Sites\Website1\1.1" -ErrorAction SilentlyContinue
+
+$manager = Get-IISServerManager
+$manager.ApplicationPools.Add("My Pool")
+$manager.Sites.Add("Website1", "http", "*:8022:", "C:\Sites\Website1")
+$manager.Sites["Website1"].Applications.Add("/MyApp", "C:\Sites\MyApp")
+$manager.CommitChanges()
+
+# -----------------------------------------------------------------------------
+# Example
+# -----------------------------------------------------------------------------
+Import-Module IISAdministration
+
+$manager = Get-IISServerManager
+
+# Remember, in the IIS Administration view of the world, sites contain 
+# applications, and applications contain virtual directories, and it is 
+# virtual directories that point at a physical path on disk. 
+
+# Change for a top-level website
+$manager.Sites["Website1"].Applications["/"].VirtualDirectories["/"].PhysicalPath = "C:\Sites\Website1\1.1"
+
+# Change for an app within a website
+$manager.Sites["Website1"].Applications["/MyApp"].VirtualDirectories["/"].PhysicalPath = "C:\Sites\Website1\1.1"
+
+$manager.CommitChanges()
+
+# -----------------------------------------------------------------------------
+# Assert
+# -----------------------------------------------------------------------------
+if ($manager.Sites["Website1"].Applications["/"].VirtualDirectories["/"].PhysicalPath -ne "C:\Sites\Website1\1.1") { Write-Error "Our logic is wrong" }
+
+# -----------------------------------------------------------------------------
+# Clean up
+# -----------------------------------------------------------------------------
+
+. ..\_Teardown.IIS.ps1
+
+Remove-IISSite -Name "Website1" -Confirm:$false
+
+$manager = Get-IISServerManager
+$manager.ApplicationPools["My Pool"].Delete()
+$manager.CommitChanges()

examples/07-ChangePaths/README.md

@@ -0,0 +1,20 @@
+### Change physical path of a site or application
+
+When deploying a new version of an application, my preference (and the way Octopus Deploy works) is to deploy to a fresh, new folder on disk, then update IIS to point to it. So you begin with:
+
+    C:\Sites\Website1\1.0   <--- IIS points here
+
+You deploy the new version:
+
+    C:\Sites\Website1\1.0   <--- IIS points here
+    C:\Sites\Website1\1.1
+
+You can then make any necessary changes to configuration files, etc. and then update IIS to point to it:
+
+    C:\Sites\Website1\1.0
+    C:\Sites\Website1\1.1   <--- Now IIS points here
+
+Should you ever need to roll back in a hurry, you can leave the old folder on disk and point back to it:
+
+    C:\Sites\Website1\1.0   <--- IIS points here (we rolled back manually)
+    C:\Sites\Website1\1.1   

examples/07-ChangePaths/Web.ps1

@@ -0,0 +1,42 @@
+# -----------------------------------------------------------------------------
+# Setup
+# -----------------------------------------------------------------------------
+$here = Split-Path -Parent $MyInvocation.MyCommand.Path
+cd $here
+
+. ..\_Setup.Web.ps1
+
+mkdir "C:\Sites\Website1" -ErrorAction SilentlyContinue
+mkdir "C:\Sites\Website1\1.0" -ErrorAction SilentlyContinue
+mkdir "C:\Sites\Website1\1.1" -ErrorAction SilentlyContinue
+mkdir "C:\Sites\MyApp" -ErrorAction SilentlyContinue
+
+New-Item -Path "IIS:\AppPools" -Name "My Pool" -Type AppPool
+New-Website -Name "Website1" -Port 80 -IPAddress "*" -HostHeader "" -PhysicalPath "C:\Sites\Website1"
+New-Item -Type Application -Path "IIS:\Sites\Website1\MyApp" -physicalPath "C:\Sites\MyApp"
+
+# -----------------------------------------------------------------------------
+# Example
+# -----------------------------------------------------------------------------
+
+Import-Module WebAdministration
+
+# The pattern here is to use Test-Path with the IIS:\ drive provider
+
+Set-ItemProperty -Path "IIS:\Sites\Website1" -name "physicalPath" -value "C:\Sites\Website1\1.1"
+Set-ItemProperty -Path "IIS:\Sites\Website1\MyApp" -name "physicalPath" -value "C:\Sites\Website1\1.1"
+
+# -----------------------------------------------------------------------------
+# Assert
+# -----------------------------------------------------------------------------
+
+if ((Get-ItemProperty -Path "IIS:\Sites\Website1" -name "physicalPath") -ne "C:\Sites\Website1\1.1") { Write-Error "Our logic is wrong" }
+
+# -----------------------------------------------------------------------------
+# Clean up
+# -----------------------------------------------------------------------------
+
+. ..\_Teardown.Web.ps1
+
+Remove-Item -Path "IIS:\Sites\Website1" -Recurse -Force
+Remove-Item -Path "IIS:\AppPools\My Pool" -Recurse -Force