本地 SharePoint 农场配置：故障排除指南

本文档提供了配置本地 SharePoint 农场时可能遇到的常见错误消息列表及解决方案。点击错误消息即可跳转到对应解决方案。

以下是您在 SharePoint Manager Plus 中配置农场时可能遇到的错误列表。

1. CredSSP 和 WinRM 身份验证错误
   • 客户端请求的身份验证机制不被服务器支持
   • 服务配置中未启用未加密流量
2. 连接到 SharePoint Server ABC.domain.com 失败，错误消息如下：WinRM 客户端收到 HTTP 服务器错误状态（500），但远程服务未提供失败原因的其他信息
3. 拒绝访问
4. 需要远程/本地 PowerShell 设置。
5. 无法访问本地农场
6. PowerShell 版本低于 2
7. 身份验证及请求错误
   • 不支持请求的错误
   • 发生身份验证错误
   • 请求的功能不被支持
   • 传递给功能的令牌无效
8. Microsoft SharePoint 不支持 Microsoft .Net Runtime 版本 4.0.30319.33440

1. CredSSP 和 WinRM 身份验证错误

• 客户端请求的身份验证机制不被服务器支持
• 服务配置中未启用未加密流量

可能的原因

客户端或服务器未启用 CredSSP 身份验证，导致身份验证请求被拒绝。

解决方案

在客户端和服务器上启用 CredSSP 设置：

• 打开安装有 SharePoint Manager Plus 的计算机上的组策略设置，导航至 计算机配置 > 管理模板 > Windows 组件 > Windows 远程管理 (WinRM) > WinRM 客户端设置 允许 CredSSP 身份验证 为 已启用.
• 打开 SharePoint 服务器上的组策略设置，导航至 计算机配置 > 管理模板 > Windows 组件 > Windows 远程管理 (WinRM) > WinRM 服务设置 允许 CredSSP 身份验证 为 已启用.

2. 连接到 SharePoint Server ABC.domain.com 失败，错误消息如下：WinRM 客户端收到 HTTP 服务器错误状态（500），但远程服务未提供失败原因的其他信息

可能的原因

WinRM 服务未配置有效 WinRM 证书，导致连接 SharePoint 服务器时身份验证失败。

解决方案

• 打开事件查看器，导航至 Windows 日志 > 系统.
• 查找 Windows 远程管理 作为 来源 且 错误 作为 级别.
• 打开该事件查看错误详情。
• 如果错误包含“使用有效证书的指纹”，请以管理员身份在 PowerShell 中运行以下命令：
  Set-Item WSMan:\localhost\Service\CertificateThumbprint -Value ''

3. 拒绝访问

可能原因

• 用户账户不具备农场管理员权限。
• 用户名或密码无效。

解决方案

• 确保用户账户具备本页面中提到的所有必要权限。 确认用户凭据正确无误。.
• 4. 需要远程/本地 PowerShell 设置

本地或远程 PowerShell 配置未正确设置。

可能原因

• SharePoint 服务器与安装 SharePoint Manager Plus 的计算机之间没有信任关系。
• 在安装有 SharePoint 服务器和 SharePoint Manager Plus 的计算机上启用远程 PowerShell：

解决方案

• 在安装 SharePoint 服务器的计算机上，以管理员身份打开 PowerShell 并执行以下命令：
  • Enable-PSRemoting -Force

    Enable-WSManCredSSP -Role Server -Force

    在安装 SharePoint Manager Plus 的计算机上，以管理员身份打开 PowerShell 并执行以下命令：

  • Enable-WSManCredSSP -Role Client -DelegateComputer "

    Enable-WSManCredSSP -Role Server -Force

    server.domain.com（SharePoint 服务器的完全限定域名 (FQDN)）" 如果安装 SharePoint 服务器和 SharePoint Manager Plus 的计算机位于不同域，请在安装 SharePoint Manager Plus 的计算机上运行以下命令：

• Set-Item WSMan:\localhost\Client\TrustedHosts -Value "

  Enable-WSManCredSSP -Role Server -Force

  （SharePoint 服务器的 FQDN）（SharePoint 服务器的完全限定域名 (FQDN)）" -Concatenate -Force Restart-Service WinRM

  如果错误仍然存在，可尝试以下操作：

  检查组策略设置，位于

  • 运行以下命令以增加每个 shell 分配的最大内存，推荐大小为 1024MB： 确认用户凭据正确无误。.
  • Get-Item wsman:\localhost\shell\MaxMemoryPerShellMB

    （运行此命令查看当前 PowerShell 内存大小） Set-Item wsman:\localhost\shell\MaxMemoryPerShellMB -Value 1024 -Force

    （仅当内存小于 1024MB 时运行） 运行以下命令以增加每个用户允许的最大并发 shell 数，推荐数量为 30：

    如果错误仍然存在，可尝试以下操作：

  • Get-Item wsman:\localhost\shell\MaxShellsPerUser

    （运行此命令查看每个用户允许的最大并发 shell） Set-Item wsman:\localhost\shell\MaxShellsPerUser -Value 30 -Force

    （仅当数量小于 30 时运行） 5. 无法访问本地农场

    如果错误仍然存在，可尝试以下操作：

