{"id":3138,"date":"2013-07-30T00:01:00","date_gmt":"2013-07-30T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2013\/07\/30\/learn-how-to-configure-powershell-memory\/"},"modified":"2013-07-30T00:01:00","modified_gmt":"2013-07-30T00:01:00","slug":"learn-how-to-configure-powershell-memory","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/learn-how-to-configure-powershell-memory\/","title":{"rendered":"Learn How to Configure PowerShell Memory"},"content":{"rendered":"

Summary<\/strong>: Microsoft Scripting Guy, Ed Wilson, talks about how to configure Windows PowerShell memory availability for specialized applications.<\/span><\/p>\n

\"Hey, Hey, Scripting Guy! I really need your help. We are doing something that perhaps Windows PowerShell cannot do. At least, this is the way it seems. We have a huge file share, and we are parsing through it with a series of <\/span>Select-String<\/strong> commands to find specific types of things. We are using <\/span>Get-ChildItem<\/strong> to obtain files for us to parse, and we have filtered it out as much as is possible. The thing is, that when I say huge, I mean really, really huge. Absolutely GINORMOUS type of huge.<\/span><\/p>\n

Anyway, we are perfectly resigned to the fact that Windows PowerShell will take some time to go through this parsing effort, and we have obviously tested everything on mock (much smaller) data prior to turning this thing loose. The problem is that Windows PowerShell runs for an hour or so, and then it stops with a System.OutOfMemoryException error message. It is bad enough that it happens, but it is horrible that it takes so long to occur. We make changes, reboot the server, wait for another hour, and boom!—it happens again. We have spent an entire week trying to make this work, and you are our last hope. I searched the Hey, Scripting Guy! blog, but I did not find anything helpful. So now’s your chance to be a real hero.<\/p>\n

—AP<\/p>\n

\"Hey, Hello AP,<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. Today is a great day. I got up, and fixed some nice English Breakfast tea with a bit of organic orange rind, some peppermint and spearmint leaves, a bit of crushed cinnamon stick, and a touch of lemon grass. I must say, it is a very refreshing cup of tea. Yesterday I had an awesome session with my mentee, Ashley McGlone. I am real proud of everything he has accomplished so far. So the week is going along perfectly. I am looking forward to this Thursday (August 1, 2013). We are having the Windows PowerShell User Group meeting in Charlotte, North Carolina. It will be awesome. With everything moving along smoothly, I thought I would take some time to try to catch up a bit with questions such as yours that are emailed to scripter@microsoft.com<\/a>.<\/p>\n

Configuring memory for Windows PowerShell<\/h2>\n

To configure memory resources for Windows PowerShell, you must launch Windows PowerShell with Admin rights. If you attempt to do anything on the WSMAN: drive as a normal user, you will receive the following “Access is denied” error message:<\/p>\n

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

In addition to Admin rights, the WinRM service must be running. In Windows PowerShell 3.0 in Windows 8, this service starts on demand. Therefore, the first attempts to access the WinRM drive will result in a prompt to start the WinRM service. I use the Get-Service<\/strong> cmdlet to ensure that everything started properly:<\/p>\n

PS C:\\> get-service *win*<\/p>\n

Status   Name               DisplayName<\/p>\n

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

Running  WinDefend          Windows Defender Service<\/p>\n

Running  WinHttpAutoProx… WinHTTP Web Proxy Auto-Discovery Se..<\/p>\n

Running  Winmgmt            Windows Management Instrumentation<\/p>\n

Running  WinRM              Windows Remote Management (WS-Manag..<\/p>\n

Check and set the machine-wide setting<\/h2>\n

The first thing to do is to check and set the machine-wide memory setting. To do this, I navigate to WsMan:\\Localhost\\Shell in my Windows PowerShell console. I then use the Get-ChildItem<\/strong> cmdlet (dir<\/strong> is alias) to see my settings for everything. This is shown here:<\/p>\n

PS C:\\> sl WSMan:\\localhost\\Shell<\/p>\n

PS WSMan:\\localhost\\Shell> dir<\/p>\n

 <\/p>\n

   WSManConfig: Microsoft.WSMan.Management\\WSMan::localhost\\Shell<\/p>\n

 <\/p>\n

Type            Name                           SourceOfValue   Value<\/p>\n

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

System.String   AllowRemoteShellAccess                         true<\/p>\n

System.String   IdleTimeout                                    7200000<\/p>\n

System.String   MaxConcurrentUsers                             10<\/p>\n

System.String   MaxShellRunTime                                2147483647<\/p>\n

System.String   MaxProcessesPerShell                           25<\/p>\n

System.String   MaxMemoryPerShellMB                            1024<\/p>\n

System.String   MaxShellsPerUser                               30<\/p>\n

Set MaxMemoryPerShellMB<\/h2>\n

To make the change, I use the Set-Item<\/strong> cmdlet and change the value of MaxMemoryPerShellMB from 1 GB to 2 GB. This technique is shown here:<\/p>\n

Set-Item .\\MaxMemoryPerShellMB 2048<\/p>\n

Now I use the Up arrow and change Get-Item<\/strong> to Set-Item<\/strong>. This command and its output are shown here:<\/p>\n

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

Note <\/strong> I am already in WsMan:\\LocalHost\\Shell when I run the Set-Item<\/strong> command. If you do not want to navigate to the folder first, you can use this command:<\/p>\n

Set-Item WSMan:\\localhost\\Shell\\MaxMemoryPerShellMB 2048<\/strong><\/p>\n

I notice that a warning appears that states I also need to change memory settings for plug-ins. (This is true in Windows PowerShell 3.0.) Therefore, I navigate to the plug-ins directory to make those changes. But before I make any changes, I notice there are several plug-ins listed:<\/p>\n

PS WSMan:\\localhost\\Plugin> dir<\/p>\n

   WSManConfig: Microsoft.WSMan.Management\\WSMan::localhost\\Plugin<\/p>\n

 <\/p>\n

Type            Keys                                Name<\/p>\n

—-            —-                                —-<\/p>\n

Container       {Name=Event Forwarding Plugin}      Event Forwarding Plugin<\/p>\n

Container       {Name=microsoft.powershell}         microsoft.powershell<\/p>\n

Container       {Name=microsoft.powershell.workf… microsoft.powershell.workflow<\/p>\n

Container       {Name=microsoft.powershell32}       microsoft.powershell32<\/p>\n

Container       {Name=microsoft.windows.serverma… microsoft.windows.servermanag…<\/p>\n

Container       {Name=WMI Provider}                 WMI Provider<\/p>\n

The thing that is confusing is that I need to make a memory change for each plug-in endpoint configuration that I target from the client. Luckily, I happen to know that the default Windows PowerShell endpoint is Microsoft.PowerShell, and that is the only one I need to change. I type the following command:<\/p>\n

Set-Item .\\microsoft.powershell\\Quotas\\MaxConcurrentCommandsPerShell 2048<\/p>\n

The command results in a warning that states I need to restart WinRM and that the value for the plug-in will only work if it is less than or equal to the value for the global memory setting. Here is the command and the output:<\/p>\n

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

Note <\/strong> I was in the Wsman:\\LocalHost\\Plugin directory when I ran the command to set the memory for the plug-in. If you do not want to navigate to the location, use this command instead:<\/p>\n

Set-Item WSMan:\\localhost\\Plugin\\Microsoft.PowerShell<\/strong>\\Quotas\\MaxMemoryPerShellMB 2048<\/strong><\/p>\n

I use the Get-Item<\/strong> cmdlet to ensure that the new value took. Here is the command I use:<\/p>\n

PS WSMan:\\localhost\\Plugin> get-Item .\\microsoft.powershell\\Quotas\\MaxMemoryPerShellMB<\/p>\n

 <\/p>\n

   WSManConfig:<\/p>\n

Microsoft.WSMan.Management\\WSMan::localhost\\Plugin\\microsoft.powershell\\Quotas<\/p>\n

 <\/p>\n

Type            Name                           SourceOfValue   Value<\/p>\n

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

System.String   MaxMemoryPerShellMB                            2048<\/p>\n

Restart the WinRM service<\/h2>\n

Now I need to restart the WinRM service. To do this, I use the Restart-Service<\/strong> cmdlet. The command is shown here:<\/p>\n

Restart-Service winrm<\/p>\n

Just for fun, I close the Windows PowerShell console, and then reopen it. I rerun my Get-Item<\/strong> commands to see if anything has reverted. As indicated in the image that follows, everything is groovy.<\/p>\n

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

AP, that is all there is to using the WSMAN drive to configure Windows PowerShell memory. Join me  tomorrow when I will talk about more cool stuff.<\/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: Microsoft Scripting Guy, Ed Wilson, talks about how to configure Windows PowerShell memory availability for specialized applications.  Hey, Scripting Guy! I really need your help. We are doing something that perhaps Windows PowerShell cannot do. At least, this is the way it seems. We have a huge file share, and we are parsing through […]<\/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":[362,3,4,45],"class_list":["post-3138","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-powershell-3","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Microsoft Scripting Guy, Ed Wilson, talks about how to configure Windows PowerShell memory availability for specialized applications.  Hey, Scripting Guy! I really need your help. We are doing something that perhaps Windows PowerShell cannot do. At least, this is the way it seems. We have a huge file share, and we are parsing through […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/3138","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=3138"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/3138\/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=3138"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=3138"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=3138"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}