Psconfig 命令行参考 (SharePoint Server 2010)

 

适用于: SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题: 2015-03-09

在 SharePoint 2010 产品中,您可以将 Psconfig 命令行工具用作备用界面来执行用于控制 SharePoint 2010 产品 的配置方式的多个操作。您必须是本地计算机上的 Administrators 组的成员才能执行这些操作。

本文内容:

  • 如何使用 Psconfig 命令

  • 可用的命令和参数

如何使用 Psconfig 命令

在命令提示符处运行 Psconfig 时,您可以指定命令以控制该工具的运行方式。若要在命令提示符处运行 Psconfig,请导航到 %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\bin 文件夹,然后使用以下语法键入命令:

psconfig.exe -cmd <command> [optional parameters]

下一节中的参考表包含多个示例。也可从命令行界面获取帮助。若要查看帮助,请在命令提示符处键入:

psconfig.exe -?

若要查看有关特定命令的帮助,请键入:

psconfig.exe -help <command name>

Psconfig 中的命令必须按特定顺序运行才能成功运行。如果您使用 SharePoint 产品配置向导配置安装,则它会按正确的顺序调用命令(也称作“配置任务”)。但是,如果您使用命令行运行 Psconfig,则必须确保按正确的顺序执行任务。Psconfig 命令必须按以下顺序执行:

  1. configdb

  2. helpcollections

  3. secureresources

  4. services

  5. installfeatures

  6. adminvs

  7. evalprovision (仅针对独立安装)

  8. applicationcontent

  9. 升级

重要

如果 Psconfig 检测到尚未升级服务器场,则它将在您运行它时自动启动升级(即使您未选择升级命令)。

您可以指定所有命令在一个命令行字符串中运行。如果您这样做,则 Psconfig 将按正确的顺序运行所有命令。例如,在命令提示符处,您可以运行与以下命令类似的命令:

psconfig.exe -cmd configdb <parameters>
-cmd helpcollections <parameters>
-cmd secureresources <parameters>
-cmd services <parameters>
-cmd installfeatures <parameters>
-cmd adminvs <parameters>
-cmd evalprovision <parameters>
-cmd applicationcontent <parameters>

有关如何从命令行配置服务器或服务器场的详细信息,请参阅 Microsoft SharePoint Server 2010 TechCenter。

可用的命令和参数

在 SharePoint 产品配置向导中,可识别以下命令行选项。

命令 说明、参数和示例

?

显示可用于 Psconfig 的命令。

示例

psconfig.exe -?

help <command name>

显示可用于 Psconfig 的命令。如果指定一个命令名,则会显示该命令的帮助。

示例

psconfig.exe -help adminvs

adminvs

在本地计算机上管理 SharePoint 管理中心 Web 应用程序。使用以下可选参数:

[-provision]

在此服务器上设置 SharePoint 管理中心 Web 应用程序。此设置操作会创建一个新的 SharePoint 管理中心 Web 应用程序和一个在服务器场管理员帐户下运行的应用程序池。

[-unprovision]

从该服务器取消设置 SharePoint 管理中心 Web 应用程序。此取消设置操作会删除 SharePoint 管理中心 Web 应用程序及其应用程序池。

[-port <port number>]

此 SharePoint 管理中心 Web 应用程序端口是对服务器场的全局设置。更改该端口时,将调度 SharePoint 定时服务作业,以同步服务器场中所有 SharePoint 管理中心 Web 应用程序的端口。如果没有指定端口,将使用服务器场中现有 SharePoint 管理中心 Web 应用程序所用的端口。如果在服务器场中没有设置 SharePoint 管理中心 Web 应用程序,那么,如果没有指定端口,将随机选择默认端口。

[-windowsauthprovider <enablekerberos | onlyusentlm>]

此 SharePoint 管理中心 Web 应用程序验证提供程序是对服务器场的全局设置。更改该验证提供程序时,将调度 SharePoint 定时服务作业,以同步服务器场中所有 SharePoint 管理中心 Web 应用程序上的提供程序。如果指定 onlyusentlm,NTLM 将成为所有 SharePoint 管理中心 Web 应用程序独占的验证提供程序。其他所有验证提供程序将被禁用,NTLM 将是唯一允许的验证提供程序。如果指定 enablekerberos,将对所有 SharePoint 管理中心 Web 应用程序都启用 Kerberos 身份验证。如果没有指定验证提供程序,将使用服务器场中现有 SharePoint 管理中心 Web 应用程序所用的提供程序。如果在服务器场中没有设置 SharePoint 管理中心 Web 应用程序,那么,如果没有指定验证提供程序,将启用 Kerberos 身份验证提供程序。

示例

psconfig.exe -cmd adminvs -provision -port 8080 -windowsauthprovider onlyusentlm

psconfig.exe -cmd adminvs -unprovision

applicationcontent

管理共享应用程序内容。使用以下必选参数:

-install

将共享应用程序数据(例如,资源文件和 Web 应用程序二进制文件)复制到现有 Web 应用程序虚拟目录。

示例

psconfig.exe -cmd applicationcontent -install

configdb

创建、连接此服务器或将其与服务器场断开连接。使用以下可选参数:

[-create]

创建新的配置数据库,从而建立新的服务器场。如果此服务器已连接到某配置数据库,将会首先断开该服务器的连接,然后创建新的配置数据库。

[-disconnect]

将此服务器与配置数据库断开连接,从而将其与服务器场断开连接。

[-connect]

连接到现有配置数据库,从而将此服务器联接到现有服务器场。如果此服务器已连接到某配置数据库,将会首先断开该服务器的连接,然后连接到现有配置数据库。

