使用 Windows PowerShell 安装 SharePoint Foundation 2010

 

适用于： SharePoint Foundation 2010

上一次修改主题： 2016-11-30

本文讨论如何使用 Windows PowerShell 在独立服务器或服务器场上执行 Microsoft SharePoint Foundation 2010 的干净安装。

本文内容：

• 服务器场服务器要求

• 准备 SPModule

• 通过运行 Install-SharePoint 安装 SharePoint Foundation 2010

• 使用 New-SharePointFarm 配置服务器场

• 使用 Windows PowerShell 创建 Web 应用程序

• 使用 SharePoint 2010 场配置向导来部署服务

• 使用 Windows PowerShell 创建网站集

• 执行其他配置任务

• 使用 Join-SharePointFarm 将服务器添加到服务器场

• 配置跟踪日志

您可以使用 Windows PowerShell 安装 Microsoft SharePoint Foundation 2010，并将其与其他管理员工具一起使用来自动化无人参与安装并配置服务器场，从而简化部署。

服务器场服务器要求

在安装 SharePoint Foundation 2010 之前，请查看以下有关权限、硬件要求和软件要求的信息，以及开始此过程之前要执行的步骤：

1. 确保您满足所有硬件和软件要求。 您必须拥有 64 位版本的 Windows Server 2008 或 Windows Server 2008 R2。 对于服务器场，您还必须拥有 64 位版本的 SQL Server 2005 或 SQL Server 2008。 For more information about these requirements (such as specific updates that you must install), see Determine hardware and software requirements (SharePoint Foundation 2010).

2. 确保您已使用合适的权限设置必需帐户。 For detailed information, see Administrative and service accounts required for initial deployment (SharePoint Foundation 2010).

准备 SPModule

SPModule.zip 文件是一个 Windows PowerShell 模块，它由将安装 SharePoint 场的 SharePoint 产品组的成员编写。

若要使用 SPModule.zip 文件，请执行以下步骤：

1. 从下面的下载中心页（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=187924&clcid=0x804)（该链接可能指向英文页面）下载 SPModule.zip 和文本文件。

2. 将这些文件提取到一个名为 SPModule 的文件夹中，然后将该文件夹添加到环境路径。PSModulePath 环境变量用于存储指向磁盘上已安装模块的位置的路径。若要查看 PSModulePath 变量中指定的路径，请在 Windows PowerShell 命令提示符处，键入 $env:PSModulePath。有关详细信息，请参阅 PSModule 环境变量（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=187757&clcid=0x804)（该链接可能指向英文页面）。完成提取操作后，SPModule 文件夹应包含两个文件，即：SPModule.misc 和 SPModule.setup。

   备注

   如果未将 SPModule 文件夹添加到 PSModulePath 变量，则必须指定用于加载 SPModule 的完整路径。

