{"id":16701,"date":"2010-10-26T00:01:00","date_gmt":"2010-10-26T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2010\/10\/26\/learn-how-to-use-net-framework-commands-inside-windows-powershell\/"},"modified":"2010-10-26T00:01:00","modified_gmt":"2010-10-26T00:01:00","slug":"learn-how-to-use-net-framework-commands-inside-windows-powershell","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/learn-how-to-use-net-framework-commands-inside-windows-powershell\/","title":{"rendered":"Learn How to Use .NET Framework Commands inside Windows PowerShell"},"content":{"rendered":"

 <\/p>\n

Summary:<\/b> Microsoft Scripting Guy Ed Wilson shows how to use .NET Framework commands inside Windows PowerShell<\/p>\n

 <\/p>\n

\"Hey,Hey, Scripting Guy! I understand that Windows PowerShell is built upon the .NET Framework. I also get the idea that some of the Windows PowerShell cmdlets are simply calling things from the .NET Framework in the background. But what good is that to me? Why do I care?<\/p>\n

— HB<\/p>\n

 <\/p>\n

\"Hey,Hello HB, Microsoft Scripting Guy Ed Wilson here.<\/p>\n

Yesterday<\/a> we looked at the fundamental concepts of the .NET Framework, and explored the System.Diagnostics.Process<\/b> .NET Framework class. <\/p>\n

By using the static GetProcesses<\/b> method, a listing of all the processes and their top properties is obtained. When you call a .NET Framework class, the System<\/b> part of the namespace can be left off as it is assumed. Therefore, with the System.Diagnostics.Process<\/b> class, System.Diagnostics<\/b> is the namespace, and Process<\/b> is the actual class name. When I leave the System<\/b> portion off the namespace name the command morphs to the one shown here.<\/p>\n

[diagnostics.process]::GetProcesses()<\/span><\/p><\/blockquote>\n

The output from this command is seen in the figure below.<\/p>\n

<\/p>\n

 <\/p>\n

The output shown in this figure is very extensive and provides a useful overview of the way the system is performing. It is so useful the Windows PowerShell team has incorporated it into the Get-Process<\/b> cmdlet. To use the Get-Process<\/b> cmdlet you just have to type the command on Windows PowerShell console command line as seen here.<\/p>\n

Get-Process<\/span><\/p><\/blockquote>\n

The output from the Get-Process<\/b> command is shown in the following figure.<\/p>\n

<\/p>\n

 <\/p>\n

The output from the Get-Process<\/b> cmdlet and the [diagnostics.process]::GetProcesses()<\/b> are equivalent. The difference is that Get-Process<\/b> alphabetizes the output by process name and [diagnostics.process]::GetProcesses()<\/b> does not. <\/p>\n

The point of this exercise is to show that Windows PowerShell is a .NET Framework application. You do not have to type [diagnostics.process]::GetProcesses()<\/b> because that is the essence of Get-Process. In fact, if I pipeline Get-Process<\/b> to the Get-Member<\/b> cmdlet, I can see that the System.Diagnostics.Process<\/b> class is returned by the command. The command to do this is shown here.<\/p>\n

Get-Process | Get-Member<\/span><\/p><\/blockquote>\n

As we saw yesterday, there are an awful lot of methods and properties exposed by System.Diagnostics.Process<\/b>. The output is shown in the figure below.<\/p>\n

<\/p>\n

 <\/p>\n

Using the .NET Framework Process<\/b> class, from the System.Diagnostics<\/b> namespace, I can use the static method GetProcessByName<\/b>. If I am not certain how to use the method, I can pipeline the class to Get-Member<\/b>, specify I want to see the static method getProcessbyname<\/b> and output the returned information to the format-list<\/b> cmdlet. When I do this, the output seen here appears. <\/p>\n

PS C:\\> [diagnostics.process] | gm -s getProcessesbyname | fl *<\/p>\n

TypeName   : System.Diagnostics.Process
Name       : GetProcessesByName
MemberType : Method
Definition : static System.Diagnostics.Process[] GetProcessesByName(string processName), static Sys
             tem.Diagnostics.Process[] GetProcessesByName(string processName, string machineName)<\/p>\n

PS C:\\><\/span><\/p><\/blockquote>\n

The output seen earlier tells me that I have to provide either a process name or a process name and a computer name to the method. By using that information, I can return information about the explorer process. This is seen here.<\/p>\n

PS C:\\> [diagnostics.process]::GetProcessesByName(“explorer”)<\/p>\n

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
——-  ——    —–      —– —–   ——     — ———–
   1084      80    99332     120468   447    13.90   3620 explorer<\/p>\n

PS C:\\><\/span><\/p><\/blockquote>\n

We see the same subset of information that was returned by the Get-Process<\/b> Windows PowerShell cmdlet. We know now, that additional information would be available … the information such as seen in the previous figure. <\/p>\n

Remember back when we were looking at the member information for the GetProcessesByName<\/b> method? There was an alternative way of calling the method that would accept both a process name and a computer name as parameters. If I wanted to use the process<\/b> .NET Framework class to retrieve process information from a remote computer back in the Windows PowerShell days, this was the way to do it. (Of course, there was also the Win32_Process<\/b> WMI class that was available also). To use the process class and specify a computer name, use the syntax seen here (The output is shown under the command).<\/p>\n

PS C:\\> [diagnostics.process]::GetProcessesByName(“explorer”, “localhost”)<\/p>\n

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
——-  ——    —–      —– —–   ——     — ———–
   1488      96   141128     153208   589            3620 explorer<\/span><\/p><\/blockquote>\n

 <\/p>\n

In Windows PowerShell 2.0 the Get-Process<\/b> cmdlet was upgraded to accept a computername<\/i> parameter. This command and associated output is shown here.<\/p>\n

PS C:\\> Get-Process -Name explorer -ComputerName localhost<\/p>\n

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
——-  ——    —–      —– —–   ——     — ———–
   1478      95   140644     152968   587            3620 explorer<\/p>\n

PS C:\\><\/span><\/p><\/blockquote>\n

By comparing the output from the two previous commands, you can see that the output is virtually the same. This shows that the .NET Framework class GetProcessByName<\/b> <\/i>method is behind the name parameter that is used by the Get-Process<\/b> cmdlet. <\/p>\n

Not all the methods and properties exposed through the System.Diagnostics.Process<\/b> .NET Framework class are exposed through a switch or a parameter of the Get-Process<\/b> Windows PowerShell cmdlet. This is where knowing a bit about the underlying .NET Framework classes comes into play. For example, if I want to change the processor affinity of a particular process that is running on a computer, all I have to do is to use Get-Process<\/b> to retrieve the process, and then assign a new value to the ProcessorAffinity<\/b> property. This is illustrated here where I first launch a new instance of notepad. I then use Get-Process<\/b> to retrieve the notepad process to make sure it is working correctly. After confirming that it works, I again use the Get-Process<\/b> Windows PowerShell cmdlet to retrieve the notepad process, and I store it in the $a<\/i> variable. I then query the ProcessorAffinity<\/b> property and see that the notepad process has a processor affinity of 3. <\/p>\n

PS C:\\> notepad
PS C:\\> Get-Process notepad<\/p>\n

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
——-  ——    —–      —– —–   ——     — ———–
     67       7     1524       5416    71     0.03   6236 notepad<\/p>\n

PS C:\\> $a = Get-Process notepad
PS C:\\> $a.ProcessorAffinity
3
PS C:\\> $a.ProcessorAffinity = 0x0002
PS C:\\> $a.ProcessorAffinity
2<\/span><\/p><\/blockquote>\n

HB, that is all there is to using the .NET Framework Process<\/b> class. Exploring .NET Framework week will continue tomorrow when we will talk about how to work with the .NET Framework classes. <\/p>\n

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

 <\/p>\n

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

  Summary: Microsoft Scripting Guy Ed Wilson shows how to use .NET Framework commands inside Windows PowerShell   Hey, Scripting Guy! I understand that Windows PowerShell is built upon the .NET Framework. I also get the idea that some of the Windows PowerShell cmdlets are simply calling things from the .NET Framework in the background. […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[66,51,31,87,3,4,45],"class_list":["post-16701","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-net-framework","tag-getting-started","tag-operating-system","tag-processes","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

  Summary: Microsoft Scripting Guy Ed Wilson shows how to use .NET Framework commands inside Windows PowerShell   Hey, Scripting Guy! I understand that Windows PowerShell is built upon the .NET Framework. I also get the idea that some of the Windows PowerShell cmdlets are simply calling things from the .NET Framework in the background. […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/16701","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\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=16701"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/16701\/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=16701"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=16701"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=16701"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}