SharePoint 产品和技术配置向导的命令行参考 (Windows SharePoint Services)

在 SharePoint 产品和技术中,您可以将 psconfig.exe 命令行工具用作备用界面,在其中执行若干个控制 SharePoint 产品和技术的配置方式的操作。您必须是本地计算机上 Administrators 组的成员才能执行这些操作。

本文内容

  • 如何使用 psconfig.exe 命令

  • 可用的命令和参数

如何使用 psconfig.exe 命令

从命令行中运行 psconfig.exe 时,可以指定一些命令来控制该工具的运行方式。要从命令行中运行 psconfig.exe,请导航到 %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\bin 文件夹,然后使用以下语法键入命令:

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

下一节中的参考表包含若干个示例。还可以从命令行界面中使用帮助。要查看帮助,请在命令行中键入以下内容:

psconfig.exe -?

要获取有关特定命令的帮助,请键入以下内容:

psconfig.exe -help <command name>

在 psconfig.exe 中的命令需要按照特定的顺序运行才能运行成功。如果您使用 SharePoint 产品和技术配置向导配置您的安装,则它会为您按照正确的顺序调用命令(也称为配置任务)。然而,如果您使用命令行运行 psconfig.exe,则需要确保按照正确的顺序执行任务。psconfig.exe 命令必须按照以下顺序执行:

  1. configdb

  2. helpcollections

  3. secureresources

  4. services

  5. installfeatures

  6. adminvs

  7. evalprovision(仅用于独立安装)

  8. applicationcontent

  9. upgrade

Important重要说明:

如果 psconfig.exe 检测到服务器场需要升级,则它将在运行时自动启动升级(即使没有选择升级命令)。

您可以在一个命令行字符串中指定所有要运行的命令。此时,psconfig.exe 将按照正确的顺序运行所有命令。例如,在命令行中,您可以按如下所示运行一个命令:

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>

有关从命令行中配置服务器或服务器场的详细信息,请参阅 Windows SharePoint Services TechCenter。

可用的命令和参数

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

命令 说明、参数和示例

?

显示可用于 psconfig.exe 的命令

示例

psconfig.exe -?

help <command name>

显示可用于 psconfig.exe 的命令。如果指定了命令名,则显示该命令的帮助。

示例

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>]

配置数据库所在的运行 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 Windows SharePoint Services 3.0 网站。如果未指定,则不删除该网站。

示例

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\12\LOGS 目录下。

示例

psconfig.exe -cmd quiet

secureresources

在服务器上执行 SharePoint 产品和技术资源安全保护。例如,对文件、文件夹和注册表项执行安全保护。

示例

psconfig.exe -cmd secureresources

services

管理 SharePoint 产品和技术服务。使用下列可选的参数:

[-install]

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

[-provision]

设置位于此服务器上的服务,并在以独立模式安装 SharePoint 产品和技术的情况下将服务设置为联机。设置服务还将确保这些服务已注册。

示例

psconfig.exe -cmd services -install

psconfig.exe -cmd services -provision

setup

根据安装模式执行 SharePoint 产品和技术的配置。还会修复该配置。如果产品或服务是在独立模式下安装的,则将执行独立配置。如果产品或技术不在独立模式下,则必须使用 SharePoint 产品和技术配置向导(而不是 psconfig.exe 命令行实用工具)完成初始配置。要运行该向导,请在“开始”菜单上,依次指向“所有程序”、“管理工具”,然后单击“SharePoint 产品和技术配置向导”。

如果要修复独立安装,请首先运行 setup /repair(有关详细信息,请参阅安装帮助系统),然后运行 psconfig.exe -setup。对于服务器场安装,在运行 setup /repair 后,使用 SharePoint 产品和技术配置向导而不是 psconfig.exe 命令行实用工具。

使用下列可选的参数:

[-lcid <1033>]

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

示例

psconfig.exe -cmd setup

standaloneconfig

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

[-lcid <1033>]

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

示例

psconfig.exe -cmd standaloneconfig

upgrade

执行 SharePoint 产品和技术升级。如果产品或技术需要升级,则此命令将在运行 SharePoint 产品和技术配置向导时自动运行。使用下列可选的参数:

[-wait]

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

[-force]

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

[-reghostonupgrade]

如果指定此参数,SharePoint 产品和技术配置向导将在升级过程中将所有内容重置为网站定义版本。

[-finalize]

如果指定此参数,SharePoint 产品和技术配置向导将完成当前升级。仅当您已经成功升级所有网站且不再需要连接到以前的版本时,才执行此操作。您将无法撤消此操作。

[-inplace <v2v|b2b>]

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

[-sidebyside]

如果指定此参数,SharePoint 产品和技术配置向导将执行逐步升级。

示例

psconfig.exe -cmd upgrade -inplace v2v -wait
psconfig.exe -cmd upgrade -sidebyside -reghostonupgrade
psconfig.exe -cmd upgrade -finalize

下载书籍

本主题包含在以下可下载书籍内,以方便您阅读和打印:

如需查看可下载书籍的完整列表,请参阅有关 Windows SharePoint Services 的可下载书籍