3. 决定要提供的签名类型。

   备注

   这些下载文件都是未签名的。若要提供自签名脚本，请参阅 AllSigned：对 PowerShell 脚本进行签名（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=187758&clcid=0x804)（该链接可能指向英文页面）。

   默认情况下，Windows PowerShell 执行策略将设置为“受限”，以使任何脚本都无法运行。若要更改执行策略，请运行 Set-ExecutionPolicy cmdlet。有关执行策略的其他信息，请参阅 About_Signing (https://go.microsoft.com/fwlink/?linkid=187759&clcid=0x804)。

4. 将 SPModule.misc 和 SPModule.setup 文件加载到 Windows PowerShell 中。

   1. 单击“开始”，指向“所有程序”，然后单击“Windows PowerShell V2”。在 Windows PowerShell 命令提示符窗口打开后，首先需要执行的操作是将该模块的路径添加到 Windows PowerShell 模块路径（假定您已在服务器上创建一个名为“SPModule”的文件夹）中：

   2. 右键单击“Windows PowerShell V2”，再单击“以管理员身份运行”。

      备注

      如果已安装 Microsoft SharePoint Foundation 2010，则可改为打开 SharePoint 2010 Management Shell。

   3. 在显示命令提示符窗口后，需要通过在 Windows PowerShell 命令提示符处键入以下语法，将该模块导入当前 Windows PowerShell 会话中，并将其添加到某个路径：

      Import-Module SPModule.misc
      
      Import-Module SPModule.setup
      

在导入 SPModule.misc 模块时，将调用一个更新检查。在 1.0 版中，这将检查一个文本文件，以查看是否存在更新的可用版本。如果您获知存在更新的可用版本，则可以下载该版本。成功完成 Import-Module 命令后，即可使用 SPModule。

重要

只应在 SPModule 的上下文中和本文所述的过程中使用以下命令：

1. Install-SharePoint：为 SharePoint Foundation 2010 安装所有二进制文件。有关详细信息，请参阅带有脚本的部署参考 (SharePoint Foundation 2010)

2. New-SharePointFarm：创建 SharePoint 场并执行以下相关任务：

   • 配置安全性

   • 创建一个可填入服务应用程序的共享服务 Web 应用程序。

   • 创建并配置管理中心网站。

   • 安装所有产品帮助文件。

   • 安装所有服务器场功能。

3. Join-SharePointFarm：将服务器添加到服务器场，然后对这些服务器进行配置。有关详细信息，请参阅带有脚本的部署参考 (SharePoint Foundation 2010)

安装 Windows PowerShell 2.0 版本后，可以使用 Windows PowerShell 的一项称为“远程处理”的新功能。通过使用远程处理功能和几行 Windows PowerShell 代码，管理员可在服务器场中远程安装多个服务器。有关远程处理和 SPModule 的详细信息，请参阅使用 SPModule 进行远程安装（该链接可能指向英文页面） (https://go.microsoft.com/fwlink/?linkid=187923&clcid=0x804)（该链接可能指向英文页面）。

通过运行 Install-SharePoint 安装 SharePoint Foundation 2010

在确定安装所必需的帐户后，可以安装 SharePoint Foundation 2010。该产品 DVD 包含配置文件 (Config.xml) 的示例。这些示例文件存储在 DVD 根目录的 \Files 文件夹下的各个文件夹中（这些文件夹对应于不同的方案）。下表描述了这些示例文件。

配置文件	说明
Setup\Config.xml	独立服务器安装，使用 Microsoft SQL Server 2005 Express Edition
SetupFarm\Config.xml	服务器场安装
SetupFarmSilent\Config.xml	静默模式下的服务器场安装
SetupFarmUpgrade\Config.xml	现有服务器场的就地升级
SetupSilent\Config.xml	静默模式下的独立服务器安装，使用 SQL Server 2005 Express Edition
SetupSingleUpgrade\Config.xml	现有单一服务器安装的就地升级

在 Windows PowerShell 命令提示符处，将 Install-SharePoint 与 Config.xml 文件一起运行

1. 在 SharePoint Foundation 2010 产品 DVD 所在的驱动器上，切换到根目录，找到 setup.exe 文件。

2. 将 SPModule.Setup Install-SharePoint 与选定的 Config.xml 文件一起运行，如下所示：

   Install-SharePoint -SetupExePath <路径和文件名> -ConfigXml <路径和文件名>

   备注

   您可以选择其中一个示例文件，也可以自定义自己的配置文件。

3. 按 Enter。

安装现已完成。

下面的示例演示了用于在静默模式 (SetupSilent) 下设置单服务器的配置文件。

<Configuration><Package Id="sts">  <Setting Id="LAUNCHEDFROMSETUPSTS" Value="Yes" />  </Package><Package Id="spswfe">  <Setting Id="SETUPCALLED" Value="1" />  </Package>  <Logging Type="verbose" Path="%temp%" Template="SharePoint Server Setup(*).log" />- <!--<PIDKEY Value="Enter Product Key Here" />  -->  <Display Level="none" CompletionNotice="no" />  <Setting Id="SERVERROLE" Value="APPLICATION" />  <Setting Id="USINGUIINSTALLMODE" Value="0" />  <Setting Id="SETUP_REBOOT" Value="Never" />  <Setting Id="SETUPTYPE" Value="CLEAN_INSTALL" />  </Configuration>

您还可以自定义自己的配置文件。若要控制安装，首先在文本编辑器中编辑 Config.xml 文件，以便包含您需要的元素并使那些元素具有适当的设置。紧接着，运行 Install-SharePoint -SetupExePath -ConfigXML 以指定安装程序运行并使用 Config.xml 文件中设置的选项。

一些典型的配置选项包括：

• 通过在 Config.xml 文件中将产品密钥作为一个值 <PIDKEY Value="Enter PID Key Here" /> 提供来绕过产品密钥提示。

• 添加日志文件 <Logging Type="off" | "standard"(default) | "verbose" Path="path" Template="file name.log"/> 的位置，可以在命令行安装失败时查看该日志文件。

重要

使用文本编辑器（如记事本）来编辑 Config.xml。不要使用通用的 XML 编辑器，如 Microsoft Office Word 2007。若要验证 XML 文件格式是否正确，请使用任何支持的浏览器。

使用 PID 密钥运行 Install-SharePoint

若要在静默模式下运行安装程序，而不使用 XML 配置文件，请在 Windows PowerShell 命令提示符处键入下列命令之一：

• 对于独立服务器：Install-SharePoint -SetupExePath "<drive letter>:\SharePoint 2010\Setup\setup.exe" -ServerRole "SINGLESERVER"

• 对于服务器场部署：Install-SharePoint -SetupExePath "<drive letter>:\SharePoint 2010\Setup\setup.exe"

若要使用 XML 配置文件在静默模式下运行安装程序，请在 Windows PowerShell 命令提示符处键入下列命令之一：：

• 对于独立服务器：Install-SharePoint -SetupExePath "G:\SharePoint 2010\Setup\setup.exe" -ConfigXML "G:\SharePoint 2010\Setup\Config\singleserver_config.xml" -ServerRole "SINGLESERVER"

• 对于服务器场部署：Install-SharePoint -SetupExePath "G:\SharePoint 2010\Setup\setup.exe" -ConfigXML "G:\SharePoint 2010\Setup\Config\appserver_config.xml"

备注

对于 Microsoft SharePoint Foundation 2010，不需要指定 PIDKey 参数。

使用 New-SharePointFarm 配置服务器场

在完成 Install-SharePoint 命令后，可使用 New-SharePointFarm 命令配置 SharePoint Foundation 2010。配置选项是不同的，具体取决于是在独立服务器上还是服务器场上安装 SharePoint Foundation 2010。

在独立服务器上配置 SharePoint FoundationServer 2010

在独立服务器部署中，可以运行 New-SharePointFarm。在使用先前创建和配置的“安装”用户帐户登录后，可配置 SharePoint Foundation 2010。

使用 New-SharePointFarm 在独立服务器上配置 SharePoint FoundationServer 2010

• 在 Windows PowerShell 命令提示符处，键入以下命令：

  New-SharePointFarm -DatabaseServer <String> -DatabaseAccessAccount <(Get-Credential domain\account)> -FarmName <string>
  

  其中：

  • <String> 是数据库服务器的名称。例如“SQL01”。

  • <PSCredential> 是执行安装的用户帐户的域\密码。

  • <String> 是服务器场的名称。例如“Farm1”。

New-SharePointFarm 命令将在配置步骤执行时对其进行描述，并指明配置成功完成。对于独立服务器安装，这是命令行安装的最后一个步骤。

在创建网站之前，强烈建议您在所有服务器场的服务器上安装并配置 SharePoint Foundation 2010。

警告

不要在多台计算机上同时运行 New-SharePointFarm 和 Join-SharePointFarm 命令，因为这会导致出现争用问题和不可预测的行为。

备注

如果其中的任何命令失败，则请查看安装后的配置日志文件。这些日志文件位于 %COMMONPROGRAMFILES%\Microsoft shared\Web server extensions\14\Logs 中，可使用以 PowerShell_ConfigurationDiagnostics 开头的文件名和 .log 文件扩展名来标识它们。

备注

本节提到的 Windows PowerShell cmdlet 必须从 SharePoint 2010 Management Shell 运行。

若要连接到现有配置数据库，并将服务器联接到现有服务器场，则必须按此顺序将 Connect–SPConfigurationDatabase cmdlet 与下面的 Windows PowerShell cmdlet 一起运行：

• Install-SPHelpCollection

• Initialize-SPResourceSecurity

• Install-SPService

• Install-SPFeature -AllExistingFeatures

• Install-SPApplicationContent

使用 Windows PowerShell 创建 Web 应用程序

使用 New-SPWebApplication cmdlet 可创建 Web 应用程序和新的内容数据库。

创建 Web 应用程序

1. 验证您是否满足以下最低要求：请参阅 Add-SPShellAdmin。

2. 在“开始”菜单上，单击“所有程序”。

3. 单击“Microsoft SharePoint 2010 产品”。

4. 单击“SharePoint 2010 Management Shell”。

5. 在 Windows PowerShell 命令提示符处，键入以下命令：

   New-SPWebApplication -ApplicationPool <String> -Name 
   <InternetSite>
    -ApplicationPoolAccount (Get-SPManagedAccount 
   <DOMAIN\UserName>
   

   其中：

   • <ApplicationPool> 是应用程序池的名称。例如，“SharePoint -80”。

   • <InternetSite> 是 Web 应用程序的名称。

   • Domain\UserName 是应用程序池帐户的名称。

有关详细信息，请参阅New-SPWebApplication。

备注

我们建议您在执行命令行管理任务时使用 Windows PowerShell。Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

使用 SharePoint 2010 场配置向导来部署服务

安装时可使用 SharePoint 产品配置向导来部署服务。有关服务和服务应用程序的信息，请参阅管理服务应用程序和服务 (SharePoint Foundation 2010)。

使用 Windows PowerShell 创建网站集

可使用 New-SPSite cmdlet 创建首要网站集。New-SPSite cmdlet 可在特定 URL 处创建网站集，其中指定用户将作为网站所有者。

创建网站集

1. 验证您是否满足以下最低要求：请参阅 Add-SPShellAdmin。

2. 在“开始”菜单上，单击“所有程序”。

3. 单击“Microsoft SharePoint 2010 产品”。

4. 单击“SharePoint 2010 Management Shell”。

5. 在 Windows PowerShell 命令提示符处，键入以下命令：

   New-SPSite 
   <SiteURL>
    -OwnerAlias 
   <DOMAIN\UserName>
   

   其中：

   • <SiteURL> 是新网站的 URL。

   • <DOMAIN\UserName> 是网站所有者的用户登录名。

有关详细信息，请参阅New-SPSite。

备注

我们建议您在执行命令行管理任务时使用 Windows PowerShell。Stsadm 命令行工具已被弃用，仍然包含该工具是为了支持与之前产品版本的兼容性。

如果不指定要使用的网站模板，则网站所有者可在首次浏览网站时选择网站模板。可以使用 Get-SPWebTemplate cmdlet 来显示模板列表。

有关 SharePoint Foundation 2010 中常见模板的完整列表，请参阅带有脚本的部署参考 (SharePoint Foundation 2010)

若要使用 Windows PowerShell 创建其他网站集，可以使用 New-SPSite cmdlet。

备注

若要使用新网站来创建新的内容数据库，请使用 New-SPContentDatabase cmdlet 或带 ContentDatabase 参数的 New-SPSite。

创建网站后，可能需要配置备用访问映射。在用户与 SharePoint Foundation 2010 进行交互的过程中（例如，在浏览到 SharePoint 网站的主页时），备用访问映射可将用户定向到正确的 URL。备用访问映射使 SharePoint Foundation 2010 能够将 Web 请求映射到正确的 Web 应用程序和网站，并使 SharePoint Foundation 2010 能够为用户返回正确的内容。有关详细信息，请参阅 Set-SPAlternateUrl。

执行其他配置任务

安装 SharePoint Foundation 2010 后，建议您执行以下管理任务：

• 配置传出电子邮件设置。

• 配置工作流设置。

• 配置诊断日志记录设置。

• 配置防病毒设置。

使用 Join-SharePointFarm 将服务器添加到服务器场

必须在要添加到服务器场中的所有服务器上运行 Join-SharePointFarm 命令。若要连接到现有配置数据库，并将服务器联接到现有服务器场，请在服务器上键入以下命令（安装 SharePoint Foundation 2010 之后）：

Join-SharePointFarm -DatabaseServer 
<String>
 -ConfigurationDatabaseName 
<String>
 -Passphrase 
<SecureString>

其中：

• <String> 是数据库服务器的名称。例如 SQL01。

• <SecureString> 是格式为 DOMAIN\password 的用户帐户的密码。

配置跟踪日志

跟踪日志对于分析可能出现的问题非常有用。您可以使用写入跟踪日志中的事件确定在发生问题前在 SharePoint Foundation 2010 中进行了哪些配置更改。

默认情况下，SharePoint Foundation 2010 在跟踪日志文件中保存 14 天内发生的事件。这意味着，包含 14 天以前发生的事件的跟踪日志文件将被删除。可以使用 Set-SPLogLevel cmdlet 来配置所有诊断日志记录。

您可以使用管理中心中的“诊断日志记录”页来配置要保留的最大跟踪日志文件数以及每个日志文件应捕获多长时间（以分钟为单位）内发生的事件。

也可以使用 Set-SPLogLevel cmdlet 来指定写入日志文件的位置或接受默认路径。

跟踪日志文件可帮助解决与 Microsoft SharePoint Foundation 搜索服务的配置更改相关的问题。由于并不总是能够立即发现与配置更改相关的问题，因此建议您无论何时更改配置，都要保存系统创建的所有跟踪日志文件。将这些日志文件在某个将不会被覆盖的安全位置存储一段时间。建议您将日志文件存储在仅用于存储日志文件的硬盘驱动器分区上。

有关诊断日志记录的其他信息，请参阅配置诊断日志记录 (SharePoint Foundation 2010)