Conditionally specifying switch parameters in PowerShell

Question

I'm writing a PowerShell script that uses the SharePoint 2010 New-SPWeb cmdlet to create sites defined by an Xml file:

<?xml version="1.0" encoding="utf-8" ?>
<siteStructure>
  <site>
    <url>Corporate</url>
    <name>Corporate</name>
    <language>1033</language>
    <addToQuickLaunch>0</addToQuickLaunch>
    <addToTopNav>0</addToTopNav>
    <useParentTopNav>1</useParentTopNav>
  </site>
</siteStructure>

The New-SPWeb cmdlet has three switch parameters:

AddToQuickLaunch
AddToTopNav
UseParentTopNav

I'm having trouble figuring out how to only set the switch parameter when the matching value in the Xml is 0 or $true.

It's almost like I need some sort of inline-if syntax when calling New-SPWeb to set the three switch parameters.

$siteStructureData = [xml](Get-Content .\Data-SiteStructure.xml)

# find the template to use
$webTemplate = Get-SPWebTemplate | Where {$_.Title -like $templateName } 

if ($webTemplate)
{
    # iterate through and create sites
    foreach ($siteToCreate in $siteStructureData.siteStructure.site)
    {   
        "Creating site $webtitle at $URL/$webUrl"

        # http://technet.microsoft.com/en-us/library/ff607579.aspx
        New-SPWeb `
            -Url "$URL/$siteToCreate.url" `
            -Name $siteToCreate.name `
            -Template $webTemplate `
            -Language $siteToCreate.language 
            # set -AddToQuickLaunch
            # set -AddToTopNav
            # set -UseParentTopNav
    }
}
else
{
    throw ("Could not find template $templateName");
}

Many thanks!

Wow! I am doing exactly the same thing! Only nearly 2 years later — Andez, Aug 23 '13 at 09:20

score 24 · Accepted Answer · answered Oct 18 '11 at 14:00

24

Calculate the $result ($true or $false) before:

$result = ...

And use it after:

New-SPWeb `
-Url "$URL/$siteToCreate.url" `
-Name $siteToCreate.name `
-Template $webTemplate `
-Language $siteToCreate.language `
-AddToQuickLaunch:$result `
-AddToTopNav:$result `
-UseParentTopNav:$result

answered Oct 18 '11 at 14:00

Roman Kuzmin

40,627
11
95
117

Thank you, Roman. I wasn't aware of that syntax for switch parameters. – George Durzi Oct 18 '11 at 14:21
Yes, it is not easy to discover... Long time ago I had a problem as well. – Roman Kuzmin Oct 18 '11 at 14:35
Thanks for that... Just discovered in powergui if you put a colon after a parameter, the intellisense lets you know you can specify $true or $false – Andez Aug 23 '13 at 09:31

score 24 · Answer 2 · edited May 23 '17 at 11:47

There is one more way. You can use splatting like this:

$params = @{
            Url = "$URL/$siteToCreate.url"
            Name = $siteToCreate.name
            Template = $webTemplate 
            Language = $siteToCreate.language }
# if needed, add the keys to the hashtable
if ($result) {
    $params.AddToQuickLaunch = $true
    $params.AddToTopNav = $true
    $params.UseParentTopNav = $true
}
# now you just pass the parameters:
New-SPWeb @params

More about splatting:

What does the "@" symbol do in Powershell? http://blogs.msdn.com/b/powershell/archive/2009/01/02/how-and-why-to-use-splatting-passing-switch-parameters.aspx

Conditionally specifying switch parameters in PowerShell

2 Answers2