Befehlszeilenreferenz für den Konfigurations-Assistenten für SharePoint-Produkte und -Technologien (Windows SharePoint Services)
In SharePoint-Produkte und -Technologien können Sie das Befehlszeilentool psconfig.exe als alternative Schnittstelle zum Ausführen mehrerer Vorgänge verwenden, mit denen die Konfiguration für SharePoint-Produkte und -Technologien gesteuert wird. Sie müssen ein Mitglied der Gruppe Administratoren auf dem lokalen Computer sein, um diese Vorgänge auszuführen.
Inhalt dieses Artikels
Verwenden der Befehle von "psconfig.exe"
Verfügbare Befehle und Parameter
Verwenden der Befehle von "psconfig.exe"
Wenn Sie psconfig.exe in der Befehlszeile ausführen, können Sie Befehle angeben, mit denen die Ausführung des Tools gesteuert wird. Um psconfig.exe in der Befehlszeile auszuführen, navigieren Sie zum Ordner %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\bin und geben die Befehle mithilfe der folgenden Syntax ein:
Psconfig.exe -cmd <command> [optional parameters]
Die Referenztabelle im nächsten Abschnitt enthält einige Beispiele. In der Befehlszeilenschnittstelle ist auch Hilfe erhältlich. Geben Sie Folgendes ein, um in der Befehlszeile Hilfe anzuzeigen:
psconfig.exe -?
Geben Sie Folgendes ein, um Hilfe zu einem bestimmten Befehl anzuzeigen:
psconfig.exe -help <command name>
Die Befehle in psconfig.exe müssen in einer bestimmten Reihenfolge ausgeführt werden. Wenn Sie den Konfigurations-Assistenten für SharePoint-Produkte und -Technologien zum Konfigurieren Ihrer Installation verwenden, werden die Befehle (werden auch als Konfigurationsaufgaben bezeichnet) in der richtigen Reihenfolge aufgerufen. Wenn Sie jedoch die Befehlszeile zum Ausführen von psconfig.exe verwenden, müssen Sie die Aufgaben unbedingt in der richtigen Reihenfolge ausführen. Die Befehle von psconfig.exe müssen in der folgenden Reihenfolge ausgeführt werden:
configdb
helpcollections
secureresources
services
installfeatures
adminvs
evalprovision (nur für eigenständige Installationen)
applicationcontent
upgrade
Wichtig
Wenn psconfig.exe erkennt, dass die Serverfarm aktualisiert werden muss, wird automatisch ein Upgrade gestartet (selbst wenn Sie den Befehl upgrade nicht ausgewählt haben).
Sie können alle auszuführenden Befehle in einer einzigen Befehlszeilen-Zeichenfolge angeben. In diesem Fall werden alle Befehle von psconfig.exe in der richtigen Reihenfolge ausgeführt. Beispielsweise können Sie in der Befehlszeile folgenden Befehl ausführen:
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>
Weitere Informationen zum Konfigurieren Ihres Servers oder Ihrer Serverfarm in der Befehlszeile finden Sie im Windows SharePoint Services TechCenter.
Verfügbare Befehle und Parameter
Im Konfigurations-Assistenten für SharePoint-Produkte und -Technologien werden die folgenden Befehlszeilenoptionen erkannt.
| Befehl | Beschreibung, Parameter und Beispiele |
|---|---|
|
Zeigt die für die Verwendung mit psconfig.exe verfügbaren Befehle an. Beispiel |
|
Zeigt die Befehle an, die für die Verwendung mit psconfig.exe verfügbar sind. Wenn ein Befehlsname angegeben ist, wird Hilfe für diesen Befehl angezeigt. Beispiel
|
|
Verwaltet die Webanwendung für die SharePoint-Zentraladministration auf dem lokalen Computer. Die folgenden optionalen Parameter sind möglich: [-provision] Stellt die Webanwendung für die SharePoint-Zentraladministration auf diesem Server bereit. Durch die Bereitstellung werden ein neuer virtueller Server für die Webanwendung für die SharePoint-Zentraladministration und ein Anwendungspool erstellt, die unter dem Administratorkonto der Serverfarm ausgeführt werden. [-unprovision] Hebt die Bereitstellung der Webanwendung für die SharePoint-Zentraladministration auf diesem Server auf. Durch das Aufheben der Bereitstellung werden der virtuelle Server der Webanwendung für die SharePoint-Zentraladministration und dessen Anwendungspool entfernt. [-port <port number>] Der Port der Webanwendung für die SharePoint-Zentraladministration ist eine globale Einstellung der Serverfarm. Beim Ändern des Ports wird ein Auftrag für einen SharePoint-Timerdienst abgesendet, um den Port für alle Webanwendungen für die SharePoint-Zentraladministration in der Serverfarm zu synchronisieren. Falls kein Port angegeben ist, wird der Port verwendet, der für vorhandene Webanwendungen für die SharePoint-Zentraladministration in der Serverfarm verwendet wird. Falls keine Webanwendung für die SharePoint-Zentraladministration in der Serverfarm bereitgestellt wurde, wird ein zufälliger Port als Standardport ausgewählt, wenn kein Port angegeben ist. [-windowsauthprovider <enablekerberos | onlyusentlm>] Der Webanwendung-Authentifizierungsanbieter für die SharePoint-Zentraladministration ist eine globale Einstellung für die Serverfarm. Wenn der Authentifizierungsanbieter geändert wird, wird ein Auftrag für einen SharePoint-Timerdienst abgesendet, um den Anbieter in allen Webanwendungen für die SharePoint-Zentraladministration in der Serverfarm zu synchronisieren. Falls onlyusentlm angegeben ist, wird NTLM als exklusiver Authentifizierungsanbieter für alle Webanwendungen für die SharePoint-Zentraladministration verwendet. Alle anderen Authentifizierungsanbieter werden deaktiviert, und NTLM ist der einzige zulässige Authentifizierungsanbieter. Falls enablekerberos angegeben ist, wird die Kerberos-Authentifizierung für alle Webanwendungen für die SharePoint-Zentraladministration aktiviert. Falls kein Authentifizierungsanbieter angegeben ist, wird der Anbieter verwendet, der für vorhandene Webanwendungen für die SharePoint-Zentraladministration in der Serverfarm verwendet wird. Falls keine Webanwendung für die SharePoint-Zentraladministration in der Serverfarm bereitgestellt wurde, wird der Kerberos-Authentifizierungsanbieter aktiviert, falls kein Authentifizierungsanbieter angegeben wurde. Beispiele
|
|
Verwaltet freigegebene Anwendungsinhalte. Der folgende erforderliche Parameter ist möglich: -install Kopiert freigegebene Anwendungsdaten (d. h. Ressourcendateien, Webanwendungsbinärdateien) in vorhandene virtuelle Verzeichnisse für Webanwendungen. Beispiel
|
|
Stellt die Verbindung her oder trennt die Verbindung des Servers mit der Serverfarm. Die folgenden optionalen Parameter sind möglich: [-create] Erstellt eine neue Konfigurationsdatenbank und richtet dadurch eine neue Serverfarm ein. Wenn der Server bereits mit einer Konfigurationsdatenbank verbunden ist, wird zunächst die Verbindung getrennt. Anschließend wird die neue Konfigurationsdatenbank erstellt. [-disconnect] Trennt die Verbindung mit der Konfigurationsdatenbank und damit von der Serverfarm. [-connect] Stellt eine Verbindung mit einer vorhandenen Konfigurationsdatenbank her. Dadurch wird der Server mit einer vorhandenen Serverfarm verknüpft. Wenn dieser Server bereits mit einer Konfigurationsdatenbank verbunden ist, wird zunächst die Verbindung getrennt. Anschließend wird eine Verbindung mit der vorhandenen Konfigurationsdatenbank hergestellt. [-server <SQLServerName>] Der Computer mit SQL Server, auf dem sich die Konfigurationsdatenbank befindet. [-database <SQLDatabaseName>] Der Name der Konfigurationsdatenbank. [-dbuser <value>] Der für die SQL-Authentifizierung verwendete Benutzername. [-dbpassword <value>] Das für die SQL-Authentifizierung verwendete Kennwort. [-user <Domain\User>] Das Benutzerkonto des Serverfarmadministrators. [-password <Password>] Das Kennwort des Benutzerkontos des Serverfarmadministrators. [-addomain <value>] Der Name der Active Directory-Domäne, die für die Serverfarm verwendet wird. [-adorgunit <value>] Der Name der Active Directory-Organisationseinheit, die für die Serverfarm verwendet wird. [-admincontentdatabase <SQLAdminContentDatabaseName>] Der Name der Inhaltsdatenbank für die Webanwendung der Zentraladministration. Beispiele
|
|
Stellt diesen Server als eigenständigen Server bereit (Evaluierungsmodus). Die folgenden erforderlichen und optionalen Parameter sind möglich: -provision Führt die Bereitstellung des eigenständigen Modus auf diesem Server aus. [-port <port number>] Die der SharePoint-Standardwebanwendung zugewiesene Portnummer. Wenn sie nicht angegeben ist, wird Port 80 verwendet. Wenn bereits eine SharePoint-Webanwendung vorhanden ist, die den Port verwendet, wird die vorhandene Website überschrieben. Wenn eine vorhandene Website den Port verwendet und es sich dabei nicht um eine SharePoint-Webanwendung handelt, wird die Website deaktiviert und eine neue SharePoint-Webanwendung erstellt, die den Port verwendet. [-overwrite] Gibt an, ob eine vorhandene Microsoft Windows SharePoint Services 3.0-Website während der Installation überschrieben werden soll. Wenn dieser Parameter nicht angegeben ist, wird die Website nicht gelöscht. Beispiel
|
|
Verwaltet Hilfeauflistungen. Der folgende erforderliche Parameter ist möglich: -installall Installiert alle verfügbaren Hilfeauflistungen. Beispiel
|
|
Registriert alle Features von SharePoint-Produkte und -Technologien, die sich auf dem Dateisystem des Servers befinden, bei der Serverfarm. Beispiel
|
|
Führt den Konfigurations-Assistenten für SharePoint-Produkte und -Technologien im stillen Modus aus. Die Ausgabe wird in die Protokolldatei PSCONFIG.EXE_MM_TT_JJ_HH_MM_SS_MS.log geschrieben. Dabei steht _MM_TT_JJ_HH_MM_SS_MS für das vollständige Datum und die vollständige Uhrzeit, zu dem bzw. der das Dienstprogramm ausgeführt wurde. Die Protokolldatei wird im Verzeichnis %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\LOGS gespeichert. Beispiel
|
|
Erzwingt die Ressourcensicherheit von SharePoint-Produkte und -Technologien auf dem Server. Die Sicherheit wird z. B. für Dateien, Ordner und Registrierungsschlüssel erzwungen. Beispiel
|
|
Verwaltet die Dienste von SharePoint-Produkte und -Technologien. Die folgenden optionalen Parameter sind möglich: [-install] Registriert die auf diesem Server befindlichen Dienste in der Serverfarm. [-provision] Stellt die Dienste auf diesem Server bereit und legt die Dienste als online fest, wenn SharePoint-Produkte und -Technologien im eigenständigen Modus installiert sind. Durch das Bereitstellen der Dienste wird außerdem sichergestellt, dass sie registriert werden. Beispiel
|
|
Konfiguriert SharePoint-Produkte und -Technologien auf Basis des Installationsmodus. Außerdem wird die Konfiguration repariert. Wenn das Produkt oder die Technologie im eigenständigen Modus installiert ist, wird eine eigenständige Konfiguration ausgeführt. Wenn das Produkt oder die Technologie nicht im eigenständigen Modus installiert ist, müssen Sie die ursprüngliche Konfiguration mit dem Konfigurations-Assistenten für Microsoft SharePoint-Produkte und -Technologien anstelle des Befehlszeilenprogramms psconfig.exe ausführen. Zum Ausführen dieses Assistenten zeigen Sie im Startmenü auf Alle Programme, zeigen Sie auf Verwaltung, und klicken Sie dann auf Konfigurations-Assistent für SharePoint-Produkte und -Technologien. Wenn Sie eine eigenständige Installation reparieren möchten, führen Sie zunächst setup /repair (weitere Informationen finden Sie im Setup-Hilfesystem) und dann psconfig.exe -setup aus. Für Serverfarminstallationen verwenden Sie nach der Ausführung von setup /repair den Konfigurations-Assistenten für SharePoint-Produkte und -Technologien anstelle des Befehlszeilenprogramms psconfig.exe. Der folgende optionale Parameter ist möglich: [-lcid <1033>] Die Gebietsschema-ID (LCID), die die Installationssprache angibt. Beispiel
|
|
Führt eine eigenständige Konfiguration für SharePoint-Produkte und -Technologien aus. Die folgenden optionalen Parameter sind möglich: [-lcid <1033>] Die Gebietsschema-ID (LCID), die die Installationssprache angibt. Beispiel
|
|
Führt ein Upgrade von SharePoint-Produkte und -Technologien aus. Dieser Befehl wird bei der Ausführung des Konfigurations-Assistenten für SharePoint-Produkte und -Technologien automatisch ausgeführt, falls das Produkt oder die Technologie aktualisiert werden muss. Die folgenden optionalen Parameter sind möglich: [-wait] Wenn dieser Parameter angegeben ist, wird der Konfigurations-Assistent für SharePoint-Produkte und -Technologien erst nach Abschluss des Upgrades wieder angezeigt. Wenn dieser Parameter nicht angegeben wird, wird der Assistent wieder angezeigt, nachdem ein Auftrag für den SharePoint-Timerdienst zum Ausführen des Upgrades abgesendet wurde. Sie können den Auftragsstatus für das Upgrade anzeigen, indem Sie den Konfigurations-Assistenten für Microsoft SharePoint-Produkte und -Technologien über Ihren Webbrowser aufrufen. [-force] Wenn dieser Parameter angegeben ist, werden alle zurzeit ausgeführten Upgradeaktionen vom Konfigurations-Assistenten für SharePoint-Produkte und -Technologien beendet und das Upgrade wird neu gestartet. [-reghostonupgrade] Wenn dieser Parameter angegeben ist, wird der gesamte Inhalt vom Konfigurations-Assistenten für SharePoint-Produkte und -Technologien während des Upgrades auf die Websitedefinitionsversion zurückgesetzt. [-finalize] Wenn dieser Parameter angegeben ist, wird das aktuelle Upgrade vom Konfigurations-Assistenten für Microsoft SharePoint-Produkte und -Technologien abgeschlossen. Führen Sie diese Aktion nur aus, wenn Sie alle Websites erfolgreich aktualisiert haben und nicht mehr auf die vorherige Version zugreifen müssen. Sie können diese Aktion nicht rückgängig machen. [-inplace <v2v|b2b>] Wenn dieser Parameter angegeben ist, wird vom Konfigurations-Assistenten für Microsoft SharePoint-Produkte und -Technologien ein direktes Upgrade ausgeführt. Wenn v2v ausgewählt wird, wird ein direktes Upgrade von Version zu Version ausgeführt. Wenn b2b ausgewählt wird, wird ein direktes Upgrade von Build zu Build ausgeführt. [-sidebyside] Wenn dieser Parameter angegeben ist, wird vom Konfigurations-Assistenten für Microsoft SharePoint-Produkte und -Technologien ein schrittweises Upgrade ausgeführt. Beispiele |
Herunterladen dieses Buchs
Dieses Thema wurde zum leichteren Lesen und Ausdrucken in das folgende Buch zum Herunterladen aufgenommen:
Die vollständige Liste der verfügbaren Bücher finden Sie unter Bücher zum Herunterladen für Windows SharePoint Services.