从网络共享安装 SharePoint Server 必备组件

适用范围:yes-img-132013 yes-img-16 2016yes-img-19 2019yes-img-seSubscription Edition no-img-sopSharePoint in Microsoft 365

如果要在其上安装 SharePoint Server 的服务器与 Internet 隔离,通常需要从离线位置安装必备组件。 即使不属于这种情况,从集中离线位置安装必备组件也可以安装已知的受控映像集,从而确保场服务器的一致性。

注意

[!注意] Microsoft SharePoint 产品准备工具是基于 PrerequisiteInstaller.exe 构建的用户界面。 Microsoft SharePoint 产品准备工具不接受任何用户输入。

安装程序开关和参数

通过对 PrerequisiteInstaller.exe 使用开关和参数,您可以控制安装哪些版本的必备软件以及安装位置。

PrequisiteInstaller.exe 接受单个或多个开关和参数对。 开关标识必备组件,参数指定必备组件的操作和位置。

开关和参数对采用以下格式:

/switch: <path>

其中:

  • /switch 是用于标识必备组件的有效开关。 例如, /SQLNCli: 是代表 Microsoft SQL Server 2012 SP1 Native Client 的开关。

  • <路径> 表示为本地文件的路径或文件共享的路径,例如,“C:\foldername\sqlncli.msi”或“\<servername>\<sharename>\sqlncli.msi”。

每个开关及其参数都由一个冒号和一个空格分隔。 参数使用引号括起来。

开关和参数对可以在命令提示符下传递给 PrerequisiteInstaller.exe,也可以从参数文本文件读取。

下载并合并文件共享上的 SharePoint Server 必备组件

您可以通过执行下列过程中的步骤来下载与合并必备组件。

确定必备组件的具体步骤

  1. 请参考文章SharePoint Server 2016 的硬件和软件要求,其中列出了 SharePoint Server 2016 的所有必备和可选软件。 此外,本文还提供可通过 Internet 下载的每个必备组件的下载位置。 有关 SharePoint Server 2019 的硬件和软件要求,请参阅 SharePoint Server 2019 的硬件和软件要求

    若要了解 SharePoint 2013 版本,请参阅 SharePoint 2013 的硬件和软件要求

  2. 通过命令提示符,转到 SharePoint Server 安装介质或文件夹位置的根目录。

  3. 在命令提示符处,键入以下命令,然后按 Enter:

    PrerequisiteInstaller.exe /?

    这将显示用于从命令行安装必备组件的命令行选项和开关及其对应参数的列表。

    提示

    若要将处于活动状态的“关于”窗口的内容复制到剪贴板,请按 Ctrl+C。

  4. 确认您拥有必备软件的准确列表。 将必备组件安装程序的输出与步骤 1 中的必备组件列表进行比较。

  5. 将必备组件下载到可以访问 Internet 的计算机。

接下来,按照以下步骤操作,创建可用于在所有场服务器上安装 SharePoint Server 必备组件的集中位置。

合并必备组件的具体步骤

  1. 在将要安装必备组件的服务器可以访问的计算机上创建共享文件夹。

  2. 将从 Internet 下载的文件复制到共享文件夹。

创建可用的必备组件网络位置后,按照下一部分中的过程操作,在服务器上安装 SharePoint Server 必备组件。

通过命令提示符安装 SharePoint Server 必备组件

可以使用以下过程从命令行安装一个或更多必备组件。

通过命令行安装的具体步骤

  1. 从"开始"菜单中,使用"以管理员身份运行"选项打开命令提示符窗口。

  2. 转到 SharePoint Server 源目录。

  3. 键入要安装的程序的必备程序开关和相应参数,再按 Enter。对于 SharePoint Server 2016,请键入:

    PrerequisiteInstaller.exe /SQLNCli:“\o16-sf-admin\SP_prereqs\sqlncli.msi”

    注意

    若要安装多个必备组件,请键入每个开关和参数对。 请务必按空格分隔每对,例如: > PrerequisiteInstaller.exe /IDFX:“\<path>\Windows6.1-KB974405-x64.msu” /sqlncli:“\<path>\sqlncli.msi” /Sync:“\<path>\Synchronization.msi”

使用参数文件安装 SharePoint Server 必备组件

可以使用参数文件从文件共享安装必备组件,参数文件包含必须安装的程序的开关以及对应的路径语句。

