Public/AppPools.ps1
|
function Get-IISMAppPool { [CmdletBinding()] param ( [Parameter()] [string] $Name ) if (![string]::IsNullOrWhiteSpace($Name)) { $result = Invoke-IISMAppCommand -Arguments "list apppool '$($Name)'" -NoError } else { $result = Invoke-IISMAppCommand -Arguments 'list apppools' -NoError } if ($null -eq $result.APPPOOL) { return $null } return (ConvertTo-IISMAppPoolObject -AppPools $result.APPPOOL) } function Get-IISMAppPools { [CmdletBinding()] param ( [Parameter()] [string[]] $Names ) return @(foreach ($name in $Names) { Get-IISMAppPool -Name $name }) } function Test-IISMAppPool { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name ) return ($null -ne (Get-IISMAppPool -Name $Name)) } function Test-IISMAppPoolRunning { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name ) return ((Get-IISMAppPool -Name $Name).State -ieq 'started') } function Stop-IISMAppPool { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name ) if (!(Test-IISMAppPoolRunning -Name $Name)) { return } Invoke-IISMAppCommand -Arguments "stop apppool '$($Name)'" -NoParse | Out-Null return (Get-IISMAppPool -Name $Name) } function Start-IISMAppPool { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name ) if (Test-IISMAppPoolRunning -Name $Name) { return } Invoke-IISMAppCommand -Arguments "start apppool '$($Name)'" -NoParse | Out-Null return (Get-IISMAppPool -Name $Name) } function Restart-IISMAppPool { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name ) Stop-IISMAppPool -Name $Name | Out-Null Start-IISMAppPool -Name $Name | Out-Null return (Get-IISMAppPool -Name $Name) } function Reset-IISMAppPool { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name ) if (!(Test-IISMAppPoolRunning -Name $Name)) { return } Invoke-IISMAppCommand -Arguments "recycle apppool '$($Name)'" -NoParse | Out-Null return (Get-IISMAppPool -Name $Name) } function Remove-IISMAppPool { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name ) if (!(Test-IISMAppPool -Name $Name)) { return } Invoke-IISMAppCommand -Arguments "delete apppool '$($Name)'" -NoParse | Out-Null return (Get-IISMAppPool) } function New-IISMAppPool { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name, [Parameter()] [ValidateSet('2.0', '4.0')] [string] $RuntimeVersion = '4.0', [Parameter()] [ValidateSet('Classic', 'Integrated')] [string] $PipelineMode = 'Integrated', [switch] $Enable32Bit ) # error if app-pool already exists if (Test-IISMAppPool -Name $Name) { throw "Application Pool '$($Name)' already exists in IIS" } # create the app-pool $_args = "/name:'$($Name)' /managedRuntimeVersion:v$($RuntimeVersion) /managedPipelineMode:$($PipelineMode) /enable32BitAppOnWin64:$($Enable32Bit)" Invoke-IISMAppCommand -Arguments "add apppool $($_args)" -NoParse | Out-Null Wait-IISMBackgroundTask -ScriptBlock { Test-IISMAppPool -Name $Name } # return the app-pool return (Get-IISMAppPool -Name $Name) } function Update-IISMAppPool { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name, [Parameter()] [ValidateSet('', '2.0', '4.0')] [string] $RuntimeVersion = '', [Parameter()] [ValidateSet('', 'Classic', 'Integrated')] [string] $PipelineMode = '', [Parameter()] [int] $QueueLength = 0 ) # error if the app-pool doesn't exist if (!(Test-IISMAppPool -Name $Name)) { throw "Application Pool '$($Name)' does not exist in IIS" } # update the runtime if (![string]::IsNullOrWhiteSpace($RuntimeVersion)) { Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /managedRuntimeVersion:v$($RuntimeVersion)" -NoParse | Out-Null } # update the pipeline mode if (![string]::IsNullOrWhiteSpace($PipelineMode)) { Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /managedPipelineMode:$($PipelineMode)" -NoParse | Out-Null } # update the queue length if ($QueueLength -gt 0) { Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /queueLength:$($QueueLength)" -NoParse | Out-Null } # return the app-pool return (Get-IISMAppPool -Name $Name) } function Update-IISMAppPoolProcessModel { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name, [Parameter()] [ValidateSet('', 'ApplicationPoolIdentity', 'LocalService', 'LocalSystem', 'NetworkService', 'SpecificUser')] [string] $IdentifyType = '', [Parameter()] [pscredential] $Credentials, [Parameter()] [int] $IdleTimeOut = -1, [Parameter()] [ValidateSet('', 'Terminate', 'Suspend')] [string] $IdleTimeOutAction = '', [Parameter()] [int] $WorkerProcesses = -1 ) # error if the app-pool doesn't exist if (!(Test-IISMAppPool -Name $Name)) { throw "Application Pool '$($Name)' does not exist in IIS" } # set the idle timeout if ($IdleTimeOut -ge 0) { $strTimeout = [timespan]::FromMinutes($IdleTimeOut).ToString() Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /processModel.idleTimeout:$($strTimeout)" -NoParse | Out-Null } # set the idle timeout action if (![string]::IsNullOrWhiteSpace($IdleTimeOutAction)) { Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /processModel.idleTimeoutAction:$($IdleTimeOutAction)" -NoParse | Out-Null } # set the max worker processes if ($WorkerProcesses -ge 0) { Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /processModel.maxProcesses:$($WorkerProcesses)" -NoParse | Out-Null } # set the user identity if (![string]::IsNullOrWhiteSpace($IdentifyType)) { $_args = "/processModel.identityType:$($IdentifyType)" # setup as specific user with creds if ($IdentifyType -ieq 'SpecificUser') { if ($null -eq $Credentials) { throw "No credentials supplied when attempting to set the '$($Name)' application pool to run as SpecificUser" } $creds = Get-IISMCredentialDetails -Credentials $Credentials $_args += " /processModel.userName:$($creds.username) /processModel.password:$($creds.password)" } Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' $($_args)" -NoParse | Out-Null } # return the app-pool return (Get-IISMAppPool -Name $Name) } function Update-IISMAppPoolRecycling { [CmdletBinding()] param ( [Parameter(Mandatory=$true)] [string] $Name, [Parameter()] [int] $RecycleInterval = -1, [Parameter()] [timespan[]] $RecycleTimes = $null ) # error if the app-pool doesn't exist if (!(Test-IISMAppPool -Name $Name)) { throw "Application Pool '$($Name)' does not exist in IIS" } # set a recycle interval if ($RecycleInterval -ge 0) { $strInterval = [timespan]::FromMinutes($RecycleInterval).ToString() Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /recycling.periodicRestart.time:$($strInterval)" -NoParse | Out-Null } # set recycling times if (($RecycleTimes | Measure-Object).Count -gt 0) { # remove all current times Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /-recycling.periodicRestart.schedule" -NoParse | Out-Null # add the new times foreach ($time in @($RecycleTimes)) { Invoke-IISMAppCommand -Arguments "set apppool '$($Name)' /+`"recycling.periodicRestart.schedule.[value='$($time.ToString())']`"" -NoParse | Out-Null } } # return the app-pool return (Get-IISMAppPool -Name $Name) } |