Psconfig 命令列參照 (SharePoint Server 2010)

 

適用版本: SharePoint Foundation 2010, SharePoint Server 2010

上次修改主題的時間: 2015-03-09

在 SharePoint 2010 產品中,您可以使用 Psconfig 命令列工具作為替代介面,以執行控制 SharePoint 2010 產品之設定方式的數項作業。您必須是本機電腦的管理員群組成員,才可執行這些作業。

本文內容

  • 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. upgrade

重要

如果 Psconfig 偵測到必須升級伺服器陣列,則會在您執行時,自動啟動升級 (即使未選取 upgrade 命令亦然)。

您可以指定以單一命令列字串執行所有命令。如果執行這項操作,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 Timer Service 工作,來同步處理伺服器陣列中所有 SharePoint 管理中心 Web 應用程式的連接埠。如果未指定連接埠,將會使用現有伺服器陣列中的 SharePoint 管理中心 Web 應用程式所使用的連接埠。如果尚未在伺服器陣列中佈建 SharePoint 管理中心 Web 應用程式,則會隨機選取預設連接埠 (如果未指定連接埠)。

[-windowsauthprovider <enablekerberos | onlyusentlm>]

SharePoint 管理中心 Web 應用程式驗證提供者為伺服器陣列的通用設定。變更驗證提供者時,將會發送 SharePoint Timer Service 工作,來同步處理伺服器陣列中所有 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>]

指定安裝語言的地區設定識別碼 (LCID)。

範例

psconfig.exe -cmd setup

standaloneconfig

執行 SharePoint 產品及設定的獨立設定。採用下列選用參數:

[-lcid <1033>]

指定安裝語言的地區設定識別碼 (LCID)。

範例

psconfig.exe -cmd standaloneconfig

upgrade

執行 SharePoint 2010 產品的升級。如果必須升級產品,則會在您執行 [SharePoint 產品設定精靈] 時自動執行此命令。採用下列選用參數:

[-wait]

如果已指定,升級完成後,[SharePoint 產品設定精靈] 才會返回。如果未指定,在發送 SharePoint Timer Service 工作以執行升級後,精靈便會返回。若要檢視升級工作狀態,您可以使用網頁瀏覽器存取 SharePoint 管理中心網站。

[-force]

如果已指定,[SharePoint 產品設定精靈] 會停止目前正在執行的升級動作,然後重新啟動升級。

[-reghostonupgrade]

如果已指定,[SharePoint 產品設定精靈] 會在升級期間將所有內容重設為網站定義版本。

[-inplace <v2v|b2b>]

如果已指定,[SharePoint 產品設定精靈] 會執行就地升級。如果指定 v2v,會執行版本對版本的就地升級。如果指定 b2b,會執行建置對建置的就地升級。

[-preserveolduserexperience]

如果設為 False,[SharePoint 產品設定精靈] 會更新網站以使用最新的 SharePoint 使用者經驗。如果未指定此參數,則預設值為 True。

[-passphrase]

用於加入伺服器陣列的複雜密碼。伺服器陣列中所有伺服器上的複雜密碼值必須相同,伺服器陣列才能正常運作。

範例

psconfig.exe -cmd upgrade -inplace v2v -wait