Core/WebAdministration-Module.psm1
|
$ErrorActionPreference = "Stop" function EnableIISAdministration { $operatingSystem = (Get-WmiObject win32_operatingsystem).Caption if (($operatingSystem -like '*server*') -or ($operatingSystem -like '*Server*')) { if (!(Get-WindowsFeature "Web-Server").Installed) { Install-WindowsFeature -Name "Web-Server" | Out-Null } } else { if ((Get-WindowsOptionalFeature -FeatureName "IIS-WebServer" -Online).State -ne "Enabled") { Enable-WindowsOptionalFeature -FeatureName "IIS-WebServer" -Online -All | Out-Null } } Get-Module -Name WebAdministration | Remove-Module -Force Import-Module -Name WebAdministration } function IISReset { [CmdletBinding(SupportsShouldProcess = $true)] Param ( [string]$Reason, [int]$TryNumber = 0, [switch]$Force ) if (($Force.IsPresent) -or ($PSCmdlet.ShouldProcess("IIS", $Reason))) { Write-Output "Running IIS Reset..." $process = Start-Process "iisreset.exe" -NoNewWindow -Wait -PassThru if (($process.ExitCode -gt 0) -and ($TryNumber -lt 3) ) { Write-Warning "IIS Reset failed. Retrying..." $newTryNumber = $TryNumber + 1 IISReset -Reason $Reason -TryNumber $newTryNumber -Force } } } function AddConnectionString { [CmdletBinding()] Param ( [string]$SqlServer, [string]$Database, [string]$Username, [string]$Password, [string]$WebsiteRootDir, [string]$ConnStringName ) Write-Output "Adding a new connection string with name '$ConnStringName'..." $connStrFile = Join-Path -Path $WebsiteRootDir -ChildPath "\App_Config\ConnectionStrings.config" $connStr = "Data Source=$SqlServer;Initial Catalog=$Database;User ID=$Username;Password=$Password" $xmlDoc = [System.Xml.XmlDocument](Get-Content $connStrFile) $newConnStrElement = $xmlDoc.CreateElement("add") $newConnStr = $xmlDoc.connectionStrings.AppendChild($newConnStrElement) $newConnStr.SetAttribute("name", $ConnStringName) $newConnStr.SetAttribute("connectionString", $connStr) $xmlDoc.Save($connStrFile) Write-Output "Adding a new connection string with name '$ConnStringName' done" } function AddAppPoolUserToGroups { [CmdletBinding()] Param ( [string[]]$AppPools, [string[]]$Groups ) $needIISReset = $false foreach ($gr in $Groups) { $objSID = New-Object System.Security.Principal.SecurityIdentifier($gr) $objgroup = $objSID.Translate( [System.Security.Principal.NTAccount]) $objgroupname = ($objgroup.Value).Split("\")[1] $group = [ADSI]"WinNT://$Env:ComputerName/$objgroupname,group" $members = $group.psbase.invoke("Members") | ForEach-Object { $_.GetType().InvokeMember("Name", 'GetProperty', $null, $_, $null) } foreach ($pool in $AppPools) { if ($members -contains $pool) { Write-Output "'$pool' AppPool user exists in '$objgroupname' group" } else { Write-Output "Adding '$pool' AppPool user to '$objgroupname' group..." $ntAccount = New-Object System.Security.Principal.NTAccount("IIS APPPOOL\$pool") $strSID = $ntAccount.Translate([System.Security.Principal.SecurityIdentifier]) $user = [ADSI]"WinNT://$strSID" $group.Add($user.Path) $needIISReset = $true Write-Output "Adding '$pool' AppPool user to '$objgroupname' group done." } } } if ($needIISReset -eq $true) { IISReset -Reason "Groups changes will take effect after IIS Reset. Do it now?" -Confirm } } function HostFileContainsEntry { [CmdletBinding()] Param( [string]$HostName ) $file = Join-Path -Path $($env:windir) -ChildPath "system32\drivers\etc\hosts" if (!(Test-Path -Path $file)) { Throw "Hosts file not found." } $content = Get-Content $file foreach ($line in $content) { if (!$line.StartsWith("#") -and $line -ne "") { if ($line.Contains($HostName)) { return $true } } } return $false } function AddHostFileEntry { [CmdletBinding()] Param( [string]$IP, [string]$HostName ) $file = Join-Path -Path $($env:windir) -ChildPath "system32\drivers\etc\hosts" if (!(Test-Path -Path $file)) { Throw "Hosts file not found." } if (HostFileContainsEntry -HostName $HostName) { Write-Output "Hosts file contains entry for '$HostName'. Skipping add entry..." } else { Write-Output "Adding entry to hosts file: '$IP $HostName'..." [System.IO.File]::AppendAllText($file, "`r`n$IP`t$HostName") } } function CreateBindingWithThumprint { [CmdletBinding()] Param ( [string]$SiteName, [string]$HostName, [string]$SSLCert ) $params = @{ Path = "$PSScriptRoot\CreateBindingWithThumprint.json" SiteName = $SiteName HostName = $HostName SSLCert = $SSLCert } Install-SitecoreConfiguration @params } function AddWebBindings { [CmdletBinding()] Param ( [string]$SiteName, [string[]]$HostNames, [string]$SSLCert ) Write-Output "Adding Web Bindings started..." foreach ($host in $HostNames) { $protocol = "http" $port = 80 if (![string]::IsNullOrEmpty($SSLCert)) { $protocol = "https" $port = 443 } $binding = Get-WebBinding -Name $SiteName -IPAddress "*" -Protocol $protocol -Port $port -HostHeader $host if ($null -eq $binding) { Write-Output "Adding $protocol Web Binding to $SiteName for $host..." if ($protocol -eq "https") { CreateBindingWithThumprint -SiteName $SiteName -HostName $host -SSLCert $SSLCert } else { New-WebBinding -Name $SiteName -IPAddress "*" -Protocol $protocol -Port $port -HostHeader $host } AddHostFileEntry -IP "127.0.0.1" -HostName $host } else { Write-Output "$protocol Web Binding on $SiteName for $host exists. Skipping add..." } } } function DeleteIISWebsite { [CmdletBinding()] Param ( [string]$SiteName ) Write-Output "Deleting IIS Website '$SiteName'..." if (Test-Path "IIS:\Sites\$SiteName") { Remove-Website -Name $SiteName Write-Output "'$SiteName' website deleted." } else { Write-Output "Could not find website '$SiteName'." } } function DeleteIISAppPool { [CmdletBinding()] Param ( [string]$AppPoolName ) Write-Output "Deleting IIS AppPool '$AppPoolName'..." if (Test-Path "IIS:\AppPools\$AppPoolName") { Remove-WebAppPool -Name $AppPoolName Write-Output "'$AppPoolName' IIS AppPool deleted." } else { Write-Output -Message "Could not find IIS AppPool '$AppPoolName'." } } function RestartAppPool { [CmdletBinding()] Param ( [string]$AppPoolName ) Write-Output "Restarting IIS AppPool '$AppPoolName'..." Restart-WebAppPool $AppPoolName Write-Output "Done." } function RenameWebsiteAndAppPool { [CmdletBinding()] Param ( [string]$OldName, [string]$NewName ) Write-Output "Renaming AppPool and Site..." if (!(Test-Path "IIS:\Sites\$OldName")) { throw "There is no IIS Site with name '$OldName'" } $site = "IIS:\Sites\$OldName" $appPool = "IIS:\AppPools\$OldName" if (!(Test-Path IIS:\AppPools\SAFTempPool)) { New-WebAppPool "SAFTempPool" } Set-ItemProperty $site applicationPool -Value "SAFTempPool" Set-ItemProperty $appPool -Name name -Value $NewName Set-ItemProperty $site applicationPool -Value $NewName Remove-WebAppPool -Name "SAFTempPool" Rename-Item $site $NewName Write-Output "Done." } Export-ModuleMember -Function "EnableIISAdministration" Export-ModuleMember -Function "AddWebBindings" Export-ModuleMember -Function "AddHostFileEntry" Export-ModuleMember -Function "AddAppPoolUserToGroups" Export-ModuleMember -Function "AddConnectionString" Export-ModuleMember -Function "IISReset" Export-ModuleMember -Function "DeleteIISWebsite" Export-ModuleMember -Function "DeleteIISAppPool" Export-ModuleMember -Function "RestartAppPool" Export-ModuleMember -Function "RenameWebsiteAndAppPool" |