用户账户可能没有农场管理员所需的所有权限。

可能原因

1. 当前使用的身份验证方式可能不被 SharePoint 服务器支持，无法将用户委派至另一台机器以访问数据库服务器。
2. 检查所有

解决方案

• 必需的农场管理员权限 并进行相应配置。 确保用户拥有配置数据库和所有内容数据库的访问权限，这些权限通过 SQL Server 的
• SharePoint_Shell_Access 数据库角色授予。要通过 PowerShell 为用户分配此角色，请在远程计算机上打开 PowerShell 并运行以下命令： Add-PSSnapin Microsoft.SharePoint.PowerShell

  Get-SPDatabase | Add-SPShellAdmin DOMAIN\UserName

  [将 DOMAIN\UserName 替换为实际的用户账户] 或者，可以通过打开 SQL Server Management Studio 为用户分配

  DBCREATOR、SECURITYADMIN、 SYSADMIN 且 服务器角色，并确保该用户拥有 DBOWNER 权限访问所有 SharePoint 数据库。 点击

• 检查组策略设置，位于
  • 此处 查看组策略设置。 Set-Item WsMan:\localhost\client\trustedhosts -Value "
  • Set-Item WSMan:\localhost\Client\TrustedHosts -Value "

    Enable-WSManCredSSP -Role Server -Force

    SharePoint 服务器的 FQDN（SharePoint 服务器的完全限定域名 (FQDN)）" [] -Concatenate -Force在安装 SharePoint 服务器和 SharePoint Manager Plus 的计算机上启用 CredSSP 身份验证也可能解决此问题：

    如果错误仍然存在，可尝试以下操作：

• 在安装 SharePoint 服务器的计算机上以管理员身份打开 PowerShell 并运行以下命令：
  • 在安装 SharePoint Manager Plus 的计算机上以管理员身份打开 PowerShell 并运行以下命令：

    Enable-WSManCredSSP -Role Server -Force

    在安装 SharePoint Manager Plus 的计算机上，以管理员身份打开 PowerShell 并执行以下命令：

  • Enable-PSRemoting -ForceEnable-WSManCredSSP -Role Client -DelegateComputer "

    ] -Force（SharePoint 服务器的完全限定域名 (FQDN)）" [] -Concatenate -Force6. PowerShell 版本低于 2

安装的 PowerShell 版本过旧，不符合 SharePoint Manager Plus 的最低要求。

可能的原因

SharePoint Manager Plus 需要 PowerShell 2 版本及以上才能正常工作。请升级至至少 PowerShell 2 版本。

解决方案

7. 身份验证及请求错误

连接时可能会遇到这些错误，比如使用远程桌面连接或建立远程 PowerShell 连接时。SharePoint Manager Plus 使用 CredSSP 身份验证连接 SharePoint 服务器。CredSSP 协议中存在远程代码执行漏洞；该漏洞（CVE-2018-0886）已经通过

• 不支持请求的错误
• 发生身份验证错误
• 请求的功能不被支持
• 传递给功能的令牌无效

可能的原因

Microsoft 安全更新 得到修复。客户端和服务器双方都需更新以解决问题。在客户端和 SharePoint 服务器上安装

解决方案

Microsoft 安全更新。 8. Microsoft SharePoint 不支持 Microsoft .Net Runtime 版本 4.0.30319.33440

该问题出现是因为当前 .NET Runtime 版本与 Microsoft SharePoint 的要求不兼容。大部分现代系统默认的 PowerShell 版本可能不兼容，导致错误。

可能的原因

执行以下步骤创建自定义 PowerShell 会话配置。下面的命令注册了 PowerShell 2.0 会话，确保 SharePoint cmdlets 在兼容旧版 .NET 环境中运行：

解决方案

在安装 SharePoint 服务器的计算机上以管理员身份打开 PowerShell 并运行以下命令：

• Register-PSSessionConfiguration -PSVersion 2.0 -Name ps2
  打开 SharePoint Manager Plus 安装位置并导航到
• Open the location where SharePoint Manager Plus is installed and navigate to the ManageEngine\SharePoint Manager Plus\bin 文件夹。
• 以管理员身份在此位置打开命令提示符并运行 connectDb.bat.
• 运行以下命令：
  Update ParamValueRelation set VALUE='ps2' where PARAM='PS_CONFIG_DEFAULT';

这些步骤将配置 SharePoint Manager Plus 使用新创建的会话（ps2）来执行 PowerShell 命令，确保与 Microsoft SharePoint 的兼容性。