{"id":17031,"date":"2010-09-23T00:01:00","date_gmt":"2010-09-23T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2010\/09\/23\/use-powershell-cmdlets-to-manage-sharepoint-document-libraries\/"},"modified":"2010-09-23T00:01:00","modified_gmt":"2010-09-23T00:01:00","slug":"use-powershell-cmdlets-to-manage-sharepoint-document-libraries","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/use-powershell-cmdlets-to-manage-sharepoint-document-libraries\/","title":{"rendered":"Use PowerShell Cmdlets to Manage SharePoint Document Libraries"},"content":{"rendered":"

 \nSummary<\/strong>: Management of SharePoint 2010 document libraries by using Windows PowerShell cmdlets is explored in this Hey, Scripting Guy! Blog post.\n \n\"Hey, Hey, Scripting Guy! Please tell me about document management with SharePoint and Windows PowerShell.\n— MK\n \n\"Hey, Hello MK,\nMicrosoft Scripting Guy Ed Wilson here. It is Thursday in Charlotte, North Carolina, and our last day with guest blogger Niklas Goude, who has been sharing his expertise with SharePoint and Windows PowerShell all week.\nNiklas Goude is a Windows PowerShell MVP working at Enfo Zipper in Stockholm, Sweden. Niklas has extensive experience in automating and implementing SharePoint environments using Windows PowerShell. He has written a Windows PowerShell book for Swedish IT pros, http:\/\/powershell.se<\/a>, and is currently co-authoring a book with Mattias Karlsson titled, PowerShell for Microsoft SharePoint 2010 Administrators<\/i><\/a>, which will be published in English by McGraw-Hill in October 2010. Parts of this post are taken from Chapter 16 of that book.\nNiklas also runs the blog, http:\/\/powershell.nu<\/a>, where he shares scripts, examples, and solutions for administrative tasks in Windows environments through Windows PowerShell.\n <\/p>\n

Creating Document Libraries<\/h5>\n

Working with document libraries is similar to working with SharePoint lists, as described in yesterday’s post<\/a>. In this post we will create a new document library and see examples of how to upload documents to a document library.\nCreating a new document library using Windows PowerShell is very similar to the creation of any other type of list. We can use the same Add() <\/strong>method provided by the SPListCollection<\/strong> class. In the example below, we use the Get-SPWeb<\/strong> cmdlet to retrieve a specific site, store a TemplateType<\/strong> in a variable, and then use the Add()<\/strong> method to create a new document library:<\/p>\n

PS<\/span> <\/span>><\/span> <\/span>$spWeb<\/span> <\/span>=<\/span> <\/span>Get-SPWeb<\/span> <\/span>-Identity<\/span> <\/span>http:\/\/SPServer<\/span>
<\/span>PS<\/span> <\/span>><\/span> <\/span>$listTemplate<\/span> <\/span>=<\/span> <\/span>[Microsoft.SharePoint.SPListTemplateType]::DocumentLibrary<\/span>
<\/span>PS<\/span> <\/span>><\/span> <\/span>$spWeb<\/span>.Lists.Add(<\/span>“My Documents”<\/span>,<\/span>“My Doc Library”<\/span>,<\/span>$listTemplate<\/span>)<\/span> <\/p>\n<\/blockquote>\n

Modifying a Document Library<\/h5>\n

We can retrieve an existing document library using the GetList()<\/strong> method, just as we did with lists. The only difference is the relative URL used with the method:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$spDocumentLibrary<\/span> <\/span>=<\/span> <\/span>$spWeb<\/span>.GetList(<\/span>“My Documents”<\/span>)<\/span> <\/div>\n<\/blockquote>\n

Next, we can modify the properties of a document library. If we want to change the Description<\/strong>, we can simply type:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$spDocumentLibrary<\/span>.Description<\/span> <\/span>=<\/span> <\/span>“Lots<\/span> <\/span>of<\/span> <\/span>Documents”<\/span> <\/div>\n<\/blockquote>\n

Adding Document Library<\/strong> to Quick Launch is also a simple task when using Windows PowerShell:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$spDocumentLibrary<\/span>.OnQuickLaunch<\/span> <\/span>=<\/span> “True”<\/span> <\/div>\n<\/blockquote>\n

When we’re are done with the updates we use the Update() <\/strong>method to commit the changes.<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$spDocumentLibrary<\/span>.Update()<\/span> <\/div>\n<\/blockquote>\n

SharePoint document libraries may have folders to better organize the contents of the library. These folders can be created using the same AddItem()<\/strong> method just as we did when adding new list items. The difference is that we use another overload definition of this method, which also accepts a value of type Microsoft.SharePoint.SPFileSystemObjectType<\/strong> that instructs it whether the new item is a file or a folder:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$spFolder<\/span> <\/span>=<\/span> <\/span>$spDocumentLibrary<\/span>.AddItem(<\/span>
<\/span>>><\/span> “”<\/span>,[Microsoft.SharePoint.SPFileSystemObjectType]::Folder,<\/span>“My New Folder”
<\/span>>>)<\/span>
<\/span>PS<\/span> <\/span>><\/span> <\/span>$spFolder<\/span>.Update()<\/span> <\/div>\n<\/blockquote>\n
Uploading Files to a Document Library<\/h5>\n

To upload files to a SharePoint document library, we use the Add<\/strong> method provided by the Microsoft.SharePoint.SPFileCollection<\/strong> class, which represents a collection of SPFile<\/strong> objects in SharePoint 2010.\nBefore we can access a file collection in SharePoint 2010, we have to create an instance of the Microsoft.SharePoint.SPFolder<\/strong> class using the GetFolder()<\/strong> method provided by the Microsoft.SharePoint.SPWeb<\/strong> class:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$spFolder<\/span> <\/span>=<\/span> <\/span>$spWeb<\/span>.GetFolder(<\/span>“My Documents”<\/span>)<\/span> <\/div>\n<\/blockquote>\n

After we have bound to the document library, we can store the file collection in a new variable, which we will use to add files:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$spFileCollection<\/span> <\/span>=<\/span> <\/span>$spFolder<\/span>.Files<\/span> <\/div>\n<\/blockquote>\n

The Add<\/strong> method provided by the Microsoft.SharePoint.SPFileCollection<\/strong> class is used to create a file in a file collection. This is a very versatile method that has 21 overload definitions. For the one that we will be using in our example, we need to specify the file’s relative URL, a byte array containing the file, and a Boolean value that determines whether an existing file with the same name that might already exist should be overwritten. Let’s have a look at the byte array first.\nIt is possible to expose a sequence of bytes using the System.IO.FileStream<\/strong> class, which we can pass on to the Add<\/strong> method. A simple way of retrieving an object of the type System.IO.FileStream<\/strong> is by using the OpenRead()<\/strong> method provided by the System.IO.FileInfo<\/strong> class. When using the Get-ChildItem<\/strong> cmdlet on a file, we get an object of the type System.IO.FileInfo<\/strong>:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$file<\/span> <\/span>=<\/span> <\/span>Get-ChildItem<\/span> <\/span>C:DocumentsMyDoc.docx<\/span> <\/div>\n<\/blockquote>\n

Now we can use the OpenRead()<\/strong> method when adding a new file to a SharePoint library:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>$spFileCollection<\/span>.Add(<\/span>“My Documents\/MyDoc.docx”<\/span>,<\/span>$file<\/span>.OpenRead(),<\/span>$false<\/span>)<\/span> <\/div>\n<\/blockquote>\n

The example demonstrates how to upload a single file to a document library in SharePoint 2010. But what if we want to upload multiple files? Simply use the ForEach-Object<\/strong> cmdlet to loop through a collection of files and add them to a SharePoint 2010 document library using the Add()<\/strong> method:<\/p>\n

\n
PS<\/span> <\/span>><\/span> <\/span>Get-ChildItem<\/span> <\/span>C:Documents<\/span> <\/span>-filter<\/span> <\/span>“*.docx”<\/span> <\/span>|<\/span> <\/span>ForEach<\/span> <\/span>{<\/span>
<\/span>>><\/span> <\/span>$spFileCollection<\/span>.Add(“My<\/span> <\/span>Documents\/<\/span>$<\/span>(<\/span>$_<\/span>.Name)”,<\/span>$_<\/span>.OpenRead(),<\/span>$true<\/span>)<\/span>
<\/span>>>}<\/span> <\/div>\n<\/blockquote>\n
Summary<\/h5>\n

In this post we’ve covered document libraries and uploading files using Windows PowerShell. We’ve seen examples of creating and managing document libraries and how to upload single and multiple files to a document library. The post only touches the surface of what you can do to manage your SharePoint 2010 environment. Be sure to check out PowerShell for Microsoft SharePoint 2010 Administrators<\/i> for detailed examples about how to create document libraries, manage files, copy files between document libraries, check in and out files, and manage content types.\nMK, that is all there is to using Windows PowerShell cmdlets to manage document libraries in SharePoint 2010. And this Guest Blogger Week is done. Our thanks to Niklas Goude for sharing all these exciting posts about SharePoint and Windows PowerShell. Join us tomorrow for Quick-Hits Friday.\nWe would love you to follow us on Twitter<\/a> and Facebook<\/a>. If you have any questions, send email to us at scripter@microsoft.com<\/a>, or post your questions on the Official Scripting Guys Forum<\/a>. See you tomorrow. Until then, peace.\n <\/p>\n

Ed Wilson and Craig Liebendorfer, Scripting Guys<\/strong><\/p>\n","protected":false},"excerpt":{"rendered":"

  Summary: Management of SharePoint 2010 document libraries by using Windows PowerShell cmdlets is explored in this Hey, Scripting Guy! Blog post.   Hey, Scripting Guy! Please tell me about document management with SharePoint and Windows PowerShell. — MK   Hello MK, Microsoft Scripting Guy Ed Wilson here. It is Thursday in Charlotte, North Carolina, […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[56,183,3,59,45],"class_list":["post-17031","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-guest-blogger","tag-niklas-goude","tag-scripting-guy","tag-sharepoint","tag-windows-powershell"],"acf":[],"blog_post_summary":"

  Summary: Management of SharePoint 2010 document libraries by using Windows PowerShell cmdlets is explored in this Hey, Scripting Guy! Blog post.   Hey, Scripting Guy! Please tell me about document management with SharePoint and Windows PowerShell. — MK   Hello MK, Microsoft Scripting Guy Ed Wilson here. It is Thursday in Charlotte, North Carolina, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/17031","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\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=17031"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/17031\/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=17031"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=17031"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=17031"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}