PowerShell and SharePoint

PowerShell and SharePoint
Talbott Crowell
April 28, 2012
SharePoint Saturday Boston #SPSBOS

http://www.thirdm.com
@talbott

What is PowerShell?
• Unix-like shell
• Object oriented
• .NET
• Command line
• Scripting language

www.sharepointsaturday.org/boston::WEB
http://www.thirdm.com WEB
http://talbottcrowell.wordpress.com::EMAIL
SPSBoston@live.com BLOG
@talbott : TWITTER
@SPSBoston / #SPSBos : TWITTER

Why PowerShell for SharePoint?
• Automated build and deploy
• Rapid prototyping
• Exploring “What If” scenarios
• Developer onboarding
• Administration automation

@talbott : TWITTER

When use PowerShell?
• When you want to make your team more agile
– Automation, automation, automation
• When developing, your daily build is like the
projects heartbeat
– PowerShell can be the pacemaker
• Testing
– Use the PowerShell scripts to stand up an
environment for running tests

@talbott : TWITTER

PowerShell Basics
• What do you know about a command line?
– DIR
• How about
– $a = DIR
• What is $a?
– .NET Object
• use gm or get-member to query properites
– Array
• $a[0]

@talbott : TWITTER

Demo - Basics
• PowerShell Basics
– $a = DIR
– $a | gm
– Dates

@talbott : TWITTER

Tools
• cmd, notepad
• PowerShell Command
• Windows PowerShell Integrated Scripting
Environment (ISE)
– Import-Module ServerManager;
– Add-WindowsFeature PowerShell-ISE
• PowerGUI
– Download from powergui.org
@talbott : TWITTER

More Basics
• # for comment
• Verb-Noun convention for commandlets
• Write-Host “Hello World”
• Set-ExecutionPolicy Unrestricted
• .scriptname to execute

@talbott : TWITTER

SharePoint 2010
• Comes with PowerShell Commandlets
– Get-SPSite
– New-SPSite
– New-SPWeb
• If you are running from standard PowerShell
Add-PSSnapin microsoft.sharepoint.powershell
-ErrorAction SilentlyContinue

@talbott : TWITTER

Create Site Collections and Sites
• Get-SPSite
– Parameter: url
• New-SPSite
– Parameters: url, name, ownerAlias, template
• New-SPWeb
– Parameters: url, name, description, template…
– Other params:
• -AddToTopNav or -UseParentTopNav
• -AddToQuickLaunch

@talbott : TWITTER

What about MOSS 2007 or WSS?
• Your friend STSADM is still there
• You can call STSADM or any command line tool from
PowerShell
• You can write your own command line tools with .NET
• Better yet, you can write your own PowerShell
Commandlets!
– Inherit from Cmdlet or PSCmdlet
• Gary Lapointe has WSS and MOSS Cmdlets!
– http://stsadm.blogspot.com/2009/02/downloads.html

@talbott : TWITTER

Creating SharePoint 2010 Cmdlets
• When creating non-persistent tasks (i.e. get info) use:
– SPCmdlet
• When objects persist between commands, use:
– SPRemoveCmdletBase
– SPNewCmdletBase
– SPSetCmdletBase
– SPGetCmdletBase
• For more info, see Gary Lapointe’s blog post:
– http://stsadm.blogspot.com/2009/10/creating-custom-
sharepoint-2010-cmdlets.html
@talbott : TWITTER

Creating SharePoint Objects
• [void][System.Reflection.Assembly]::LoadWithPar
tialName(”Microsoft.SharePoint”)
– Load the assembly
• $SPSite = New-Object
Microsoft.SharePoint.SPSite($url)
– Reference to the site collection using SharePoint
object model
• Don’t forget to
– $SPSite.Dispose()
@talbott : TWITTER

Strategy
• Series of scripts to build your site
• Cleanup script to destroy site
• Edit script, run cleanup, run script, view site
– Repeat

@talbott : TWITTER

Demo – series of scripts
• Build2010.ps1
– Calls other scripts
• Build2010_site_structure.ps1
– Sets up the basic site structure and content types
• Build2010_upload_file.ps1
– Uploads sample files to the site
• Build2010_set_logo.ps1
– Adds site logo
• Build2010_add_users.ps1
– Adds users to local machine and/or SharePoint groups

@talbott : TWITTER

Defining functions
• function Get-Theme
([Microsoft.SharePoint.SPWeb]$SPWeb,
[string]$themeName)
• Strong typed parameters
• Returns
Microsoft.SharePoint.Utilities.ThmxTheme

@talbott : TWITTER

Iteration Style Scripts
• Upload File
– Takes in 1 or more files
• Has 3 blocks
– Begin
– Process
– End
• Process is executed for each file
• gci 'C:uploadfilesSamplesLegal' |
.build2010_upload_file.ps1 -Location "shared/legal" -
DocLib "Documents" -ContentType "Document" -
MetaDataField "Dept" -MetaDataValue "Legal"
@talbott : TWITTER

Other References
• How to: Build a SharePoint 2010 PowerShell Cmdlet
– http://silverlight.sys-con.com/node/1370916

@talbott : TWITTER

Thank you. Questions?
PowerShell and SharePoint

Talbott Crowell
ThirdM.com
http://talbottcrowell.wordpress.com/
Twitter: @talbott

PowerShell and SharePoint

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to PowerShell and SharePoint

Similar to PowerShell and SharePoint (20)

More from Talbott Crowell

More from Talbott Crowell (17)

Recently uploaded

Recently uploaded (20)

PowerShell and SharePoint