toolbox.ps1


function Start-RemoteDesktop {
    <#
        .SYNOPSIS
            Launch a Windows Remote Desktop admin session to a specified computername, with either FullScreen, or sized window
        .DESCRIPTION
            Start-RemoteDesktop calls the mstsc.exe process installed on the local instance of Windows.
            By default, Start-RemoteDesktop specifies the optional arguments of /admin, and /fullscreen.
            Start-RemoteDesktop also provides a -ScreenSize parameter, which supports optional window resolution specifications of 1440 x 1050, 1280 x 1024, and 1024 x 768.
            I first made this because I was tired of my last mstsc session hanging on to my last resolution (which would change between when I was docked at my desk, or working from the smaller laptop screen), so this could always 'force' /fullscreen.
        .PARAMETER ComputerName
            Specifies the DNS name or IP address of the computer / server to connect to.
        .PARAMETER ScreenSize
            Specifies the window resolution. If not specified, defaults to Full Screen.
        .PARAMETER Control
            Optional specifies if the remote session should function in Admin, RestrictedAdmin, or Control mode [default in this function].
        .PARAMETER FullScreen
            Unambiguously specifies that the RDP window open to full screen size.
        .PARAMETER PipelineVariable
            Accepts property ComputerName.
        .EXAMPLE
            PS C:\> Start-RemoteDesktop remotehost
            Invokes mstsc.exe /v:remotehost /control
        .EXAMPLE
            PS C:\> Start-RemoteDesktop -ComputerName <IP Address> -ScreenSize 1280x1024 -Control RestrictedAdmin
            Invokes mstsc.exe /v:<IP Address> /RestrictedAdmin /w:1280 /h:1024
        .NOTES
            NAME        :  Start-RemoteDesktop
            VERSION     :  1.7   
            LAST UPDATED:  4/4/2015
            AUTHOR      :  Bryan Dady; @bcdady; http://bryan.dady.us
        .INPUTS
            ComputerName
        .OUTPUTS
            None
    #>
    [cmdletbinding()]
    param (
        [Parameter(Position = 0,
          Mandatory,
          HelpMessage='Provide the DNS name or IP address of the computer/server to connect to.',
          ValueFromPipelineByPropertyName
        )]
        [ValidateNotNullOrEmpty()]
        [String]
        $ComputerName,

        [Parameter(Position = 1)]
        [ValidateSet('FullAdmin','RestrictedAdmin')]
        [String]
        $Control = 'FullAdmin',

        [Parameter(Position = 2)]
        [Switch]
        $FullScreen,

        [Parameter(Position = 3)]
        [ValidateSet('FullScreen', '1920×1080', '1680×1050', '1440x1050', '1280x1024', '1280×720', '1280×768', '1280×800', '1280×960', '1366×768', '1600×1200', '1600×900', '1920×1200', '1920×1280', '1920×1440', '2048×1152', '2160×1440', '2560×1080', '2560×1440', '2560×1600', '2560×1920', '2736×1824', '3000×2000', '3200×2400', '3840×2160', '4096×2304', '1024x768')]
        [String]
        $ScreenSize = 'FullScreen'
    )

    Write-Output -InputObject ('{0} Starting {1}' -f (Get-Date), $PSCmdlet.MyInvocation.MyCommand.Name)

    if (Test-Connection -ComputerName $ComputerName -Count 1 -Quiet) {
        Write-Output -InputObject ('Confirmed network availability of ComputerName {0}' -f $ComputerName)
    } else {
        throw ('Unable to confirm network availability of ComputerName {0} [Test-Connection failed]' -f $ComputerName)
    }

    switch ($Control) {
        'FullAdmin' {
            $AdminLevel = '/admin' 
        }
        'RestrictedAdmin'  {
            $AdminLevel = '/RestrictedAdmin'
        }
        Default {
            $AdminLevel = '/Control'
        }
    }

    if ($FullScreen) {
        $Resolution = '/fullscreen' 
    } else {
        switch ($ScreenSize) {
            'FullScreen' {
                $Resolution = '/fullscreen' 
            }
            '1440x1050' {
                $Resolution = '/w:1440 /h:1050'
            }
            '1280x1024' {
                $Resolution = '/w:1280 /h:1024'
            }
            '1024x768' {
                $Resolution = '/w:1024 /h:768'
            }
            Default {
                $Resolution = '/fullscreen' 
            }
        }
    }

    Write-Debug -Message ('Start-Process -FilePath mstsc.exe -ArgumentList "/v:{0} {1} {2}"' -f $ComputerName, $AdminLevel, $Resolution)

    Start-Process -FilePath mstsc.exe -ArgumentList ('/v:{0} {1} {2}' -f $ComputerName, $AdminLevel, $Resolution) 

    Write-Output -InputObject ("{0} Exiting {1}`n" -f (Get-Date), $PSCmdlet.MyInvocation.MyCommand.Name)
}

