{"id":2440,"date":"2013-12-11T00:01:00","date_gmt":"2013-12-11T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2013\/12\/11\/use-powershell-to-create-remote-session\/"},"modified":"2013-12-11T00:01:00","modified_gmt":"2013-12-11T00:01:00","slug":"use-powershell-to-create-remote-session","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-powershell-to-create-remote-session\/","title":{"rendered":"Use PowerShell to Create Remote Session"},"content":{"rendered":"

Summary<\/strong>: Learn how to use Windows PowerShell to create a remote management session.<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. Today I am happy to provide you with an excerpt from my new book, Windows PowerShell 3.0 Step by Step<\/a>, published by Microsoft Press.<\/p>\n

\"Image<\/a><\/p>\n

For a simple configuration on a single remote machine, entering a remote Windows PowerShell session is the answer. To enter a remote Windows PowerShell session, use the Enter-PSSession<\/strong> cmdlet to create an interactive remote Windows PowerShell session on a target machine. If you do not supply credentials, the remote session impersonates your current sign-in info.<\/p>\n

The following output illustrates connecting to a remote computer named dc1<\/strong>. <\/em>When the connection is established, the Windows PowerShell prompt changes to include the name of the remote system. The Set-Location<\/strong> (sl<\/strong> is an alias) cmdlet changes the working directory on the remote system to c:\\. Next, the Get-WmiObject<\/strong> cmdlet retrieves the BIOS information on the remote system. The Exit<\/strong> <\/em>command exits the remote session, and the Windows PowerShell prompt returns to the default.<\/p>\n

PS C:\\> Enter-PSSession -ComputerName dc1
[dc1]: PS C:\\Users\\Administrator\\Documents> sl c:\\
[dc1]: PS C:\\> gwmi win32_bios<\/p>\n

SMBIOSBIOSVersion : A01
Manufacturer      : Dell Computer Corporation
Name              : Default System BIOS
SerialNumber      : 9HQ1S21
Version           : DELL   – 6<\/p>\n

[dc1]: PS C:\\> exit
PS C:\\><\/p>\n

The good thing is that when using the Windows PowerShell transcript tool via Start-Transcript<\/strong>, the transcript tool captures output from the remote Windows PowerShell session and output from the local session. Indeed, all commands typed appear in the transcript. The following commands illustrate beginning a transcript, entering a remote Windows PowerShell session, typing a command, exiting the session, and stopping the transcript.<\/p>\n

PS C:\\> Start-Transcript
Transcript started, output file is C:\\Users\\administrator.IAMMRED\\Documents\\PowerShe
ll_transcript.20120701124414.txt
PS C:\\> Enter-PSSession -ComputerName dc1
[dc1]: PS C:\\Users\\Administrator\\Documents> gwmi win32_bios<\/p>\n

SMBIOSBIOSVersion : A01
Manufacturer      : Dell Computer Corporation
Name              : Default System BIOS
SerialNumber      : 9HQ1S21
Version           : DELL   – 6<\/p>\n

[dc1]: PS C:\\Users\\Administrator\\Documents> exit
PS C:\\> Stop-Transcript
Transcript stopped, output file is C:\\Users\\administrator.IAMMRED\\Documents\\PowerShe
ll_transcript.20120701124414.txt
PS C:\\><\/p>\n

The following image contains a copy of the transcript from the previous session.<\/p>\n

\"Image<\/a><\/p>\n

If you anticipate making multiple connections to a remote system, use the New-PSSession<\/strong> cmdlet to create a remote Windows PowerShell session. New-PSSession<\/strong> permits you to store the remote session in a variable, and it provides you with the ability to enter and leave the remote session as often as required, without the additional overhead of creating and destroying remote sessions.<\/p>\n

In the commands that follow, a new Windows PowerShell session is created via the New-PSSession<\/strong> cmdlet. The newly created session is stored in the $dc1<\/strong> variable. Next, the Enter-PSSession<\/strong> cmdlet is used to enter the remote session by using the stored session. A command retrieves the remote host name, and the remote session is exited via the Exit<\/strong> <\/em>command. Next, the session is re-entered, and the last process is retrieved. The session is exited once again. Finally, the Get-PSSession<\/strong> cmdlet retrieves Windows PowerShell sessions on the system, and all sessions are removed via the Remove-PSSession<\/strong> cmdlet.<\/p>\n

PS C:\\> $dc1 = New-PSSession -ComputerName dc1 -Credential iammred\\administrator
PS C:\\> Enter-PSSession $dc1
[dc1]: PS C:\\Users\\Administrator\\Documents> hostname
dc1
[dc1]: PS C:\\Users\\Administrator\\Documents> exit
PS C:\\> Enter-PSSession $dc1
[dc1]: PS C:\\Users\\Administrator\\Documents> gps | select -Last 1<\/p>\n

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
——-  ——    —–      —– —–   ——     — ———–
    292       9    39536      50412   158     1.97   2332 wsmprovhost<\/p>\n

[dc1]: PS C:\\Users\\Administrator\\Documents> exit
PS C:\\> Get-PSSession<\/p>\n

 Id Name            ComputerName    State         ConfigurationName     Availability
 — —-            ————    —–         —————–     ————
  8 Session8        dc1             Opened        Microsoft.PowerShell     Available<\/p>\n

PS C:\\> Get-PSSession | Remove-PSSession
PS C:\\><\/p>\n

Join me tomorrow when I will talk about understanding the While<\/strong> statement.<\/p>\n

I invite you to follow me on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to me at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.<\/p>\n

Ed Wilson, Microsoft Scripting Guy<\/strong> <\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Learn how to use Windows PowerShell to create a remote management session. Microsoft Scripting Guy, Ed Wilson, is here. Today I am happy to provide you with an excerpt from my new book, Windows PowerShell 3.0 Step by Step, published by Microsoft Press. For a simple configuration on a single remote machine, entering a […]<\/p>\n","protected":false},"author":596,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[51,3,4,45],"class_list":["post-2440","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Learn how to use Windows PowerShell to create a remote management session. Microsoft Scripting Guy, Ed Wilson, is here. Today I am happy to provide you with an excerpt from my new book, Windows PowerShell 3.0 Step by Step, published by Microsoft Press. For a simple configuration on a single remote machine, entering a […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/2440","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/596"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=2440"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/2440\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=2440"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=2440"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=2440"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}