通过

SharePoint Server Cmdlet

  • 项目

有关 SharePoint Server cmdlet 列表，请参阅 sharePoint Server 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 Server cmdlet Microsoft.SharePoint.PowerShell.dll模块。位于 %CommonProgramFiles%\Microsoft Shared\Web Server Extensions<version>\Config\PowerShell\Registration 的 SharePoint.ps1 文件中的 SharePoint.PowerShell 行，其中版本“15”等于 SharePoint Server 2013，版本“16”等于 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 场中的所有前端 Web 服务器上和 SharePoint_Shell_Access 角色中添加 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 会话。 有关详细信息，请参阅 ExecutionPolicy 枚举。

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