通过

借助 Windows PowerShell 的 SharePoint 2010 产品管理

  • 项目

 

适用于： SharePoint Foundation 2010

上一次修改主题： 2017-01-18

本文介绍如何在 Microsoft SharePoint 2010 产品 中使用 Windows PowerShell，并概述了必要的基本 Windows PowerShell cmdlet 和概念，从而使您可以从这个强大功能中获得最大受益。

本文内容：

  • 概述

  • 使用 SharePoint 2010 Management Shell 访问适用于 SharePoint 2010 产品的 Windows PowerShell

  • 权限

  • 脚本和执行策略

  • 学习 Windows PowerShell

概述

Windows PowerShell 是一个可供管理员完全访问适用的应用程序编程接口 (API) 的命令行脚本工具，并且对于直接与 SharePoint 2010 产品 交互以对 Web 应用程序、网站集、网站、列表等进行操作的功能，能够解除锁定。另外，管理员可以编写 cmdlet（发音为“command-let”）的脚本，从而改善之前产品版本的体验。

Windows PowerShell 2.0 是安装 SharePoint 2010 产品 的必备软件。如有必要，您在运行 Microsoft SharePoint 产品准备工具 时就会安装它。默认情况下，Windows PowerShell 位于以下路径：<%SystemRoot%>\System32\WindowsPowerShell\v1.0\PowerShell.exe。

备注

Windows PowerShell 2.0 与 Windows PowerShell 1.0 向后兼容，所以它安装在 v1.0 文件夹下。