使用参数文件运行 PrerequisiteInstaller.exe 时,会发生以下情况:

  1. PrerequisiteInstaller.exe 读取参数文件以确认每个开关都有效并且在路径语句中标识的程序确实存在。

    注意

    如果指定参数,PrerequisiteInstaller.exe 将忽略参数文件并且仅处理命令行参数。

  2. PrerequisiteInstaller.exe 扫描本地系统以确定是否已安装任何必备组件。

  3. PrerequisiteInstaller.exe 安装参数文件中的程序并返回以下退出代码之一:

  • 0 - 成功

  • 1 - 此应用程序的另一个实例已经在运行

  • 2 - 无效的命令行参数

  • 1001 - 挂起的重新启动阻止安装

  • 3010 - 需要重新启动

  1. If a prerequisite requires a restart, a 3010 code is generated and you are prompted to click Finish to restart the system. 生成 3010 代码之后安装程序的行为会有所不同,具体取决于计算机满足下列哪些条件:
  • 如果系统中已经安装需要重新启动的组件,将生成 3010 代码并安装剩余的必备组件。 安装完最后一个必备组件后提示您重新启动系统。

  • 如果需要重新启动的组件是通过 PrerequisiteInstaller.exe 在系统中安装的,则安装程序生成 3010 代码并跳过剩余必备组件的安装。 提示您重新启动系统。

    系统重新启动后,PrerequisiteInstaller.exe 开始再次运行,因为在重新启动之前创建的启动文件包含 /continue 标志。

    多个组件可能需要重新启动。 因此可能必须多次重新启动 PrerequisiteInstaller.exe。 重新启动后,PrerequisiteInstaller.exe 将忽略参数文件并尝试从 Internet 下载并安装其余必备组件。 有关详细信息,请参阅已知问题

使用以下过程创建参数文件。

创建参数文件的的具体步骤

  1. 使用文本编辑器新建名为 PrerequisiteInstaller.Arguments.txt 的文本文档。 将此文件保存到与 PrerequisiteInstaller.exe 相同的位置。 此文件将包含运行 Microsoft SharePoint 产品准备工具时使用的开关和参数。

  2. 使用文本编辑器编辑 PrerequisiteInstaller.Arguments.txt,并使用以下语法为每个必备组件开关提供安装源的文件路径:

    /switch: <path>

    其中 /switch 是有效的交换机, <路径> 是安装源的路径。

  3. PrerequisiteInstaller.Arguments.txt 编辑完成后,保存所做的编辑,并确认此文件与 PrerequisiteInstaller.exe 位于同一目录中。

使用以下过程安装必备组件。

使用参数文件安装必备组件的具体步骤

  1. 从命令提示符运行 PrerequisiteInstaller.exe 以安装必备组件。

    谨慎

    如果系统提示您单击“完成”以重新启动系统,请不要这样做。 请改为单击“取消”。 有关详细信息,请参阅已知问题,然后再继续执行下一步。

  2. 手动重新启动系统。

  3. 在命令提示符处,键入以下命令,然后按 Enter:

    PrerequisiteInstaller.exe

已知问题

有两个影响参数文件使用的已知问题:

  • 在参数文件中使用换行符

    如果您创建参数文件并使用换行符将每个开关和参数放在单独的行上,则必备组件安装程序失败。 解决办法是在一行中输入所有开关和参数对。

  • 计算机重新启动后未使用参数文件

    重新启动后,PrerequisiteInstaller.exe 会运行启动命令文件,它包含 /continue 标志。 /continue 标志强制安装程序忽略参数文件。

    必须使用下列方法之一在此命令文件中删除启动任务以阻止重新启动:

    方法 1

  1. 通过双击 PrerequisiteInstaller.exe 使其运行。 程序将显示第一个屏幕,其中包括必备组件列表。

  2. Click Cancel. PrerequisiteInstaller.exe 将删除启动任务。

    方法 2

  3. 从"开始"菜单中,选择"运行",然后键入 regedit 以打开注册表。

  4. 打开注册表项 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\Shell Folders。

  5. 检查“Common Startup”的值。 这会显示列出启动任务的目录。

  6. 关闭注册表编辑器,而不执行任何更改。

  7. 导航到启动目录,该目录通常为 <系统目录>\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup。

  8. 通过删除“SharePointServerPreparationToolStartup_0FF1CE14-0000-0000-0000-000000000000.cmd”来删除启动任务。