Public/Invoke-RunAsSSMS.ps1
|
<#
.Synopsis Chosen credentials will be passed to remote SQL server when windows authentication is chosen. This allows connecting to a SQL server using windows authentication when you are not on that domain. .Parameter Account Specify the account that should be used for the SQL server you will be connecting to. .Parameter SSMSPath Specify the Full UNC path to SQL Server Studio Managers ssms.exe. SSMSPath is only required on the first run of this function and then a user environment variable is set for persistence. .Example Invoke-RunAsSSMS -account domain\account -SSMSPath "C:\Program Files (x86)\Microsoft SQL Server Management Studio 18\Common7\IDE\Ssms.exe" This example will run SQL Server Studio Manager with the remote credentials specified and set the needed path variable. .Example Invoke-RunAsSSMS -account domain\account This example will run SQL Server Studio Manager with the remote credentials specified .Link https://github.com/TheTaylorLee/AdminToolbox #> Function Invoke-RunAsSSMS { [CmdletBinding()] param( # The query to send to WHOIS servers [Parameter(Mandatory = $true)]$account, [Parameter(Mandatory = $false)]$SSMSPath ) if ($SSMSPath) { #Apply Environment variable to the current session so a console restart isn't required $env:SSMSPath = $SSMSPath #Set Persistent Environment Variables [Environment]::SetEnvironmentVariable("SSMSPath", "$SSMSPath", "User") } if ($env:SSMSPath) { if (Test-Path $env:SSMSPath) { runas.exe /netonly /user:$account $env:SSMSPath } else { Write-Warning "It appears that the existing environment path for $env:SSMSPath could not be validated. Run this function again and specify the file path for Sql Server Studio Manager ssms.exe using the SSMSPath Parameter" } } else { Write-Warning "The path for the Sql Server Studio Manager ssms.exe is not known. Run this function again using the SSMSPath Parameter" } } |