有关 Windows PowerShell version 2.0 新功能的列表，请参阅关于 Windows PowerShell 2.0 (https://go.microsoft.com/fwlink/?linkid=113247&clcid=0x804)。

有关可帮助您了解 Windows PowerShell 语法的交互式工具和指南，请参阅 Windows PowerShell 命令生成器工具（该链接可能指向英文页面）和入门指南（该链接可能指向英文页面）。

我们建议您在执行命令行管理任务时使用 Windows PowerShell。Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

访问 SharePoint 2010 产品的 Windows PowerShell

完成 SharePoint 2010 产品安装后，适用的 Windows PowerShell cmdlet 可通过 SharePoint 2010 Management Shell 或 Windows PowerShell 控制台访问。通过命令行管理程序，您可以管理 SharePoint 2010 产品 的所有方面。您可以创建新的网站集、Web 应用程序、用户帐户、服务应用程序、代理等。来自命令行管理程序的命令将基于 Microsoft .NET 平台输出 SharePoint 对象。这些对象可用作后续命令的输入对象，或者存储在本地变量中供以后使用。

使用命令行管理程序，您不必注册包含 cmdlet 的管理单元。注册适用于 SharePoint 2010 cmdlet 的 Microsoft.SharePoint.PowerShell.dll 模块是自动完成的，由位于 %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Config\PowerShell\Registration 下的 SharePoint.ps1 文件中的 Add-PSSnapin Microsoft.SharePoint.PowerShell 行执行。如果选择使用 Windows PowerShell 控制台，则必须手动注册管理单元。

无论是使用命令行管理程序，还是使用 Windows PowerShell 控制台，您都可以加载其他管理单元。有关详细信息，请参阅自定义配置文件 (https://go.microsoft.com/fwlink/?linkid=183166&clcid=0x804)。

若要访问 SharePoint 2010 Management Shell，请执行以下操作：

  1. 在“开始”菜单上，单击“所有程序”。

  2. 单击“Microsoft SharePoint 2010 产品”。

  3. 单击“SharePoint 2010 Management Shell”。

备注

SharePoint 2010 Management Shell 和 Windows PowerShell 控制台在使用 ReuseThread 选项上也有不同，这个选项定义了如何使用线程模型。命令行管理程序的使用方式由位于 SharePoint.ps1 文件的下面这一行来定义：{Host.Runspace.ThreadOptions = "ReuseThread"}。有关详细信息，请参阅 PS 线程选项（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=183145&clcid=0x804)（该链接可能指向英文页面）。

权限

使用命令行管理程序和 Windows PowerShell cmdlet 之前，请验证是否满足了以下最低要求：请参阅 Add-SPShellAdmin。

如果您不是 SharePoint_Shell_Access 角色或 WSS_Admin_WPG 本地组的成员，请使用 Add-SPShellAdmin cmdlet。使用 Add-SPShellAdmin cmdlet 时，用户将被添加到所有前端 Web 服务器的 WSS_Admin_WPG 组中，并且添加到 SharePoint_Shell_Access 角色中。如果目标数据库没有 SharePoint_Shell_Access 角色，将自动创建该角色。运行 Add-SPShellAdmin cmdlet 后，用户即可以在多服务器场环境中运行 SharePoint 2010 Windows PowerShell cmdlet。

如果运行此 Add-SPShellAdmin cmdlet 时要将用户添加到 SharePoint_Shell_Access 角色，您必须具有以下安全权限：

  • 对 SQL 实例的 Securityadmin 服务器角色访问权限和数据库中的 db_owner 角色。

  • 本地计算机上的管理权限。

备注

计划使用 Add-SPShellAdmin cmdlet 的人员必须与安装时使用的用户帐户关联。

您必须为要向其授予权限的所有数据库运行 Add-SPShellAdmin cmdlet。如果未指定数据库，将使用服务器场配置数据库。如果指定了一个数据库，那么除了指定的服务器场配置数据库以外还会包括服务器场内容数据库。

若要查看所有 *SPShellAdmin cmdlet 的列表，请在 Windows PowerShell 命令提示符处键入 Get-Command -Noun SPShellAdmin。

脚本和执行策略

虽然可以使用 Windows PowerShell 执行单个管理任务，但使用 Windows PowerShell cmdlet 所获得的真正好处是，能够使用脚本来自动执行一系列任务。脚本是包含一个或多个 Windows PowerShell 命令的纯文本文件。Windows PowerShell 脚本的文件扩展名为 .ps1。

在使用脚本时，请注意，SharePoint 2010 产品 所需的最低执行策略是 RemoteSigned，而 Windows PowerShell 的默认策略为 Restricted。如果此策略保留为 Restricted，则 SharePoint 2010 Management Shell 会将 Windows PowerShell 的策略更改为 RemoteSigned。这意味，必须通过选择“以管理员身份运行”，使用提升的管理权限来启动 SharePoint 2010 Management Shell。此更改将应用于所有 Windows PowerShell 会话。

有关脚本和执行策略的其他信息，请分别参阅 about_scripts 和 about_Execution_Policies。

学习 Windows PowerShell

针对不熟悉 Windows PowerShell 的 SharePoint IT 专业人员提供了若干 Windows PowerShell 学习资源。

TechNet 脚本编写中心

TechNet 脚本编写中心包括许多学习使用 Windows PowerShell 基础知识的资源。它还包括脚本库，里面有各种 Microsoft 产品经常使用的脚本示例。下表显示了主要的学习资源。

网页 说明

TechNet 上的 Windows PowerShell 文档 (https://go.microsoft.com/fwlink/?linkid=187813&clcid=0x804)

TechNet 库中的这一部分包含核心 Windows PowerShell Get-Help 主题的网页副本。还包括 Windows PowerShell 入门文档、PowerShell.exe 帮助以及 Windows PowerShell primer 的网页副本。

使用 Windows PowerShell 编写脚本 (https://go.microsoft.com/fwlink/?linkid=187815&clcid=0x804)

Windows PowerShell 脚本编写学习资源的主页。

Windows PowerShell 所有者手册（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=187817&clcid=0x804)（该链接可能指向英文页面）

Windows PowerShell 入门的网页格式指南。

Windows PowerShell 快速参考（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=187819&clcid=0x804)（该链接可能指向英文页面）

随 Windows PowerShell 安装的快速参考文档的可下载副本。

Windows PowerShell 文档

Windows PowerShell 在 Windows PowerShell 1.0 程序组中安装了下列文档。也可以在下载 Windows PowerShell 1.0 文档包（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=187822&clcid=0x804)（该链接可能指向英文页面） 之后安装。

文件 说明

GettingStarted.rtf

描述如何开始使用 Windows PowerShell。

UsersGuide.rtf

Windows PowerShell 环境和语言的初级读本。

QuadFold.rtf

常用 Windows PowerShell 语法和命令的可打印快速参考文档。也可通过 TechNet 脚本编写中心下载。

您阅读这些资源时，会认为在使用 SharePoint 2010 产品的 Windows PowerShell 前学习下面这些概念和 cmdlet 非常有用。