poshBAR

Add-HostsFileEntry [-hostName] <String> [[-ipAddress] <String>] [[-includeLoopbackFix]] [<CommonParameters>]

If you '-includeLoopbackFix', this method will call the 'Add-LoopbackFix' module (see Links below)

EXAMPLE 1

Add-HostsFileEntry "local.example.ca"

EXAMPLE 2

Add-HostsFileEntry "local.example.ca" "10.1.1.1"

EXAMPLE 3

Add-HostsFileEntry "local.example.ca" -includeLoopbackFix

Add-IISHttpVerb [-verb] <String> [-siteName] <String> [[-action] <String>] [<CommonParameters>]

EXAMPLE 1

Add-IISHttpVerb PUT "apps.example.ca"

Add-IISMimeType [-siteName] <String> [-fileExtension] <String> [-mimeType] <String> [<CommonParameters>]

EXAMPLE 1

Add-IISMimeType "foo.example.com" "json" "application/json"

• loopbackFix

Add-LoopbackFix [-siteHostName] <String> [<CommonParameters>]

Applies method 1 workaround fix for "You receive error 401.1 when you browse a Web site that uses Integrated Authentication and is hosted on IIS 5.1 or a later version" (see Links below)

EXAMPLE 1

Add-LoopbackFix "local.mysite.com"

Add-XmlConfigValue [-configFile] <String> [-xpath] <String> [-newnode] <String> [[-attributes] <Hashtable>] [<CommonParameters>]

EXAMPLE 1

Add-ConfigValues "C:\temp\somefile.config" "//SomeNode/AnotherNode" "SomeNewNode" @{"key0"="value0";"key1"="value1"}

Approve-Permissions [-path] <String> [-trustee] <String> [-permission] <String> [<CommonParameters>]

EXAMPLE 1

Approve-Permissions 'c:\inetpub\wwwroot' 'Network Service' 'read-execute'

Assert-PSVersion [-requiredVersion] <Int32> [<CommonParameters>]

EXAMPLE 1

Assert-PSVersion 4

• Assert

Assert-That [-conditionToCheck] <Object> [-failureMessage] <Object> [<CommonParameters>]

EXAMPLE 1

Assert-That ($name -ne $null) "Name cannot be null."

EXAMPLE 2

Assert ($foo -eq $bar) '$foo and $bar must be equal.'

Confirm-ApplicationExists [[-siteName] <Object>] [[-appName] <Object>] [<CommonParameters>]

EXAMPLE 1

Confirm-ApplicatonExists 'mySite' 'myApp'

Confirm-AppPoolExists [[-appPoolName] <Object>] [<CommonParameters>]

EXAMPLE 1

Confirm-AppPoolExists "myAppPool"

Confirm-SiteExists [[-siteName] <String>] [<CommonParameters>]

EXAMPLE 1

Confirm-SiteExists "myWebsite.com"

Expand-NugetPackage [-nugetPackageName] <String> [-destinationFolder] <String> [<CommonParameters>]

EXAMPLE 1

Expand-NugetPackage "something.pkg" "C:\temp\zipcontents"

Expand-ZipFile [-zipFileName] <String> [-destinationFolder] <String> [<CommonParameters>]

EXAMPLE 1

Expand-ZipFile "something.pkg" "C:\temp\zipcontents"

Find-ToolPath [-toolName] <String> [<CommonParameters>]

EXAMPLE 1

Find-ToolPath 'dotcover.exe'

EXAMPLE 2

Find-ToolPath 'sometool.exe'

• ftnhost

Format-TaskNameToHost [-taskName] <String> [<CommonParameters>]

We use this in conjunction with psake for writing headers.

EXAMPLE 1

Format-TaskNameToHost "Doing Some Task"

EXAMPLE 2

FormatTaskName { param($taskName) Format-TaskNameToHost $taskName }

Get-Application [[-siteName] <String>] [[-appName] <String>] [<CommonParameters>]

EXAMPLE 1

Get-Application 'mySite' 'myApp'

Get-Applications [<CommonParameters>]

EXAMPLE 1

Get-Applications

Get-AppPool [[-appPoolName] <Object>] [<CommonParameters>]

EXAMPLE 1

Get-AppPool "myAppPool"

Get-AppPools [<CommonParameters>]

