Saritasa.WebDeploy.psm1
|
$msdeployPath = "$env:ProgramFiles\IIS\Microsoft Web Deploy V3" $msdeployPort = 8172 $credential = '' <# .SYNOPSIS Configure Web Deploy default settings. .PARAMETER Credential Credentials to be used for authorization. .PARAMETER MsdeployPath Provide to override folder location of Microsoft Web Deploy utility. .PARAMETER MsdeployPort Provide to override default MS Deploy port. .NOTES Leave -Credential empty for NTLM. For NTLM support execute on server: Set-ItemProperty HKLM:Software\Microsoft\WebManagement\Server WindowsAuthenticationEnabled 1 Restart-Service WMSVC https://blogs.msdn.microsoft.com/carlosag/2011/12/13/using-windows-authentication-with-web-deploy-and-wmsvc/ #> function Initialize-WebDeploy { [CmdletBinding()] param ( [System.Management.Automation.PSCredential] [System.Management.Automation.Credential()] $Credential, [string] $MsdeployPath, [int] $MsdeployPort ) Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState $script:credential = '' if ($Credential) { $username = $Credential.UserName $password = $Credential.GetNetworkCredential().Password $script:credential = "userName=$username,password=$password,authType=basic" } else { $script:credential = "authType='ntlm'" } if ($MsdeployPath) { $script:msdeployPath = $MsdeployPath } if ($MsdeployPort) { $script:msdeployPort = $MsdeployPort } } <# .SYNOPSIS Checks if Web Deploy credentials are set. #> function Assert-WebDeployCredential() { if (!$credential) { throw 'Credentials are not set.' } } <# .SYNOPSIS Package a project. .PARAMETER ProjectPath Path to project file. .PARAMETER PackagePath Path to where the resulting package should be saved. .PARAMETER Configuration Target build configuration. .PARAMETER Platform Target build platform. .PARAMETER Precompile Whether or not project should be precompiled before packaging. .PARAMETER BuildParams Any additional parameters to be passed to MSBuild utility. .EXAMPLE Invoke-PackageBuild src/WebApp.csproj WebApp.zip -BuildParams ('/p:AspnetMergePath="C:\Program Files (x86)\Microsoft SDKs\Windows\v8.1A\bin\NETFX 4.5.1 Tools"') #> function Invoke-PackageBuild { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $ProjectPath, [Parameter(Mandatory = $true)] [string] $PackagePath, [string] $Configuration = 'Release', [string] $Platform = 'AnyCPU', [bool] $Precompile = $true, [string[]] $BuildParams ) Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState $basicBuildParams = ('/m', '/t:Package', "/p:Configuration=$Configuration", '/p:IncludeSetAclProviderOnDestination=False', "/p:PrecompileBeforePublish=$Precompile", "/p:Platform=$Platform", "/p:PackageLocation=$PackagePath") msbuild.exe $ProjectPath $basicBuildParams $BuildParams if ($LASTEXITCODE) { throw 'Package build failed.' } } <# .SYNOPSIS Starts the application pool for specified application on a remote machine. .PARAMETER ServerHost Hostname of target machine. .PARAMETER SiteName Web site name. .PARAMETER Application Application name. .NOTES The recycleApp provider should be delegated to WDeployAdmin. #> function Start-AppPool { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $ServerHost, [Parameter(Mandatory = $true)] [string] $SiteName, [Parameter(Mandatory = $true)] [string] $Application ) Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState Assert-WebDeployCredential Write-Information 'Starting app pool...' $computerName, $useTempAgent = GetComputerName $ServerHost $SiteName $destArg = "-dest:recycleApp='$SiteName/$Application',recycleMode='StartAppPool'," + "computerName='$computerName',tempAgent='$useTempAgent',$credential" $args = @('-verb:sync', '-source:recycleApp', $destArg) $result = Start-Process -NoNewWindow -Wait -PassThru "$msdeployPath\msdeploy.exe" $args if ($result.ExitCode) { throw 'Msdeploy failed.' } } <# .SYNOPSIS Stops the application pool for specified application on a remote machine. .PARAMETER ServerHost Hostname of target machine. .PARAMETER SiteName Web site name. .PARAMETER Application Application name. .NOTES The recycleApp provider should be delegated to WDeployAdmin. #> function Stop-AppPool { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $ServerHost, [Parameter(Mandatory = $true)] [string] $SiteName, [Parameter(Mandatory = $true)] [string] $Application ) Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState Assert-WebDeployCredential Write-Information 'Stopping app pool...' $computerName, $useTempAgent = GetComputerName $ServerHost $SiteName $destArg = "-dest:recycleApp='$SiteName/$Application',recycleMode='StopAppPool'," + "computerName='$computerName',tempAgent='$useTempAgent',$credential" $args = @('-verb:sync', '-source:recycleApp', $destArg) $result = Start-Process -NoNewWindow -Wait -PassThru "$msdeployPath\msdeploy.exe" $args if ($result.ExitCode) { throw 'Msdeploy failed.' } } <# .SYNOPSIS Get a MSDeploy URL by host name. .PARAMETER ServerHost Hostname of target machine. .PARAMETER SiteName Web site name. .OUTPUTS computerName, useTempAgent #> function GetComputerName([string] $ServerHost, [string] $SiteName) { $computerName = $null $useAgent = $false $useTempAgent = $false if (Test-IsLocalhost $ServerHost) # Local server. { # Check if Web Deployment Agent Service exists. $agentService = Get-Service MsDepSvc -ErrorAction SilentlyContinue if ($agentService) { $useAgent = $true } elseif (Test-Path "$env:ProgramFiles\IIS\Microsoft Web Deploy\MsDepSvc.exe") { # Temp agent is available. $useAgent = $true $useTempAgent = $true } } if ($useAgent) # Local server, Agent Service available. { $computerName = 'localhost' } else # Remote server, use Web Management Service. { $computerName = "https://${ServerHost}:$msdeployPort/msdeploy.axd?site=$SiteName" } $computerName $useTempAgent } <# .SYNOPSIS Invokes a web deployment process. .PARAMETER PackagePath Path to package to be deployed. To generate the package the Invoke-PackageBuild command can be used. .PARAMETER ServerHost Hostname of target machine. .PARAMETER SiteName Web site name. .PARAMETER Application Application name. .PARAMETER AllowUntrusted When specified, untrusted SSL connections are allowed. Otherwise, untrusted SSL connections are not allowed. .PARAMETER MSDeployParams Any additional parameters to be passed to MSDeploy utility. #> function Invoke-WebDeployment { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $PackagePath, [Parameter(Mandatory = $true)] [string] $ServerHost, [Parameter(Mandatory = $true)] [string] $SiteName, [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $Application, [switch] $AllowUntrusted, [string[]] $MSDeployParams ) Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState Assert-WebDeployCredential Write-Information "Deploying $PackagePath to $ServerHost/$Application..." $computerName, $useTempAgent = GetComputerName $ServerHost $SiteName $args = @("-source:package='$PackagePath'", "-dest:auto,computerName='$computerName',tempAgent='$useTempAgent',includeAcls='False',$credential", '-verb:sync', '-disableLink:AppPoolExtension', '-disableLink:ContentExtension', '-disableLink:CertificateExtension', "-setParam:name='IIS Web Application Name',value='$SiteName/$Application'") if ($AllowUntrusted) { $args += '-allowUntrusted' } if ($MSDeployParams) { $args += $MSDeployParams } $result = Start-Process -NoNewWindow -Wait -PassThru "$msdeployPath\msdeploy.exe" $args if ($result.ExitCode) { throw 'Msdeploy failed.' } } <# .SYNOPSIS Copies IIS app content from local server to remote server. .PARAMETER SiteName Web site name. .PARAMETER Application Application name. .PARAMETER ServerHost Hostname of target machine. #> function Sync-IisApp { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $SiteName, [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $Application, [Parameter(Mandatory = $true)] [Alias("DestinationServer")] [string] $ServerHost ) Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState Assert-WebDeployCredential $computerName, $useTempAgent = GetComputerName $ServerHost $SiteName $args = @('-verb:sync', "-source:iisApp='$SiteName/$Application'", "-dest:auto,computerName='$computerName',tempAgent='$useTempAgent',$credential") $result = Start-Process -NoNewWindow -Wait -PassThru "$msdeployPath\msdeploy.exe" $args if ($result.ExitCode) { throw 'Msdeploy failed.' } Write-Information "Updated '$SiteName/$Application' app on $ServerHost server." } <# .SYNOPSIS Synchronizes web site file structure between local and remote servers. .PARAMETER ContentPath Folder path on local machine to be synchronized. .PARAMETER ServerHost Hostname of target machine. .PARAMETER SiteName Web site name. .PARAMETER AutoDestination If set, the destination will be specified automatically. .PARAMETER Application Application name. #> function Sync-WebContent { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $ContentPath, [Parameter(Mandatory = $true)] [Alias("DestinationServer")] [string] $ServerHost, [Parameter(Mandatory = $true)] [string] $SiteName, [Parameter(Mandatory = $true, ParameterSetName = 'IIS')] [AllowEmptyString()] [string] $Application, [Parameter(Mandatory = $true, ParameterSetName = 'FileSystem')] [switch] $AutoDestination, [switch] $AllowUntrusted, [string[]] $MSDeployParams ) Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState Assert-WebDeployCredential $destinationParam = $null if ($AutoDestination) { $destinationParam = '-dest:auto' } else { $destinationParam = "-dest:contentPath='$SiteName/$Application'" } $computerName, $useTempAgent = GetComputerName $ServerHost $SiteName $args = @('-verb:sync', "-source:contentPath='$ContentPath'", "$destinationParam,computerName='$computerName',tempAgent='$useTempAgent',$credential") if ($AllowUntrusted) { $args += '-allowUntrusted' } if ($MSDeployParams) { $args += $MSDeployParams } $result = Start-Process -NoNewWindow -Wait -PassThru "$msdeployPath\msdeploy.exe" $args if ($result.ExitCode) { throw 'Msdeploy failed.' } Write-Information "Updated '$ContentPath' directory on $ServerHost server." } <# .SYNOPSIS Deploys ASP.NET web site (app without project) to remote server. It's similar to Sync-WebContent, but creates IIS application. .PARAMETER Path Folder path to be deployed. .PARAMETER ServerHost Hostname of target machine. .PARAMETER SiteName Web site name. .PARAMETER Application Application name. .PARAMETER AllowUntrusted When specified, untrusted SSL connections are allowed. otherwise, untrusted SSL connections are not allowed. .PARAMETER MSDeployParams Any additional parameters to be passed to MSDeploy utility. #> function Invoke-WebSiteDeployment { [CmdletBinding()] param ( [Parameter(Mandatory = $true)] [string] $Path, [Parameter(Mandatory = $true)] [string] $ServerHost, [Parameter(Mandatory = $true)] [string] $SiteName, [Parameter(Mandatory = $true)] [AllowEmptyString()] [string] $Application, [switch] $AllowUntrusted, [string[]] $MSDeployParams ) Get-CallerPreference -Cmdlet $PSCmdlet -SessionState $ExecutionContext.SessionState Assert-WebDeployCredential Write-Information "Deploying web site from $Path to $ServerHost/$Application..." $computerName, $useTempAgent = GetComputerName $ServerHost $SiteName $args = @('-verb:sync', "-source:iisApp='$Path'", "-dest:iisApp='$SiteName/$Application',computerName='$computerName',tempAgent='$useTempAgent',$credential") if ($AllowUntrusted) { $args += '-allowUntrusted' } if ($MSDeployParams) { $args += $MSDeployParams } $result = Start-Process -NoNewWindow -Wait -PassThru "$msdeployPath\msdeploy.exe" $args if ($result.ExitCode) { throw 'Msdeploy failed.' } } |