{"id":564,"date":"2011-11-03T17:28:39","date_gmt":"2011-11-03T22:28:39","guid":{"rendered":"http:\/\/osric.com\/chris\/accidental-developer\/?p=564"},"modified":"2013-02-19T09:15:32","modified_gmt":"2013-02-19T14:15:32","slug":"updating-a-sharepoint-pages-page-layout-using-powershell","status":"publish","type":"post","link":"https:\/\/osric.com\/chris\/accidental-developer\/2011\/11\/updating-a-sharepoint-pages-page-layout-using-powershell\/","title":{"rendered":"Updating a SharePoint page’s Page Layout using PowerShell"},"content":{"rendered":"

Earlier today I tried to update the page layout on a SharePoint 2010 site via the browser, which produced an error. I looked up the error’s correlation ID in the ULS logs and found this:
\nGetFileFromUrl: ArgumentException when attempting get file Url https:\/\/oldsitename\/webname\/_catalogs\/masterpage\/Block.aspx Value does not fall within the expected range.<\/code><\/p>\n

I couldn’t change the page layout via the browser. I couldn’t change the page layout via SharePoint Designer.<\/p>\n

Fortunately, I found Patrick Lamber’s helpful post, How to programmatically change the page template in Moss 2007<\/a>, which basically described the same error and described applying a new page layout via the object model.<\/p>\n

For whatever reason, I thought I could do it just as easily via PowerShell. I started following Jason Grimme’s post, Update SharePoint List Item(s) with Powershell<\/a>, but I was unable to check-out\/check-in the page or access the PublishingPageLayout<\/em> property.<\/p>\n

Liam Cleary’s reply on a TechNet post (Using PowerShell to Checkout and Checkin a file<\/a>) tipped me off that I needed to use SPFile (rather than SPListItem) in order to perform the necessary operations. Here are the commands I ended up using:<\/p>\n

$spWeb = Get-SPWeb(\"http:\/\/currentsitename\/webname\")
\n$spFile = $spWeb.GetFile(\"http:\/\/currentsitename\/webname\/Pages\/Test-Page.aspx\")
\n$spFile.CheckOut(\"Online\",$null)
\n$spFile.Properties[\"PublishingPageLayout\"] = \"\/_catalogs\/masterpage\/Block.aspx, Block\"
\n$spFile.Update()
\n$spFile.CheckIn(\"Update page layout via PowerShell\",[Microsoft.SharePoint.SPCheckinType]::MajorCheckIn)
\n$spWeb.Dispose()<\/code><\/p>\n

I visited the page and…another error! This one telling me there wasn’t a valid page layout. Funny, it worked in development.<\/p>\n

It turns out, when I compared it to the PublishingPageLayout<\/em> property of a working page, I had missed the space character after the comma.<\/p>\n

Doesn’t work:<\/strong>
\n\"\/_catalogs\/masterpage\/Block.aspx,Block\"<\/code><\/p>\n

Works:<\/strong>
\n\"\/_catalogs\/masterpage\/Block.aspx, Block\"<\/code><\/p>\n

Once I applied the proper path, I was also able to change the page layout via the browser again.<\/p>\n","protected":false},"excerpt":{"rendered":"

Earlier today I tried to update the page layout on a SharePoint 2010 site via the browser, which produced an error. I looked up the error’s correlation ID in the ULS logs and found this: GetFileFromUrl: ArgumentException when attempting get file Url https:\/\/oldsitename\/webname\/_catalogs\/masterpage\/Block.aspx Value does not fall within the expected range. I couldn’t change the … Continue reading Updating a SharePoint page’s Page Layout using PowerShell<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[180],"tags":[228,160,211],"class_list":["post-564","post","type-post","status-publish","format-standard","hentry","category-sharepoint-2","tag-powershell","tag-sharepoint","tag-sharepoint-2010"],"_links":{"self":[{"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/posts\/564","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/comments?post=564"}],"version-history":[{"count":7,"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/posts\/564\/revisions"}],"predecessor-version":[{"id":918,"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/posts\/564\/revisions\/918"}],"wp:attachment":[{"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/media?parent=564"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/categories?post=564"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/osric.com\/chris\/accidental-developer\/wp-json\/wp\/v2\/tags?post=564"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}