{"id":6201,"date":"2008-05-09T22:01:00","date_gmt":"2008-05-09T22:01:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/powershell\/2008\/05\/09\/remoting-with-powershell-quickstart\/"},"modified":"2019-02-18T13:15:57","modified_gmt":"2019-02-18T20:15:57","slug":"remoting-with-powershell-quickstart","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/powershell\/remoting-with-powershell-quickstart\/","title":{"rendered":"Remoting with PowerShell QuickStart"},"content":{"rendered":"

PowerShell V2 introduces a new capability which allows you to remotely manage machines in your organization. I will give a basic overview of PowerShell remoting here and follow it up with some adavanced topics later. Are you ready for the fun..<\/font><\/p>\n

A remote interaction involves 2 endpoints \u2013 Client and a Server. The same computer or system can act both as a client and as a server. <\/font><\/p>\n

Configuration<\/font><\/font><\/b><\/p>\n

To enable an endpoint for PowerShell remoting you need to do the following:<\/font><\/p>\n

Step 1: Install PowerShell <\/font>CTP2 of PowerShell V2<\/font><\/a> <\/font><\/p>\n

Step2: Install <\/font>CTP of WinRM<\/font><\/a> <\/font><\/p>\n

Step 3: Configure WinRM for PowerShell remoting. This can be done from a PowerShell Console using the following steps<\/font><\/p>\n

(a)<\/font>    <\/span><\/span><\/span>Open PowerShell console in elevated prompt<\/font><\/p>\n

(b)<\/font>   <\/span><\/span><\/span>Run $pshome\\configure-wsman.ps1 script.<\/font><\/p>\n

The above script will prepare your machine for remoting. This script will enable an endpoint both to act as a client and as well as a server.<\/font><\/p>\n

PowerShell depends on WinRM for transport of data between endpoints. WinRM implements WS-Management a SOAP-based protocol for the management of servers etc. The good thing about this protocol is it is based on HTTP. So all the packets are going on Port 80 (by default) and you don\u2019t need to open any other port for PowerShell remoting.<\/font><\/p>\n

Using the Power<\/font><\/font><\/b><\/p>\n

The beauty of PowerShell remoting is that all the cmdlets\/scripts you have from V1 work as is everywhere (as long as PowerShell is installed on the server). So you develop your cmdlet\/scripts once and you can remotely execute them with PowerShell as is without making any changes. The only dependency being the cmdlet\/script you want to execute should be accessible on the remote box.<\/font><\/p>\n

Let me show you some examples:<\/font><\/p>\n

PS C:\\> #my current machine<\/font><\/p>\n

PS C:\\> $env:computername<\/font><\/p>\n

KRISCV-JHOOM<\/font><\/p>\n

PS C:\\> icm kriscv-lh { $env:computername }<\/font><\/p>\n

KRISCV-LH<\/font><\/p>\n

PS C:\\><\/font><\/p>\n

The above example gives a glimpse of powershell remoting. Here I ran \u201c$env:computername\u201d locally and then on a remote machine from my local machine. I showed a new command \u201cicm\u201d here. \u201cicm\u201d is an alias for invoke-command<\/i> cmdlet. This cmdlet takes the following pattern:<\/font><\/p>\n

 <\/font><\/p>\n

Invoke-command <ExecutionContext>  <\/span>{ <script block to run in the context>}<\/font><\/font><\/i><\/p>\n

 <\/font><\/p>\n

In my above \u201ckriscv-lh\u201d is the execution context. In this case it is a destination computer name.  <\/span>So, essentially I have asked invoke-command<\/i> to run the script \u201c{$env:computername}\u201d on the remote machine. This is the cmdlet you should use for remoting in CTP2 of Powershell V2. This cmdlet internally creates a connection with the machine \u201ckriscv-lh\u201d, runs the command on the machine, gets the output from the remote machine to the local machine, displays the output and then closes the connection. <\/font><\/p>\n

 <\/font><\/p>\n

You can pretty much do anything on the remote machine as you would on the local machine. Administrator of the remote machine however has the complete control of restricting you.<\/font><\/p>\n

 <\/font><\/p>\n

The following example shows you a way of finding free disk space on the remote machine:<\/font><\/p>\n

 <\/font><\/p>\n

PS C:\\> $env:computername<\/font><\/p>\n

KRISCV-JHOOM<\/font><\/p>\n

PS C:\\> icm kriscv-lh {gwmi win32_logicaldisk | select deviceid,freespace}<\/font><\/p>\n

 <\/font><\/p>\n

deviceid                 <\/span>freespace                <\/span>ComputerName             <\/span>RunspaceId<\/font><\/p>\n

——–               <\/span>         <\/span>  <\/span>———                <\/span>————           <\/span>              <\/span>  <\/span>———-<\/font><\/p>\n

A:                                <\/span>                <\/span>             <\/span> <\/span> <\/span>kriscv-lh                <\/span>         <\/span>8ce689c2-87a2-4e38-83…<\/font><\/p>\n

C:                       <\/span>44054937600            <\/span> <\/span>    <\/span>kriscv-lh                <\/span>         <\/span> <\/span>8ce689c2-87a2-4e38-83…<\/font><\/p>\n

D:                                              <\/span>             <\/span> <\/span> <\/span> <\/span>kriscv-lh                <\/span>   <\/span>       <\/span>8ce689c2-87a2-4e38-83…<\/font><\/p>\n

 <\/font><\/p>\n

Estentially whatever you have learned with V1 of PowerShell can be used with PowerShell remoting.  <\/span>Lets convert the above example to show the freespace in GB instead of bytes:<\/font><\/p>\n

 <\/font><\/p>\n

PS C:\\> icm kriscv-lh {gwmi win32_logicaldisk | select deviceid,freespace}<\/b> | select deviceid,@{Name=<\/font><\/p>\n

“freespace(GB)”;Expression={$_.freespace\/1gb}},computername<\/font><\/p>\n

 <\/font><\/p>\n

deviceid                                             <\/span>freespace(GB)           <\/span>ComputerName<\/font><\/p>\n

——–                                             <\/span>        <\/span>————-                 <\/span>————<\/font><\/p>\n

A:                                                               <\/span>       <\/span>         <\/span>0      <\/span>        <\/span> <\/span>kriscv-lh<\/font><\/p>\n

C:                 <\/span>                                  <\/span>41.0060882568359     <\/span>         <\/span>kriscv-lh<\/font><\/p>\n

D:                                                              <\/span>                <\/span> <\/span>0     <\/span>          <\/span>kriscv-lh<\/font><\/p>\n

 <\/font><\/p>\n

Notice what I have done here. The command in bold<\/b> above is run on the remote machine kriscv-lh and the rest of the pipeline is run on the local box ie.,\u201dselect-object\u201d cmdlet is run on the local machine. PowerShell remoting ensures objects are written onto the pipeline and hence you can leverage the complete power of PowerShell by working directly with an object. <\/font><\/p>\n

 <\/font><\/p>\n

You can apply the same concept to multiple machines. The following examples gets the free disk space from multiple machines:<\/font><\/p>\n

 <\/font><\/p>\n

PS C:\\> icm kriscv-lh,kriscv-jhoom<\/b> {gwmi win32_logicaldisk | select deviceid,freespace} | select dev<\/font><\/p>\n

iceid,@{Name=”freespace(GB)”;Expression={$_.freespace\/1gb}},computername<\/font><\/p>\n

 <\/font><\/p>\n

deviceid                                             <\/span>freespace(GB)      <\/span> <\/span>ComputerName<\/font><\/p>\n

——–                                            <\/span>       <\/span>  <\/span> <\/span>————-                 <\/span> <\/span>————<\/font><\/p>\n

C:                                       <\/span>         <\/span>182.064617156982       <\/span>kriscv-jhoom<\/font><\/p>\n

D:                                                <\/span>136.152328491211     <\/span> <\/span>kriscv-jhoom<\/font><\/p>\n

E:                                                <\/span>7.60776519775391      <\/span> <\/span>kriscv-jhoom<\/font><\/p>\n

F:                                                <\/span>1.76084136962891     <\/span> <\/span> <\/span>kriscv-jhoom<\/font><\/p>\n

G:                                                           <\/span>               <\/span> <\/span>0     <\/span> <\/span> <\/span> <\/span>kriscv-jhoom<\/font><\/p>\n

A:                                 <\/span>                        <\/span>  <\/span>                <\/span>0        <\/span>kriscv-lh<\/font><\/p>\n

C:                 <\/span>                              <\/span>41.0063934326172    <\/span>  <\/span> <\/span>kriscv-lh<\/font><\/p>\n

D:                                                          <\/span>                <\/span> <\/span>0        <\/span>kriscv-lh<\/font><\/p>\n

 <\/font><\/p>\n

Notice I am running the command on 2 machines and running select-object cmdlet on the local box to filter the data. <\/font><\/p>\n

 <\/font><\/p>\n

There are so many things I want to talk about this CTP which I will do in the coming weeks. For the time being install the CTP, try out our new features and most importantly, if possible, give us your feedback.<\/font><\/p>\n

 <\/font><\/p>\n

Have a great weekend!!<\/font><\/p>\n

 <\/font><\/p>\n

Thanks<\/font><\/p>\n

Krishna Vutukuri[MSFT]<\/font><\/p>\n

Windows PowerShell Development<\/font><\/p>\n

This posting is provided \u201cAS IS\u201d with no warranties.<\/font><\/p>\n","protected":false},"excerpt":{"rendered":"

PowerShell V2 introduces a new capability which allows you to remotely manage machines in your organization. I will give a basic overview of PowerShell remoting here and follow it up with some adavanced topics later. Are you ready for the fun.. A remote interaction involves 2 endpoints \u2013 Client and a Server. The same computer […]<\/p>\n","protected":false},"author":600,"featured_media":13641,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[8],"class_list":["post-6201","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-powershell","tag-remoting"],"acf":[],"blog_post_summary":"

PowerShell V2 introduces a new capability which allows you to remotely manage machines in your organization. I will give a basic overview of PowerShell remoting here and follow it up with some adavanced topics later. Are you ready for the fun.. A remote interaction involves 2 endpoints \u2013 Client and a Server. The same computer […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/6201","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/users\/600"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/comments?post=6201"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/posts\/6201\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media\/13641"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/media?parent=6201"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/categories?post=6201"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/powershell\/wp-json\/wp\/v2\/tags?post=6201"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}