EXAMPLE 1

Get-AppPools

Get-EnvironmentSettings [-environment] <String> [-nodeXPath] <String> [[-environmentsPath] <String>] [[-culture] <String>] [<CommonParameters>]

There MUST be a value present in the XML (even if it's empty). In order to override the value from Octopus. If it's not represented in the XML, it will not be represented in the output of this method.

EXAMPLE 1

$dbSettings = Get-EnvironmentSettings "ci" "//database"

Get-PfxCertificate [-filePath] <String[]> [[-password] <String>] [[-x509KeyStorageFlag] <String>] [<CommonParameters>]
Get-PfxCertificate -literalPath <String[]> [[-password] <String>] [[-x509KeyStorageFlag] <String>] [<CommonParameters>]

the -x509KeyStorageFlag flag is only used if you are also passing in a -password

EXAMPLE 1

Get-PfxCertificate "$here\myCert.pfx" 'P@$$W0rd'

EXAMPLE 2

Get-PfxCertificate -literalPath "C:\certs\myCert.pfx" 'P@$$W0rd'

EXAMPLE 3

Get-PfxCertificate ".\myCert.pfx" 'P@$$W0rd' 'UserKeySet'

EXAMPLE 4

Get-PfxCertificate "$here\myCert.pfx"

EXAMPLE 5

Get-PfxCertificate -literalPath "C:\certs\myCert.pfx"

Get-Site [-siteName] <String> [<CommonParameters>]

EXAMPLE 1

Get-Site "myWebsite.com"

Get-Sites [<CommonParameters>]

EXAMPLE 1

Get-Sites

Get-WindowsFeatures [[-filter] <String>] [<CommonParameters>]

Windows features are stored in $poshBAR:WindowsFeatures in order to improve future lookup times. Locating Windows Features is done using DISM.exe

EXAMPLE 1

Get-WindowsFeatures

EXAMPLE 2

Get-WindowsFeatures http

Install-WebApplication [-environment] <String> [-websiteSettings] <XmlElement> [[-version] <String>] [<CommonParameters>]

The environment name should always line up with the environment names listed in your deployment tool (Octopus Deploy)

EXAMPLE 1

Install-WebApplication 'dev' $environmentSettings.websites.myWebsite '1.0.2.1234'

Install-WindowsFeatures [[-features] <String[]>] [<CommonParameters>]

Optional features can be passed in with a trailing `?` (see Example 2). poshBAR contains an override `$poshBAR.DisableWindowsFeaturesAdministration` which when set to $true will cause this method to throw an exception when trying to install a missing Windows Feature. The purpose of this is to ensure proper change control can be maintained within your Enterprise.

EXAMPLE 1

Install-WindowsFeatures @('IIS-WebServer','IIS-WebServerRole','IIS-ISAPIFilter',  'IIS-ISAPIExtensions',  'IIS-NetFxExtensibility','IIS-ASPNET')

EXAMPLE 2

Install-WindowsFeatures 'IIS-ASPNET45?'

• aspnet_regiis

Invoke-AspNetRegIIS -siteName <String> [-framework <Double>] [-noRestart] [<CommonParameters>]
Invoke-AspNetRegIIS [-i] [-framework <Double>] [-noRestart] [<CommonParameters>]
Invoke-AspNetRegIIS [-ir] [-framework <Double>] [-noRestart] [<CommonParameters>]
Invoke-AspNetRegIIS [-iru] [-framework <Double>] [-noRestart] [<CommonParameters>]

EXAMPLE 1

aspnet_regiis -s example.com -norestart

EXAMPLE 2

Invoke-AspNetRegIIS -i

EXAMPLE 3

aspnet_regiis -iru -framework 3.5

Invoke-BlockWithTokenReplacedFile [[-fileToTokenReplace] <String>] [[-tokenValues] <Hashtable>] [[-blockToAcceptTokenReplacedFile] <ScriptBlock>] [-continuationMessage <String>] [-errorMessage <String>] [<CommonParameters>]

The file is token replaced and the contents stored in a file called "someFile.txt_tokenreplaced" (for example). This file is path is what is passed to the block. The file is automatically removed after the block is executed.

EXAMPLE 1

Invoke-BlockWithTokenReplacedFile "somePath\someFile.txt" @{ 'token1Key' = 'token1Value'; 'token2Key' = 'token2Value' } { param($tokenReplacedFile) DoSomethingWithFile $tokenReplacedFile }

Invoke-Chutzpah [-testDirectory] <String> [<CommonParameters>]

This module depends on the 'Find-ToolPath' module. todo: This should be expanded to take switch parameters for 'teamcity' and 'coverage'

EXAMPLE 1

Invoke-Chutzpah 'C:\Dev\MyApp\src'

Invoke-CleanMSBuild [-projectFile] <String> [[-verbosity] <String>] [<CommonParameters>]

EXAMPLE 1

Invoke-CleanMSBuild $buildOutputDir

EXAMPLE 2

Invoke-CleanMSBuild $buildOutputDir -verbosity n

Invoke-Deployment [<CommonParameters>]

EXAMPLE 1

Invoke-Deployment

Invoke-DeployOctopusNugetPackage [-pathToPackage] <String> [-environment] <String> [<CommonParameters>]

EXAMPLE 1

Test-DeployOctopusNugetPackage "C:\myApp\myApp.nupkg" "production"

• ecliptic

Invoke-Ecliptic [[-testDir] <String>] [<CommonParameters>]

This tools required Ecliptic to be availble within your project or $env:PATH

EXAMPLE 1

Invoke-Ecliptic 'C:/dev/myProject/src/myProject.Tests/'

EXAMPLE 2

ecliptic 'C:/dev/myProject/src/myProject.Tests/'

Invoke-ElevatedCommand [-Scriptblock] <ScriptBlock> [[-InputObject] <Object>] [-EnableProfile] [-DisplayWindow] [<CommonParameters>]

Originally from "Windows PowerShell Cookbook" (O'Reilly), by Lee Holmes, September 2010 at http://poshcode.org/2179 Modified by obsidience for enhanced error-reporting, October 2010 at http://poshcode.org/2297 Modified by Tao Klerks for code formatting, enhanced/fixed error-reporting, and interaction/hanging options, January 2012 at https://gist.github.com/gists/1582185 and at http://poshcode.org/, followup to http://poshcode.org/2297 SEE ALSO: "Invoke-Elevated" (alias "su") in PSCX 2.0 - simpler "just fire" elevated process runner.

EXAMPLE 1

Invoke-ElevatedCommand {"Hello World"}

EXAMPLE 2

"test" | Invoke-ElevatedCommand {$input | Out-File -filepath c:\test.txt}

EXAMPLE 3

Invoke-ElevatedCommand {$one = 1; $zero = 0; $throwanerror = $one / $zero}

• efMigrate

Invoke-EntityFrameworkMigrations [[-targetAssembly] <String>] [[-startupDirectory] <String>] [[-connectionString] <String>] [[-databaseName] <String>] [-dropDB] [<CommonParameters>]

This method depends on the SQLHelpers module, and the EF 'migrate.exe' (see links below).

• Exec
• Execute

Invoke-ExternalCommand [-command] <ScriptBlock> [[-errorMessage] <String>] [-retry <Int32>] [-msDelay <Int32>] [<CommonParameters>]

EXAMPLE 1

Exec { git st } "Error getting GIT status. Please verify GIT command-line client is installed"

EXAMPLE 2

Invoke-ExternalCommand {get st} "Error getting GIT status. Please verify GIT command-line client is installed" -retry 10 -msDelay 1000

• fromBase64

Invoke-FromBase64 [-str] <String> [<CommonParameters>]

EXAMPLE 1

Invoke-FromBase64 $base64EncodedString

• htmlDecode

Invoke-HtmlDecode [-str] <String> [<CommonParameters>]

EXAMPLE 1

Invoke-HtmlDecode $htmlEncodedString

• htmlEncode

Invoke-HtmlEncode [-str] <String> [<CommonParameters>]

EXAMPLE 1

Invoke-HtmlEncode $myString

Invoke-KarmaTests [[-rootPath] <String>] [<CommonParameters>]

EXAMPLE 1

Invoke-KarmaTests "C:\Dev\myApp\src\myApp.Website"

• compile
• msbuild

Invoke-MSBuild [-outDir] <String> [-projectFile] <String> [-target <String>] [-logPath <String>] [-namespace <String>] [-visualStudioVersion <Double>] [-toolsVersion <String>] [-maxCpuCount <Int32>] [-verbosity <String>] [-warnOnArchitectureMismatch <Boolean>] [-customParameters <String[]>] [<CommonParameters>]

The toolset version isn't the same as the target framework, which is the version of the .NET Framework on which a project is built to run.

EXAMPLE 1

Invoke-MSBuild $buildOutputDir $solutionFile

EXAMPLE 2

Invoke-MSBuild $buildOutputDir $solutionFile -customParameters @('/property:SomeProperty=value')

EXAMPLE 3

Invoke-MSBuild $buildOutputDir $solutionFile -target 'clean' -logPath 'c:\logs' -namespace 'My.App.Namespace' -visualStudioVersion 11.0 -toolsVersion 4.0 -maxCpuCount 8 -verbosity 'normal' -warnOnArchitectureMismatch $true

Invoke-Nunit [[-targetAssembly] <String>] [[-outputDir] <String>] [[-runCommand] <String>] [[-includeCoverage] <Boolean>] [[-coverageRulesPath] <String>] [<CommonParameters>]

Currently 'includeCoverage' invokes the DotCover coverage tool. Some day we'll need to re-think how we want to achieve this.

EXAMPLE 1

Invoke-Nunit "$buildDir\myTestAssembly.dll" "$outputDir" "myAssembly.Unit" -includeCoverage "$coverageRulesPath"

Invoke-OracleCommand [[-sqlToRun] <String>] [[-connectionString] <String>] [<CommonParameters>]

SQL commands can only contain a single command, you can get around this by using BEGIN EXECUTE IMMEDIATE 'SELECT .... '; EXECUTE IMMEDIATE 'SELECT ....'; END;

EXAMPLE 1

Invoke-OracleCommand "SELECT 2*35 FROM DUAL" "Data Source=;User Id=SYSTEM;Password=xxxx"

Invoke-OracleFile [[-sqlFile] <String>] [[-connectionString] <String>] [<CommonParameters>]

SQL commands can only contain a single command, you can get around this by using BEGIN EXECUTE IMMEDIATE 'SELECT .... '; EXECUTE IMMEDIATE 'SELECT ....'; END;

EXAMPLE 1

Invoke-OracleFile "C:\path\to\script.sql" "Data Source=;User Id=SYSTEM;Password=xxxx"

• signscripts

Invoke-PowershellScriptSigning [-scripts] <String[]> [[-certStorePath] <String>] [<CommonParameters>]
Invoke-PowershellScriptSigning [-scripts] <String[]> [[-pfxFilePath] <PathInfo>] [[-password] <String>] [<CommonParameters>]

If using -pfxFilePath, be sure to use Resolve-Path and pass in the PathInfo object.

EXAMPLE 1

Invoke-PowershellScriptSigning @("C:\temp\someposh.ps1", "C:\otherposh.ps1")

EXAMPLE 2

Invoke-PowershellScriptSigning @("C:\temp\someposh.ps1", "C:\otherposh.ps1") "CurrentUser\My"

EXAMPLE 3

Invoke-PowershellScriptSigning @("C:\temp\someposh.ps1", "C:\otherposh.ps1") (Resolve-Path 'C:\path\to\my.pfx')

Invoke-SpecFlow [-testProjectFile] <String> [-testAssemblyFile] <String> [-outputDir] <String> [-runCommand] <String> [-testingFramework] <Object> [[-coverageRulesPath] <String>] [[-includeCoverage]] [[-showSpecflowReport]] [<CommonParameters>]

Currently 'includeCoverage' invokes the DotCover coverage tool. Some day we'll need to re-think how we want to achieve this.

EXAMPLE 1

Invoke-Nunit "$buildDir\myTestAssembly.dll" "$outputDir" "myAssembly.Unit" -includeCoverage "$coverageRulesPath"

• toBase64

Invoke-ToBase64 [-str] <String> [<CommonParameters>]

EXAMPLE 1

Invoke-ToBase64 $myString

• urlDecode

Invoke-UrlDecode [-str] <String> [<CommonParameters>]

EXAMPLE 1

Invoke-UrlDecode $urlEncodedString

• urlEncode

Invoke-UrlEncode [-str] <String> [<CommonParameters>]

EXAMPLE 1

Invoke-UrlEncode $myString

Invoke-WebHealthCheck [-uri] <String> [[-verbs] <String[]>] [[-postData] <String>] [[-contentType] <String>] [[-timeout] <Int32>] [[-customHeaders] <Object>] [[-credentials] <NetworkCredential>] [<CommonParameters>]
Invoke-WebHealthCheck [-request] <Object> [<CommonParameters>]

EXAMPLE 1

Invoke-WebHealthCheck 'http://google.com' 'GET'

EXAMPLE 2

Invoke-WebHealthCheck @{uri = 'https://google.com'; verbs = 'GET'}

• xdt
• XmlDocumentTransform

Invoke-XmlDocumentTransform [-inputPathAndFile] <String> [-transformPathAndFile] <String> [[-outputPathAndFile] <String>] [<CommonParameters>]

Invoke-XUnit [[-targetAssembly] <String>] [[-outputDir] <String>] [[-runCommand] <String>] [[-includeCoverage] <Boolean>] [[-coverageRulesPath] <String>] [<CommonParameters>]

Currently 'includeCoverage' invokes the DotCover coverage tool. Some day we'll need to re-think how we want to achieve this.

EXAMPLE 1

Invoke-XUnit "$buildDir\myTestAssembly.dll" "$outputDir" "myAssembly.Unit" -includeCoverage "$coverageRulesPath"

Invoke-XUnitWithCoverage [[-targetAssembly] <String>] [[-outputDir] <String>] [[-runCommand] <String>] [[-coverageRulesPath] <String>] [<CommonParameters>]

Currently 'includeCoverage' invokes the DotCover coverage tool. Some day we'll need to re-think how we want to achieve this.

EXAMPLE 1

Invoke-XUnitWithCoverage "$buildDir\myTestAssembly.dll" "$outputDir" "myAssembly.Unit" "$coverageRulesPath"

• Lock

Lock-Object [-InputObject] <Object> [-ScriptBlock] <ScriptBlock> [<CommonParameters>]

Most of the time, PowerShell code runs in a single thread. You have to go through several steps to create a situation in which multiple threads can try to access the same .NET object. In the Links section of this help topic, there is a blog post by Boe Prox which demonstrates this.

EXAMPLE 1

$hashTable = @{}; lock ($hashTable.SyncRoot) {  $hashTable.Add("Key", "Value") }

EXAMPLE 2

$hashTable = @{}; Lock-Object -InputObject $hashTable.SyncRoot -ScriptBlock { $hashTable.Add("Key", "Value")}

New-Application [-siteName] <String> [-appName] <String> [-appPath] <String> [-appPoolName] <String> [[-updateIfFound]] [<CommonParameters>]

EXAMPLE 1

New-Application "MyApp" "apps.mysite.com" "C:\inetpub\apps.mysite.com\MyApp" "MyApp"

New-AppPool [-appPoolName] <String> [[-appPoolIdentityType] <String>] [[-maxProcesses] <Int32>] [[-username] <String>] [[-password] <String>] [[-idleTimeout] <TimeSpan>] [[-managedPipelineMode] <String>] [[-managedRuntimeVersion] <String>] [-alwaysRunning] [-updateIfFound] [<CommonParameters>]

EXAMPLE 1

New-AppPool "myAppPool" "NetworkService"

EXAMPLE 2

New-AppPool "myAppPool" "NetworkService" -managedPipelineMode 'Classic'

New-Certificate [-certData] <Hashtable> [<CommonParameters>]
New-Certificate [-name] <String> [-outPath] <String> [-key] <String> [-csr] <String> [<CommonParameters>]

Please ensure openssl.exe is available on your $env:PATH

EXAMPLE 1

New-Certificate 'cert-name' 'C:\path\to\output' 'certName.key' 'certName.csr'

New-CertificateSigningRequest [-certData] <Hashtable> [<CommonParameters>]
New-CertificateSigningRequest [-name] <String> [-outPath] <String> [-subject] <String> [-key] <String> [<CommonParameters>]

Please ensure openssl.exe is available on your $env:PATH

EXAMPLE 1

New-CertificateSigningRequest 'cert-name' 'C:\path\to\output' '/CN=bla' 'cert-name.key'

• nupack

New-NugetPackage [-nuspecFile] <String> [-version] <String> [-outputDirectory] <String> [<CommonParameters>]

Requires `nuget.exe` to be available on your $env:PATH Uses Find-ToolPath to try and locate nuget.exe (see Links below)

New-OracleDatabase [-schemaName] <String> [-databaseStorageFile] <String> [-schemaOwnerUserId] <String> [-schemaOwnerPassword] <String> [-connectionString] <String> [<CommonParameters>]

EXAMPLE 1

New-OracleDatabase 'MyDatabase' 'C:\databases\MyDatabase.dbf' 'MyUser' 'MyUserPassword' 'Data Source=localhost/XE;User Id=system;Password=SAus3r'

New-PfxCertificate [-certData] <Hashtable> [-password] <String> [<CommonParameters>]
New-PfxCertificate [-outPath] <String> [-key] <String> [-crt] <String> [-name] <String> [-password] <String> [<CommonParameters>]

Please ensure openssl.exe is available on your $env:PATH

EXAMPLE 1

New-PfxCertificate 'c:\path\to\output' 'certName.key' 'certName.crt" 'certName' 'certP@ssword'

New-PrivateKey [-name] <String> [-password] <String> [-subject] <String> [-outPath] <String> [<CommonParameters>]

Please ensure openssl.exe is available on your $env:PATH

EXAMPLE 1

New-PrivateKey 'cert-name' 'certP@ssword" '/CN=bla' 'C:\path\to\output'

New-PrivateKeyAndCertificateSigningRequest [-name] <String> [-password] <String> [-subject] <String> [-outPath] <String> [<CommonParameters>]

Please ensure openssl.exe is available on your $env:PATH

EXAMPLE 1

New-PrivateKeyAndCertificateSigningRequest 'cert-name' 'certP@ssword" '/CN=bla' 'C:\path\to\output'

New-Site [-siteName] <String> [-sitePath] <String> [-bindings] <Object[]> [-appPoolName] <String> [[-updateIfFound]] [<CommonParameters>]

EXAMPLE 1

New-Site "myWebsite.com" "c:\inetpub\wwwroot" @(@{"protocol" = "http"; "port" = 80; "hostName"="mysite.com"}) "myAppPool" -updateIfFound

Remove-Application [[-siteName] <Object>] [[-appName] <Object>] [<CommonParameters>]

EXAMPLE 1

Remove-Application 'mySite' 'myApp'

Remove-AppPool [[-appPoolName] <Object>] [<CommonParameters>]

EXAMPLE 1

Remove-AppPool "myAppPool"

Remove-OracleDatabase [-schemaName] <String> [-schemaOwnerUserId] <String> [-connectionString] <String> [[-failOnError] <Boolean>] [<CommonParameters>]

WARNING: only to be used on development databases - DROPS the Database!

EXAMPLE 1

Remove-OracleDatabase 'MyDatabase' 'MyUser' 'Data Source=localhost/XE;User Id=system;Password=SAus3r' $false

Remove-Site [-siteName] <String> [<CommonParameters>]

EXAMPLE 1

Remove-Site "myWebsite.com"

• RequiredFeatures

RequiredWindowsFeatures [[-requiredWindowsFeatures] <String[]>] [<CommonParameters>]

EXAMPLE 1

RequiredWindowsFeatures @('IIS-WebServer','IIS-WebServerRole')

Reset-OracleDatabase [-schemaName] <String> [-databaseStorageFile] <String> [-schemaOwnerUserId] <String> [-schemaOwnerPassword] <String> [-connectionString] <String> [<CommonParameters>]

WARNING: only to be used on development databases - DROPS the Database!

EXAMPLE 1

Reset-OracleDatabase 'MyDatabase' 'C:\databases\MyDatabase.dbf' 'MyUser' 'MyUserPassword' 'Data Source=localhost/XE;User Id=system;Password=SAus3r'

Set-IISAuthentication [-authTypes] <AuthType[]> [-value] <PSObject> [-location] <String> [[-disableOthers]] [<CommonParameters>]

EXAMPLE 1

Set-IISAuthentication "windowsAuthentication" true "apps.mysite.com/MyApp"

Set-IISCustomHeader [-siteName] <String> [-customHeaderName] <String> [-customHeaderValue] <String> [<CommonParameters>]

EXAMPLE 1

Set-IISCustomHeader "xyz.mysite.com" "access-control-allow-origin" "*"

Start-Application [[-siteName] <Object>] [[-appName] <Object>] [<CommonParameters>]

EXAMPLE 1

Start-Application 'mySite' 'myApp'

Start-AppPool [[-appPoolName] <Object>] [<CommonParameters>]

EXAMPLE 1

Start-AppPool "myAppPool"

Start-Site [-siteName] <String> [<CommonParameters>]

EXAMPLE 1

Start-Site "myWebsite.com"

Stop-Application [[-siteName] <Object>] [[-appName] <Object>] [<CommonParameters>]

EXAMPLE 1

Stop-Application 'mySite' 'myApp'

Stop-AppPool [[-appPoolName] <Object>] [<CommonParameters>]

EXAMPLE 1

Stop-AppPool "myAppPool"

Stop-Site [-siteName] <String> [<CommonParameters>]

EXAMPLE 1

Stop-Site "myWebsite.com"

Test-RunAsAdmin [<CommonParameters>]

EXAMPLE 1

Test-RunAsAdministrator

Update-Application [-siteName] <String> [-appName] <String> [-appPath] <String> [-appPoolName] <String> [<CommonParameters>]

EXAMPLE 1

Update-Application 'mySite' 'myApp' 'C:\inetput\wwwroot' 'appPoolName'

Update-AppPool [-appPoolName] <String> [[-appPoolIdentityType] <String>] [[-maxProcesses] <Int32>] [[-username] <String>] [[-password] <String>] [[-idleTimeout] <TimeSpan>] [[-managedPipelineMode] <String>] [[-managedRuntimeVersion] <String>] [-alwaysRunning] [<CommonParameters>]

EXAMPLE 1

Update-AppPool "myAppPool" "NetworkService"

EXAMPLE 2

Update-AppPool "myAppPool" "NetworkService" -managedPipelineMode 'Classic'

Update-AssemblyVersions [-Version] <String> [-BuildNumber] <String> [-AssemblyInformationalVersion] <String> [[-projectRoot] <String>] [[-copyrightFormatString] <String>] [<CommonParameters>]

EXAMPLE 1

Update-AssemblyVersions '3.1.2', '233', '3.1.2 Beta 1' -copyright 'Copyright {0} Acme Corp.'

Update-JsonConfigValues [-configFile] <String> [-node] <String> [-value] <String> [<CommonParameters>]

If Powershell version => 3 is available, the final text will retain formatting. If only Powershell version 2 is available, all formatting will be lost, and the output will be a single line.

EXAMPLE 1

Update-JsonConfigValues "c:\path\to.json" "user[0].address.streetAddress" "21 Jump St."

EXAMPLE 2

Update-JsonConfigValues "c:\path\to.json" "website.siteHost" "http://www.example.com"

Update-Site [-siteName] <String> [-sitePath] <String> [-bindings] <Object[]> [-appPoolName] <String> [<CommonParameters>]

EXAMPLE 1

Update-Site "myWebsite.com" "c:\inetpub\wwwroot" @(@{"protocol" = "http"; "port" = 80; "hostName"="mysite.com"}) "myAppPool"

Update-XmlConfigValues [-configFile] <String> [-xpath] <String> [-value] <String> [[-attributeName] <String>] [<CommonParameters>]

EXAMPLE 1

Update-ConfigValues "C:\temp\somefile.config" "//SomeNode/AnotherNode" "Some New Value"

• psUsing

Use-Object [-InputObject] <Object> [-ScriptBlock] <ScriptBlock> [<CommonParameters>]

EXAMPLE 1

Use-Object ($foo = new-object System.Some.Disposable.Object) { $foo.DoSomething }

EXAMPLE 2

psUsing($foo = new-object System.Some.Disposable.Object) { $foo.DoSomething }

Write-TokenReplacedFile [[-fileToTokenReplace] <String>] [[-outFile] <String>] [[-tokenValues] <Hashtable>] [<CommonParameters>]

The file is token replaced and the contents stored in requested output file

EXAMPLE 1

Write-TokenReplacedFile "somePath\someFile.txt" "somePath\tokenReplacedFile.txt" @{ 'token1Key' = 'token1Value'; 'token2Key' = 'token2Value' }