Connect-RemoteDesktop.ps1
|
#function Connect-RemoteDesktop { <# .SYNOPSIS Connect an RDP session with PSCredentials .DESCRIPTION Calls BetterCredentials\Set-Credential to store the credential in a way that RemoteDesktop will recognize .NOTES Inspired by Connect-Mstsc from Jaap Brasser http://www.jaapbrasser.com .EXAMPLE Connect-RemoteDesktop -ComputerName server01 Creates a remote desktop session to server01 .EXAMPLE $Cred = BetterCredentials\Get-Credential Jaykul@HuddledMasses.org -Store New-RemoteDesktop server01, server02 $Cred Creates an RDP session to each of server01 and server02, using the specified credentials .EXAMPLE Get-ADComputer -Filter { Name -like *SQL* } | New-RemoteDesktop -Credential Jayku@HuddledMasses.org -Width 1024 Creates an RDP session to each server with a name that has "SQL" in it, using the stored credentials for Jaykul .EXAMPLE $Cred = BetterCredentials\Find-Credential -Target ContosoAzureRDP C:\PS> Get-AzureVM | Get-AzureEndPoint -Name 'Remote Desktop' | New-RemoteDesktop -ComputerName {$_.Vip,$_.Port -join ':'} -Credential $Cred First retrieves credentials for ContosoAzureRDP. You might have stored these previously by running a command like: C:\PS> BetterCredentials\Set-Credential -Target ContosoAzureRDP -Credential contoso\joel Then, starts an RDP session for each Azure Virtual Machine with those credentials #> [cmdletbinding(SupportsShouldProcess, DefaultParametersetName = 'UserPassword')] param ( # This can be a single computername or an array of computers to which RDP session will be opened [Parameter(Mandatory = $true, ValueFromPipeline = $true, ValueFromPipelineByPropertyName = $true, Position = 0)] [Alias('CN','IPAddress')] [string[]]$ComputerName, # The credential for the remote system [Parameter(ValueFromPipelineByPropertyName = $true, Position = 1)] [PSCredential]$Credential, # Sets the /admin switch on the mstsc command: Connects you to the session for administering a server [switch]$Admin, # Sets the /multimon switch on the mstsc command: Configures the Remote Desktop Services session monitor layout to be identical to the current client-side configuration [Parameter(ParameterSetName="MultiMonitorFullScreen")] [switch]$MultiMon, # Sets the /f switch on the mstsc command: Starts Remote Desktop in full-screen mode [Parameter(ParameterSetName="FullScreen")] [switch]$FullScreen, # Sets the /public switch on the mstsc command: Runs Remote Desktop in public mode [switch]$Public, # Sets the /w:<width> parameter on the mstsc command: Specifies the width of the Remote Desktop window [Parameter(ParameterSetName="Size")] [Alias('W','X')] [int]$Width, # Sets the /h:<height> parameter on the mstsc command: Specifies the height of the Remote Desktop window [Parameter(ParameterSetName="Size")] [Alias('H','Y')] [int]$Height, [switch]$Wait ) begin { [string]$MstscArguments = -join $( switch ($true) { {$Admin} { '/admin ' } {$MultiMon} { '/multimon ' } {$FullScreen} { '/f ' } {$Public} { '/public ' } {$Width} { "/w:$Width " } {$Height} { "/h:$Height " } } ) } process { foreach ($Computer in $ComputerName) { $ProcessInfo = New-Object System.Diagnostics.ProcessStartInfo $Process = New-Object System.Diagnostics.Process # Remove the port number for CmdKey otherwise credentials are not entered correctly if ($Computer.Contains(':')) { $ComputerCmdkey = ($Computer -split ':')[0] } else { $ComputerCmdkey = $Computer } Set-Credential -Target TERMSRV/$ComputerCmdkey -Credential $Credential -Type DomainPassword $ProcessInfo.FileName = "$($env:SystemRoot)\system32\mstsc.exe" $ProcessInfo.Arguments = "$MstscArguments /v $Computer" $ProcessInfo.WindowStyle = [System.Diagnostics.ProcessWindowStyle]::Normal $Process.StartInfo = $ProcessInfo if ($PSCmdlet.ShouldProcess($Computer, 'Connecting mstsc')) { [void]$Process.Start() if ($Wait) { $null = $Process.WaitForExit() } } } } |