{"id":4954,"date":"2012-09-19T00:01:00","date_gmt":"2012-09-19T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2012\/09\/19\/use-powershell-to-create-intelligent-default-values\/"},"modified":"2012-09-19T00:01:00","modified_gmt":"2012-09-19T00:01:00","slug":"use-powershell-to-create-intelligent-default-values","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-powershell-to-create-intelligent-default-values\/","title":{"rendered":"Use PowerShell to Create Intelligent Default Values"},"content":{"rendered":"

Summary<\/b>: Windows PowerShell 3.0 introduces the PSDefaultParameterValues automatic variable, which permits creating custom default values.<\/p>\n

Microsoft Scripting Guy, Ed Wilson, is here. Life is returning to normal—at least for this week. Next week, the Scripting Wife and I head north where I will be speaking at the Central Ohio PowerShell User Group<\/a> (COPUG) on October 2, 2012. There are only a few tickets left for this free event, so if you are in the area and you want to catch up with us while we are there, you will need to register soon.<\/p>\n

For today, I am sitting at my desk, checking email, and sipping a nice cup of Gunpowder Green Tea with a bit of lemon grass and a cinnamon stick for sweetness. Outside, there has been a cool steady drizzle of rain, and the wind has been whistling through the trees causing the leaves to rustle like crinolines on prom night.<\/p>\n

Finding custom Windows PowerShell default values<\/h2>\n

In Windows PowerShell 3.0, a new automatic variable exists called PSDefaultParameterValues<\/b>. This variable is shown here.<\/p>\n

PS C:\\> Get-Variable PSDefaultParameterValues<\/p>\n

 <\/p>\n

Name                           Value<\/p>\n

—-                           —–<\/p>\n

PSDefaultParameterValues       {}<\/p>\n

As you can see, the value of the PSDefaultParameterValues <\/b>automatic variable accepts an object. This information also appears in Get-Member<\/b>.<\/p>\n

PS C:\\> Get-Variable PSDefaultParameterValues | Get-Member  -Name value<\/p>\n

 <\/p>\n

   TypeName: System.Management.Automation.PSVariable<\/p>\n

 <\/p>\n

Name  MemberType Definition<\/p>\n

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

Value Property   System.Object Value {get;set;}<\/p>\n

Note<\/b>   Remember that when setting a value or retrieving a value for a variable, the dollar sign ($) identifies the variable. But when using cmdlets such as Get-Variable<\/b>, Set-Variable<\/b>, or New-Variable<\/b>, the dollar sign does not come into play. This is because the dollar sign is not actually part of the variable name.<\/p>\n

Setting custom Windows PowerShell default values<\/h2>\n

So what good is the PSDefaultParameterValues<\/b> automatic variable? Suppose I have a cmdlet that I use on a regular basis, and every time I use the cmdlet, I am typing the same parameter values. A useful example of this might be if I use the Send-MailMessage<\/b> cmdlet to send mail notifications from scripts—I would typically use the same SMTP server for each calling of the cmdlet. In fact, this scenario appears in about_Parameters_Default_Values<\/a> in the Microsoft TechNet Library.<\/p>\n

To set a default value for a cmdlet, I essentially use a hash table.<\/p>\n

Note<\/b>   If you have not noticed, hash tables are really important. To move beyond basic Windows PowerShell techniques, you need to know how to create a hash table. See this collection of Hey, Scripting Guy! Blogs<\/a> for more information about creating and using hash tables.<\/p>\n

The syntax to assign a new default value is shown here.<\/p>\n\n\n\n\n
\n

  @<\/p>\n<\/td>\n

\n

  {<\/p>\n<\/td>\n

\n

Cmdlet name<\/p>\n<\/td>\n

\n

  :<\/p>\n<\/td>\n

\n

  Parameter Name<\/p>\n<\/td>\n

\n

  =<\/p>\n<\/td>\n

\n

  Value<\/p>\n<\/td>\n

\n

  }<\/p>\n<\/td>\n<\/tr>\n

\n

  @<\/p>\n<\/td>\n

\n

  {<\/p>\n<\/td>\n

\n

“Get-Process<\/p>\n<\/td>\n

\n

  :<\/p>\n<\/td>\n

\n

  Name”<\/p>\n<\/td>\n

\n

  =<\/p>\n<\/td>\n

\n

  “Explorer”<\/p>\n<\/td>\n

\n

  }<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

In the following example, I create a default value for the Name<\/b> parameter of the Get-Process<\/b> cmdlet. This permits me to quickly find information about the Explorer<\/b> <\/i>process.<\/p>\n

$PSDefaultParameterValues = @{“Get-Process:name”=”explorer”}<\/p>\n

Now when I run the Get-Process<\/b> cmdlet, it only returns information about the E<\/strong>xplorer<\/b> <\/i>process. I can override this by using a wildcard character. This technique is shown here.<\/p>\n

gps *<\/p>\n

The commands and the output associated with the commands are shown in the image that follows.<\/p>\n

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

If I open a new Windows PowerShell console, the new defaults do not apply. To change the default behavior of a cmdlet, function, or advanced function that happens every time I open the Windows PowerShell console or Windows PowerShell ISE, I need to add the command to my Windows PowerShell profile.<\/p>\n

            Note<\/b>   For more information about profiles, see this collection of Hey, Scripting Guy! Blogs<\/a>.<\/p>\n

That is all there is to creating and to using custom default values in Windows PowerShell 3.0. Join me tomorrow for more cool Windows PowerShell 3.0 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<\/b> <\/p>\n","protected":false},"excerpt":{"rendered":"

Summary: Windows PowerShell 3.0 introduces the PSDefaultParameterValues automatic variable, which permits creating custom default values. Microsoft Scripting Guy, Ed Wilson, is here. Life is returning to normal—at least for this week. Next week, the Scripting Wife and I head north where I will be speaking at the Central Ohio PowerShell User Group (COPUG) on October 2, […]<\/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,364,3,4,45],"class_list":["post-4954","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-getting-started","tag-powershell-3-0","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell"],"acf":[],"blog_post_summary":"

Summary: Windows PowerShell 3.0 introduces the PSDefaultParameterValues automatic variable, which permits creating custom default values. Microsoft Scripting Guy, Ed Wilson, is here. Life is returning to normal—at least for this week. Next week, the Scripting Wife and I head north where I will be speaking at the Central Ohio PowerShell User Group (COPUG) on October 2, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/4954","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=4954"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/4954\/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=4954"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=4954"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=4954"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}