Microsoft.SharePoint.Powershell 模块概述

有关 SharePoint Server cmdlet 的列表,请参阅 Microsoft.SharePoint.Powershell cmdlet

访问适用于 SharePoint Server 的 PowerShell

安装 SharePoint Server 后,适用的 PowerShell cmdlet 便显示在 SharePoint 2016 命令行管理程序中。 可以在 SharePoint 命令行管理程序中管理 SharePoint Server 的大部分方面。 可以新建网站集、Web 应用、用户帐户、服务应用、代理等。 在 SharePoint Management Shell 中键入的命令将返回基于 Microsoft .NET Framework 的 SharePoint 对象。 可以将这些对象作为输入应用于后续命令,或者将对象存储到本地变量中以便稍后使用。

使用 SharePoint 命令行管理程序,你不必注册包含 cmdlet 的管理单元。 注册由 Add-PSSnapin Microsoft.SharePoint.PowerShell 文件中的 SharePoint.ps1 行处理。 该文件位于文件夹中 %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\<version>\Config\PowerShell\Registration

  • <version> 15 等于 SharePoint Server 2013
  • 和 16 等 <version> 于 SharePoint Server 2016

若要使用 PowerShell 控制台,必须手动注册此管理单元。

无论是使用 SharePoint 命令行管理程序还是 PowerShell 控制台,还可以加载其他管理单元和模块。

注意

SharePoint 命令行管理程序与 PowerShell 控制台在" UseThread 选项的使用上也有所不同,此选项定义如何使用线程模型。 SharePoint 命令行管理程序的用法由文件中的SharePoint.ps1这一行{Host.Runspace.ThreadOptions = "ReuseThread"}定义。 有关详细信息,请参阅 "PS 线程选项

权限

在使用 Add-SPShellAdmin cmdlet 向用户授予运行 SharePoint Server cmdlet 的权限之前,请验证是否满足以下所有最低要求:

  • 必须是 SQL Server 实例上 SecurityAdmin 固定服务器角色的成员身份。
  • 您必须是运行 PowerShell cmdlet 的服务器上 Administrators 组的成员。

注意

如果没有这些权限,请联系安装管理员或 SQL Server 管理员,以请求获取这些权限。

有关 PowerShell 权限的其他信息,请参阅 Add-SPShellAdmin

如果没有 SharePoint_Shell_Access 角色或本地组WSS_Admin_WPG成员身份,请使用 Add-SPShellAdmin cmdlet 在 SharePoint 场和 SharePoint_Shell_Access 角色中的所有前端 Web 服务器中添加WSS_Admin_WPG组。 如果 SQL Server 数据库没有 SharePoint_Shell_Access 角色,则在运行 Add-SPShellAdmin cmdlet 时自动创建该角色。 运行 Add-SPShellAdmin cmdlet 后,用户可以在多服务器场环境中运行 SharePoint PowerShell cmdlet。

注意

在安装 SharePoint Server 时,将向用于运行安装的用户帐户授予运行 PowerShell cmdlet 所需的适当权限。 如果尚未添加任何用户来运行 PowerShell cmdlet,则可以使用 Add-SPShellAdmin 该 cmdlet 添加他们。

若要查看所有 SPShellAdmin cmdlet 的列表,请在 PowerShell 命令提示符下键入 Get-Command -Noun SPShellAdmin

脚本和执行策略

虽然可以使用 Microsoft PowerShell 执行单个管理任务,但也可以使用脚本来自动执行一系列任务。 脚本是包含一个或多个 Microsoft PowerShell 命令的文本文件。 Microsoft PowerShell 脚本具有 .ps1 文件扩展名。

若要运行脚本,SharePoint Server 所需的最低执行策略是 RemoteSigned,尽管 PowerShell 的默认策略为 受限。 如果策略保留为 “受限”,SharePoint 命令行管理程序会将 PowerShell 的策略更改为 RemoteSigned。 这意味着你必须选择"以管理员 管理员角色 提升的管理权限启动 SharePoint 命令行管理程序。 此更改适用于所有 PowerShell 会话。 有关脚本和执行策略的更多信息,请参阅 about_scripts 和关于 执行策略