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.PowerShellSharePoint.ps1 行处理。 此文件位于 %CommonProgramFiles%\Microsoft Shared\Web Server Extensions\<version>\Config\PowerShell\Registration 文件夹中。

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

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

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

注意

SharePoint 命令行管理程序与 PowerShell 控制台在" UseThread 选项的使用上也有所不同,此选项定义如何使用线程模型。 SharePoint 命令行管理程序的使用由此行定义, {Host.Runspace.ThreadOptions = "ReuseThread"}此行位于 SharePoint.ps1 文件中。 有关详细信息,请参阅 "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 场中的所有前端 Web 服务器和SharePoint_Shell_Access角色中添加WSS_Admin_WPG组。 如果SQL Server数据库没有SharePoint_Shell_Access角色,则运行 cmdlet 时会自动创建该Add-SPShellAdmin角色。 运行 cmdlet Add-SPShellAdmin 后,用户可以在多服务器场环境中运行 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关于执行策略