{"id":3673,"date":"2013-05-08T00:01:00","date_gmt":"2013-05-08T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2013\/05\/08\/i-found-this-powershell-functionnow-what-do-i-do-part-1\/"},"modified":"2013-05-08T00:01:00","modified_gmt":"2013-05-08T00:01:00","slug":"i-found-this-powershell-functionnow-what-do-i-do-part-1","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/i-found-this-powershell-functionnow-what-do-i-do-part-1\/","title":{"rendered":"I Found this PowerShell Function—Now What Do I Do? Part 1"},"content":{"rendered":"

Summary<\/strong>: A reader found needed code, but it is contained in a function. Microsoft Scripting Guy, Ed Wilson, provides the scoop about how to use functions.<\/span><\/p>\n

\"Hey, Hey, Scripting Guy! I have some experience with scripting—primarily VBScript script. I also have written a lot of batch files. But recently, I have begun to learn Windows PowerShell by reading your column and by watching some of your videos. What I am confused about is Windows PowerShell functions—I do not know what to do with them. Can you help?<\/p>\n

—JB<\/p>\n

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

Microsoft Scripting Guy, Ed Wilson, is here. We had a great SQL Server Week, and the Scripting Games are still going strong. The Scripting Wife has been doing well in the 2013 Scripting Games, and now she busy getting ready for TechEd 2013 in New Orleans. She is already planning excursions to get beignets<\/a> and pralines<\/a>.<\/p>\n

There are several ways to use a Windows PowerShell function. The way you anticipate using a Windows PowerShell function will determine what you will do with the function after you have it. As an example, I am going to use the <\/span>Set-ScreenResolution function<\/a>, which was written by Andy Schneider. Teresa and I had a chance to catch up with Andy at the Windows PowerShell Summit where he gave a great talk for IT pros about source control. Here is a picture of Andy during his presentation.<\/span><\/p>\n

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

Probably the easiest way to use a function is in a Windows PowerShell script, in much the same way that you used to use functions and subroutines back in the VBScript days. I will talk about this functionality today, and I will discuss the other methodologies next week.<\/p>\n

Copy and paste the function directly into your script<\/h2>\n

When I go to the Scripting Guys Script repository, and I find Andy’s Set-ScreenResolution<\/strong> function, all I need to do is use the control from the Script Repository and copy it to my clipboard. This technique is shown here.<\/p>\n

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

Therefore, if I want the “run the script so it does stuff” option, it is easiest to copy the function to the clipboard, open the Windows PowerShell ISE, and paste the function at the top. This is shown here:<\/p>\n

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

If I run my script right now, it will appear that nothing is happening because there is no code that calls the function. If I drop down to the interactive Windows PowerShell prompt (the bottom blue pane) and type the name of the function, I can actually call the function as shown here.<\/p>\n

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

The solution is to add a line at the bottom of the script that contains the function that calls the function and passes values for the two required parameters: height and width. Here is the modification,<\/p>\n

Set-ScreenResolution -Width 800 -Height 600<\/p>\n

This is shown here:<\/p>\n

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

So now, if I run the script, it will automatically change the screen resolution on my primary monitor to 800×600.<\/p>\n

Running the script with the function<\/h2>\n

There are several ways to run the script that contains the Set-ScreenResolution<\/strong> function. Depending on your needs, you may decide one is better than the other.<\/p>\n

Open in Windows PowerShell ISE and run it<\/h3>\n

The first way is to open the script in the Windows PowerShell ISE, and click the green triangle on the tool bar (press F5) to run the script. I use this technique in the following circumstances:<\/p>\n