public/Install-SpeedTestServer.ps1
|
<# .SYNOPSIS Configures the local or a domain computer as an iPerf3 server. .DESCRIPTION Configures iPerf3 as a constantly-listening service on the local or a domain computer. .PARAMETER ComputerName The name of the domain computer that will act as an iPerf3 server. If this parameter is not specified, the local computer will be configured as an iPerf3 server. .PARAMETER Port The port number that the iPerf3 server will listen on. If not specified, the default port '5201' will be used. .PARAMETER Credential Domain credentials used to authenticate to a domain computer, if necessary. .PARAMETER PassThru Returns the object returned by "Get-Process -Name 'iperf3' -ErrorAction 'SilentlyContinue'". .EXAMPLE Install-SpeedTestServer -ComputerName SERVER01 -Port 5201 -Credential domain\user Sets up computer SERVER01 as an iPerf3 server listening on port 5201. This runs the appropriate setup functions under the 'domain\user' credential. .EXAMPLE Install-SpeedTestServer -Port 5555 Sets up the local computer as an iPerf3 server listening on port 5555. .EXAMPLE Install-SpeedTestServer -Port 5555 -PassThru #> function Install-SpeedTestServer { [CmdletBinding()] Param ( [ValidateNotNullOrEmpty()] [String] $ComputerName, [ValidateNotNullOrEmpty()] [String] $Port = '5201', [ValidateNotNullOrEmpty()] [PSCredential] $Credential, [Switch] $PassThru ) if (!($ComputerName)) { Write-Verbose -Message "Setting up server on local machine on port $Port." Install-ChocolateyGetProvider Install-iPerf3 Set-iPerf3Port -Port $Port Set-iPerf3Task -Port $Port Write-Verbose -Message "Waiting for 10 seconds for iPerf3 executable to launch." Start-Sleep -Seconds 10 $getProcessResult = Get-Process -Name 'iperf3' -ErrorAction 'SilentlyContinue' if ($getProcessResult) { Write-Verbose -Message "iPerf3 Server started on port $Port." } else { throw "iPerf3 Server failed to start on port $Port. Message: $($error[0].Exception.message)" } if ($PassThru) { return $getProcessResult } } else { if (!($Credential)) { Write-Verbose -Message "Setting up server on domain machine $ComputerName on port $Port." Invoke-Command -ComputerName $ComputerName -ScriptBlock ${Function:Install-ChocolateyGetProvider} Invoke-Command -ComputerName $ComputerName -ScriptBlock ${Function:Install-iPerf3} Invoke-Command -ComputerName $ComputerName -ScriptBlock ${Function:Set-iPerf3Port} -ArgumentList $Port Invoke-Command -ComputerName $ComputerName -ScriptBlock ${Function:Set-iPerf3Task} -ArgumentList $Port Write-Verbose -Message "Waiting for 5 seconds for iPerf3 executable to launch." Start-Sleep -Seconds 5 $getProcessResult = Invoke-Command -ComputerName $ComputerName -ScriptBlock {Get-Process -Name 'iperf3' -ErrorAction 'SilentlyContinue'} if ($getProcessResult) { Write-Verbos -Message "iPerf3 Server started on computer $ComputerName on port $Port." } else { throw "iPerf3 Server failed to start on computer $ComputerName on port $Port. Message: $($error[0].Exception.message)" } if ($PassThru) { return $getProcessResult } } else { Write-Verbose -Message "Setting up server on domain machine $ComputerName on port $Port with credential $Credential." Invoke-Command -ComputerName $ComputerName -ScriptBlock ${Function:Install-ChocolateyGetProvider} -Credential $Credential Invoke-Command -ComputerName $ComputerName -ScriptBlock ${Function:Install-iPerf3} -Credential $Credential Invoke-Command -ComputerName $ComputerName -ScriptBlock ${Function:Set-iPerf3Port} -ArgumentList $Port -Credential $Credential Invoke-Command -ComputerName $ComputerName -ScriptBlock ${Function:Set-iPerf3Task} -ArgumentList $Port -Credential $Credential Write-Verbose -Message "Waiting for 5 seconds for iPerf3 executable to launch." Start-Sleep -Seconds 5 $getProcessResult = Invoke-Command -ComputerName $ComputerName -ScriptBlock {Get-Process -Name 'iperf3' -ErrorAction 'SilentlyContinue'} -Credential $Credential if ($getProcessResult) { Write-Verbos -Message "iPerf3 Server started on computer $ComputerName on port $Port with credential $Credential." } else { throw "iPerf3 Server failed to start on computer $ComputerName on port $Port with credential $Credential. Message: $($error[0].Exception.message)" } if ($PassThru) { return $getProcessResult } } } } |