Function Test-Port {
    <#
        .SYNOPSIS
            Test-Port is effectively a PowerShell replacement for telnet, to support testing of a specified IP port of a remote computer
        .DESCRIPTION
            Test-Port enables testing for any answer or open indication from a remote network port.
        .PARAMETER Target
            DNS name or IP address of a remote computer or network device to test response from.
        .PARAMETER Port
            IP port number to test on the TARGET.
        .PARAMETER Timeout
            Time-to-live (TTL) parameter for how long to wait for a response from the TARGET PORT.
        .EXAMPLE
            PS C:\> Test-Port RemoteHost 9997
            Tests if the remote host is open on the default Splunk port.
        .NOTES
            NAME        :  Test-Port
            VERSION     :  1.1.1 
            LAST UPDATED:  4/4/2015
            AUTHOR      :  Bryan Dady
        .INPUTS
            None
        .OUTPUTS
            None
    #>
    [cmdletbinding()]
    param(
        [parameter(position = 0,
          mandatory,
          HelpMessage='Provide a DNS name or IP address of a remote computer or network device to test response from.'
        )]
        [String]$Target,

        [parameter(position = 1,
          mandatory,
          HelpMessage='Specify an IP port number to test on the Target'
        )]
        [ValidateRange(1,50000)]
        [int]$Port,

        [int]$Timeout = 2000
    )
    Write-Verbose -Message ('{0} Starting {1}' -f (Get-Date), $PSCmdlet.MyInvocation.MyCommand.Name)
    $OutputObj = New-Object -TypeName PSObject
    $OutputObj | Add-Member -MemberType NoteProperty -Name TargetHostName -Value $Target
    if((Get-Command Test-Connection -ErrorAction Ignore) -and (Test-Connection -ComputerName $Target -Count 2 -ErrorAction SilentlyContinue)) {
        $OutputObj | Add-Member -MemberType NoteProperty -Name TargetHostStatus -Value 'ONLINE'
    } else {
        $OutputObj | Add-Member -MemberType NoteProperty -Name TargetHostStatus -Value 'OFFLINE'
    } 
    $OutputObj | Add-Member -MemberType NoteProperty -Name PortNumber -Value $Port

    $Socket = New-Object -TypeName System.Net.Sockets.TCPClient
    $Connection = $Socket.BeginConnect($Target,$Port,$null,$null)
    $null = $Connection.AsyncWaitHandle.WaitOne($Timeout,$false)
    if($Socket.Connected -eq $true) {
        $OutputObj | Add-Member -MemberType NoteProperty -Name ConnectionStatus -Value 'Success'
        $OutputObj | Add-Member -MemberType NoteProperty -Name TargetHostStatus -Value 'ONLINE' -Force
    } else {
        $OutputObj | Add-Member -MemberType NoteProperty -Name ConnectionStatus -Value 'Failed'
    }
    $null = $Socket.Close
    $OutputObj | Select-Object -Property TargetHostName, TargetHostStatus, PortNumber, ConnectionStatus
    Write-Verbose -Message ("{0} Exiting {1}`n" -f (Get-Date), $PSCmdlet.MyInvocation.MyCommand.Name)
}

New-Alias -Name telnet -Value Test-Port -ErrorAction Ignore