[-server <SQLServerName>]

运行配置数据库所在的 Microsoft SQL Server 的计算机。

[-database <SQLDatabaseName>]

配置数据库名称。

[-dbuser <value>]

用于 SQL 身份验证的用户名。

[-dbpassword <value>]

用于 SQL 身份验证的密码。

[-user <Domain\User>]

服务器场管理员用户帐户。

[-password <Password>]

服务器场管理员用户帐户密码。

[-addomain <value>]

用于服务器场的 Active Directory 域名。

[-adorgunit <value>]

用于服务器场的 Active Directory 组织单位名称。

[-admincontentdatabase <SQLAdminContentDatabaseName>]

管理中心 Web 应用程序内容数据库名称。

示例

psconfig.exe -cmd configdb -create -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

-user <DOMAIN\username> -password <password>

-addomain <domain_name> -adorgunit <org_unit>

-admincontentdatabase <Database_name>

psconfig.exe -cmd configdb -disconnect

psconfig.exe -cmd configdb -connect -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

evalprovision

将此服务器设置为独立(评估模式)服务器。使用以下必选参数和可选参数:

-provision

在此服务器上执行独立模式设置。

[-port <port number>]

分配给默认 SharePoint Web 应用程序的端口号。如果未指定,则使用端口 80。如果已存在使用该端口的 SharePoint Web 应用程序,则将替代现有网站。如果正在使用该端口的现有网站不是 SharePoint Web 应用程序,则将禁用该网站,同时使用该端口新建一个 SharePoint Web 应用程序。

[-overwrite]

指定在安装过程中是否替代任何现有 Microsoft SharePoint Server 2010 网站。如果未指定,则不删除该网站。

示例

psconfig.exe -cmd evalprovision -provision -port 1100

helpcollections

管理帮助集合。使用以下必选参数:

-installall

安装所有可用帮助集合。

示例

psconfig.exe -cmd helpcollections -installall

installfeatures

将位于此服务器的文件系统上的任何 SharePoint 产品和技术功能注册到服务器场。

示例

psconfig.exe -cmd installfeatures

quiet

在安静模式下运行 SharePoint 产品配置向导。输出将会写入到名为 PSCONFIG.EXE_MM_DD_YY_HH_MM_SS_MS.log 的日志文件中,其中“_MM_DD_YY_HH_MM_SS_MS”为运行实用工具的完全日期和时间。该日志文件存储在 %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\LOGS 目录中。

示例

psconfig.exe -cmd quiet

secureresources

在服务器上强制实施 SharePoint 2010 产品资源安全保护。例如,对文件、文件夹和注册表项强制实施安全保护。

示例

psconfig.exe -cmd secureresources

services

管理 SharePoint 2010 产品服务。使用以下可选参数:

[-install]

在服务器场中注册位于此服务器上的服务。

[-provision]

设置位于此服务器上的服务,并且如果在独立模式下安装 SharePoint 2010 产品,则将服务设置为脱机。设置服务还将确保注册这些服务。

备注

[-provision] 参数仅适用于单服务器独立安装。不要将此参数用于服务器场安装。

示例

psconfig.exe -cmd services -install

psconfig.exe -cmd services -provision

setup

基于安装模式执行 SharePoint 2010 产品的配置。还将修复配置。如果在独立模式下安装产品,则独立配置是完整的。如果未在独立模式下安装产品,则您必须通过使用 SharePoint 产品配置向导而非 Psconfig 命令行工具来完成初始配置。若要运行此向导,请在“开始”菜单上,指向“所有程序”,再指向“管理工具”,然后单击“SharePoint 产品配置向导”。

若要修复独立安装,请先运行 setup /repair (有关详细信息,请参阅安装程序帮助系统),然后 psconfig.exe -setup。对于服务器场安装,在您运行 setup /repair后,使用 SharePoint 产品配置向导而非 Psconfig 命令行工具。

使用以下可选参数:

[-lcid <1033>]

指定安装语言的区域设置 ID (LCID)。

示例

psconfig.exe -cmd setup

standaloneconfig

执行 SharePoint 产品和技术的独立配置。使用以下可选参数:

[-lcid <1033>]

指定安装语言的区域设置 ID (LCID)。

示例

psconfig.exe -cmd standaloneconfig

upgrade

执行 SharePoint 2010 产品的升级。如果必须升级该产品,则在您运行 SharePoint 产品配置向导时,此命令将自动运行。使用以下可选参数:

[-wait]

如果指定此参数,SharePoint 产品配置向导在升级完成之前将不会返回。如果不指定此参数,则该向导会在调度 SharePoint 定时服务作业来执行升级之后返回。您可以通过 Web 浏览器来访问 SharePoint 管理中心 Web 应用程序,查看升级作业状态。

[-force]

如果指定此参数,SharePoint 产品配置向导将停止当前正在运行的任何升级操作,然后重新启动升级程序。

[-reghostonupgrade]

如果指定此参数,SharePoint 产品配置向导将在升级期间将所有内容重置为网站定义版本。

[-inplace <v2v|b2b>]

如果指定此参数,SharePoint 产品配置向导将执行就地升级。如果指定 v2v,将执行版本就地升级。如果指定 b2b,将执行就地内部版本升级。

[-preserveolduserexperience]

如果设置为 False,SharePoint 产品配置向导将更新网站以使用最新的 SharePoint 用户体验。如果不指定此参数,则默认为 True。

[-passphrase]

密码用于加入此服务器场。注意:服务器场中所有服务器上的密码值必须相同,服务器场才能正常运行。

示例

psconfig.exe -cmd upgrade -inplace v2v -wait