How to: Make Windows 7 PowerShell look like the SharePoint Management Shell

CoreyRoth — Mon, 21 May 2012 20:54:03 GMT

I love me some PowerShell. I use it a lot in the context of SharePoint 2010, but I use it just as much on my own laptop. If you have been administering and configuring SharePoint enough, you have become accustomed to the shape and size of the PowerShell window that you get when you run the SharePoint Management Shell. That’s just the way I prefer things to look when I am in the command prompt now. However, by default, when you run PowerShell in Windows 7, you get this huge window that is just cumbersome.

That’s why I thought I would share these quick configuration settings to make your PowerShell experience in Windows 7 just like in SharePoint. Start by finding PowerShell in the start menu, right click and go to Properties. Jump over the Layout tab and you will find the first settings we need to change.

Let’s compare it to the settings on the SharePoint Management Shell.

From the screenshots, you can tell there are a few differences in the Screen buffer size and the Window Size. Let’s talk about Window size first. Start by reducing the Window size width from 120 to 80. You then want to change the Window size height from 50 to 25. You then want to adjust the Screen buffer size. I set the Width to match with a new value of 80. However, I leave the height at 3000, because having a bigger screen buffer is nice when you want to scroll back and look at something. Here are what my modified settings look like.

Once you’ve changed the layout, you may want to also change the color back to black instead of the Windows 7 default color. That’s easy to do by going to the Colors tab. Just click on the black box with Screen background selected.

That’s all there is to it. Click OK and then open a new PowerShell window. Your new command prompt will look just like the one in SharePoint 2010.

So it’s kind of weird tip for today but I find it useful because I like it when PowerShell looks this way. :) Try it out and see for yourself. You can customize other value as well.

How to: Create an OpenSearch Provider for SharePoint

CoreyRoth — Mon, 17 May 2010 22:07:00 GMT

A while back, Kevin Williams pointed out to me that certain web sites could be searched in Google Chrome using the syntax <ur> query in the address bar. For example, once I have been to youtube.com, I can later type in youtube to initiate a search query.

Pressing tab, give you a spot to enter your query or you can just type a space and put in your keyword.

As someone that does a lot of work with SharePoint Enterprise Search, this got me thinking. I want my SharePoint site to show up in my browser too. I did some research and discovered this is part of OpenSearch and that I can achieve the same result with any OpenSearch compatible search engine (which SharePoint is), so I knew this would be relatively easy to research. I figured this kind of thing might already be included in SharePoint 2010 (and maybe it is and I just haven’t found it), but from what I can tell it’s not. If anything, you can use this technique in SharePoint 2007 as well. If this file is auto generated somehow, I would love to hear about it.

To get started, you must first create an XML file which describes where to point search queries on your web server. The filename does not matter (search.xml in my case). The syntax is pretty simple, but there are a couple of things to watch out for. I started with Microsoft’s description of how to create a file on MSDN. However, it appears there is an issue in the documentation (or maybe something changed in a different version). The issue I saw is that on the URL element, it says you an attribute called format. I could not get this to work so I looked at working examples on site and discovered they had the attribute listed at type. The other issue I ran into in this file is apparently the ShortName element cannot have capital letters in it. Here is what my entire file looks like for my server called sp2010.

<OpenSearchDescription xmlns="http://a9.com/-/spec/opensearch/1.1/">
  <ShortName>sp2010</ShortName>
  <Description>sp2010</Description>
  <Url
    type="text/html"
    method="get"
    template="http://sp2010/search/results.aspx?k={searchTerms}" />
  <Url
    type="application/rss+xml"
    method="get"
    template="http://sp2010/_layouts/srchrss.aspx?k={searchTerms}&amp;start={startIndex}&amp;cnt={count}" />
  <Image height="16" width="16" type="image/vnd.microsoft.icon">http://sp2010/_layouts/images/favicon.ico</Image>
</OpenSearchDescription>

The ShortName element specifies the keyword to type into Chrome to prompt you to do a search (i.e.: youtube.com up above, sp2010 in our case). You need to already have a search center created. In my case I have a site called Search and I will point to a results page in there called results.aspx. You will change this according to your environment. For browser based search results, we use a type of text/html. We use the keyword URL syntax here so the browser passes in what you searched for as the {searchTerms} token to the k query string parameter. You will notice I have a second Url element present. This is here in case you want to use this same while to do Windows 7 federated search. I’ll talk briefly about that in the end, but it uses the path to the RSS feed of your search results. You can also include a custom image icon with the search results as well along with many other things. Read the MSDN article for more information on what you can put in this file.

The next thing we need to do is put this XML file somewhere on the SharePoint server. You can just open SharePoint designer and drag it to the root of the server or put it in a document library somewhere. It doesn’t matter as long as you know the URL to it. The next thing we have to do is put a link tag in your master page file specifying where this XML file is. You should normally deploy master pages via solution package and feature, but for today’s purposes, I just opened SharePoint Designer and customized v4.master (gasp!). Remember v4.master is the new default master page for sites running on v4. Add the following line somewhere in the head tag and change the URL to your XML file.

Remember to check the file in when you are done. One thing to point out about SharePoint 2010 is that it won’t serve up some file type directly to the browser (it forces a download). I think this may cause issues, so at the suggestion of @danluciano, I changed the browser file handling of my Web Application in central admin (Central Admin –> Web Applications –> General Settings). It’s set to Strict by default and I changed it to Permissive. You don’t need to worry about this in SharePoint 2007. Honestly, it may work in SharePoint 2010 without changing this but when I was running into issues getting things working earlier this seemed to be a possible issue. If you try it without, let me know. :-)

At this point, if you did everything right, you should be able to use your new keyword in Chrome after visiting your SharePoint site. Here is what mine looks like after type in sp2010.

Hitting enter I get my usual search results page.

I think this is pretty cool. You should be able to use this in other browsers as well such as IE8, but I really like how Chrome handles it. Now I mentioned Windows 7 federated search. You can take the file you created above, save it to your desktop as .odcx file extension and install it. What makes this possible is the second URL element we specified using the application/rss+xml type.

You will see the following prompt.

When you open Windows Explorer, it will show your SharePoint site in the list of Searches. It also adds it to your favorites.

Clicking on the SP2010 search connector here allows us to search the SharePoint site directly. You will be prompted for authentication if necessary. Executing the same search query above looks like this.

Clicking on any of the links takes you directly to SharePoint. Remember you can implement this now with SharePoint 2010 or SharePoint 2007. It’s definitely cool and another great way to get data out of SharePoint.

Corey Roth [MVP] : Windows 7, SharePoint

How to: Make Windows 7 PowerShell look like the SharePoint Management Shell

How to: Create an OpenSearch Provider for SharePoint