Export (0) Print
Expand All
0 out of 2 rated this helpful - Rate this topic

Administering Service Applications Using the SharePoint 2010 Management Shell

SharePoint 2010

Published: May 2010

The SharePoint Management Shell in SharePoint Foundation 2010 provides an extensive set of Windows PowerShell cmdlets that make development, deployment, and administration of SharePoint 2010 easier and more efficient.

The SharePoint Management Shell supersedes the Stsadm.exe administration tool. All current and future development of command-line tools and administrative files in Microsoft SharePoint Foundation 2010 should use this new scripting technology.

Note Note

The Stsadm commands used to create, enumerate, and manage Shared Services Providers (SSPs) are not usable with the Service Application Framework.

To use the SharePoint Foundation 2010 cmdlets from inside the Windows PowerShell command window, you can add the SharePoint 2010 snap-in to Windows PowerShell.

To add the SharePoint snap-in to Windows PowerShell

  1. Open Windows PowerShell.

  2. In the Windows PowerShell window, type get-PSSnapin – Registered. The SharePoint Foundation 2010 snap-in is listed.

  3. In the Windows PowerShell window, type Add-PSSnapin Microsoft.SharePoint.Powershell.

You can also add the Windows PowerShell snap-in permanently to your Windows PowerShell $profile.

The following table describes the Windows PowerShell nouns and verbs that developers of Service Application Framework applications will most commonly use to manage services, service instances, and service applications.

Table 1. Windows PowerShell Nouns and Verbs for use with the Service Application Framework

Noun

Windows PowerShell Commands

SPService

  • Install-SPService

SPServiceInstance

  • Get-SPServiceInstance

  • Start-SPServiceInstance

  • Stop-SPServiceInstance

SPServiceApplication

  • Get-SPServiceApplication

  • Publish-SPServiceApplication

  • Remove-SPServiceApplication

  • Set-SPServiceApplication

  • Unpublish-SPServiceApplication

SPServiceApplicationProxy

  • Get-SPServiceApplicationProxy

  • Remove-SPServiceApplicationProxy

SPIisWebServiceApplicationPool

  • Get-SPServiceApplicationPool

  • New-SPServiceApplicationPool

  • Remove-SPServiceApplicationPool

  • Set-SPServiceApplicationPool

Documentation of these cmdlets is provided in the SharePoint Management Shell.

When you develop your service you can override the SharePoint 2010-specific Windows PowerShell verbs to add their own parameters. However, such custom parameters must conform to the same standards as SharePoint 2010. The following are suggested best practices to use when you create or modify cmdlets:

  • If you are deriving from an existing object, replace the SP prefix on the noun with the name of your service or feature.

  • If you are deriving from an existing SharePoint 2010 object, call the base object's methods for all common operations.

  • Reuse existing parameter names whenever possible.

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.