Befehlszeilenreferenz für den Konfigurations-Assistenten für SharePoint-Produkte und -Technologien (Office SharePoint Server)

In den SharePoint-Produkten und -Technologien können Sie das Befehlszeilentool psconfig.exe als alternative Schnittstelle zur Durchführung verschiedener Vorgänge verwenden, über die die Konfiguration der SharePoint-Produkte und -Technologien gesteuert wird. Sie müssen 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 an der Befehlszeile ausführen, können Sie Befehle zum Steuern der Ausführung des Tools angeben. Zum Ausführen von psconfig.exe an der Befehlszeile navigieren Sie zum Ordner %COMMONPROGRAMFILES%\Microsoft Shared\Web Server extensions\12\bin. Geben Sie dann die Befehle mithilfe der folgenden Syntax ein:

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

Die Referenztabelle im nächsten Abschnitt enthält einige Beispiele. Über die Befehlszeilenschnittstelle steht zusätzliche Hilfe zur Verfügung. Zum Anzeigen der Hilfe geben Sie Folgendes an der Befehlszeile ein:

psconfig.exe -?

Um Hilfe zu einem bestimmten Befehl zu erhalten, geben Sie Folgendes ein:

psconfig.exe -help <command name>

Für eine erfolgreiche Ausführung müssen die Befehle in psconfig.exe in einer bestimmten Reihenfolge ausgeführt werden. Wenn Sie den Konfigurations-Assistenten für SharePoint-Produkte und-Technologien zum Konfigurieren der Installation verwenden, werden die Befehle (auch Konfigurationsaufgaben genannt) in der richtigen Reihenfolge aufgerufen. Wenn Sie die Befehlszeile zum Ausführen von psconfig.exe verwenden, müssen Sie jedoch darauf achten, die Aufgaben in der richtigen Reihenfolge auszuführen. Die psconfig.exe-Befehle müssen in der folgenden Reihenfolge ausgeführt werden:

  1. configdb

  2. helpcollections

  3. secureresources

  4. services

  5. installfeatures

  6. adminvs

  7. evalprovision (nur für eigenständige Installationen)

  8. applicationcontent

  9. upgrade

Wichtig

Wenn psconfig.exe erkennt, dass die Serverfarm aktualisiert werden muss, wird beim Ausführen automatisch eine Aktualisierung gestartet (selbst wenn Sie den Befehl zum Aktualisieren nicht ausgewählt haben).

Sie können alle auszuführenden Befehle in einer einzelnen Befehlszeilenzeichenfolge angeben. Wenn Sie dies tun, führt psconfig.exe alle Befehle in der richtigen Reihenfolge aus. An der Befehlszeile können Sie beispielsweise einen Befehl ausführen, der dem Folgenden ähnlich ist:

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>

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 Befehle für die Verwendung mit psconfig.exe an.

Beispiel

psconfig.exe -?

help <command name>

Zeigt die Befehle für die Verwendung mit psconfig.exe an. Wird ein Befehlsname angegeben, wird die Hilfe für diesen Befehl angezeigt.

Beispiel

psconfig.exe -help adminvs

adminvs

Verwaltet die SharePoint-Webanwendung für die Zentraladministration auf dem lokalen Computer. Verwendet die folgenden optionalen Parameter:

[-provision]

Stellt die SharePoint-Webanwendung der Zentraladministration auf diesem Server bereit. Beim Bereitstellen wird eine neue SharePoint-Webanwendung der Zentraladministration und ein Anwendungspool unter dem Administratorkonto der Serverfarm erstellt.

[-unprovision]

Hebt die Bereitstellung der SharePoint-Webanwendung der Zentraladministration auf diesem Server auf. Beim Aufheben der Bereitstellung werden die SharePoint-Webanwendung der Zentraladministration und der zugehörige 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 gesendet, 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, falls kein Port angegeben ist.

[-windowsauthprovider <enablekerberos | onlyusentlm>]

Der Webanwendungs-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 gesendet, 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

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

psconfig.exe -cmd adminvs -unprovision

applicationcontent

Verwaltet freigegebene Anwendungsinhalte. Verwendet die folgenden erforderlichen Parameter:

-install

Kopiert freigegebene Anwendungsdaten (d. h. Ressourcendateien, Webanwendungsbinärdateien) in vorhandene virtuelle Verzeichnisse für Webanwendungen.

Beispiel

psconfig.exe -cmd applicationcontent -install

configdb

Stellt die Verbindung her oder trennt die Verbindung des Servers mit der Serverfarm. Verwendet die folgenden optionalen Parameter:

[-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 des Servers 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 Benutzername, der zur SQL-Authentifizierung verwendet wird.

[-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, der 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

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

Stellt diesen Server als eigenständigen Server (Evaluierungsmodus) bereit. Verwendet die folgenden erforderlichen und optionalen Parameter:

-provision

Führt die Bereitstellung im eigenständigen Modus auf diesem Server durch.

[-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 vorhandene Microsoft Windows SharePoint Services 3.0-Websites während der Installation überschrieben werden sollen. Wenn der Parameter nicht angegeben ist, wird die Website nicht gelöscht.

Beispiel

psconfig.exe -cmd evalprovision -provision -port 1100

helpcollections

Verwaltet Hilfeauflistungen. Verwendet die folgenden erforderlichen Parameter:

-installall

Installiert alle verfügbaren Hilfeauflistungen.

Beispiel

psconfig.exe -cmd helpcollections -installall

installfeatures

Registriert alle Features der SharePoint-Produkte und -Technologien im Dateisystem dieses Servers bei der Serverfarm.

Beispiel

psconfig.exe -cmd installfeatures

quiet

Führt den Konfigurations-Assistenten für SharePoint-Produkte und -Technologien im stillen Modus aus. Die Ausgabe wird in die Protokolldatei PSCONFIG.EXE_MM_DD_YY_HH_MM_SS_MS.log geschrieben, wobei _MM_DD_YY_HH_MM_SS_MS das vollständige Datum und die Uhrzeit der Ausführung des Dienstprogramms bezeichnet. Die Protokolldatei wird im Verzeichnis %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\12\LOGS gespeichert.

Beispiel

psconfig.exe -cmd quiet

secureresources

Führt die Durchsetzung der Ressourcensicherheit von SharePoint-Produkten und -Technologien auf dem Server durch. So wird die Sicherheit beispielsweise für Dateien, Ordner und Registrierungsschlüssel durchgesetzt.

Beispiel

psconfig.exe -cmd secureresources

services

Verwaltet Dienste von SharePoint-Produkten und -Technologien. Verwendet die folgenden optionalen Parameter:

[-install]

Registriert die Dienste in der Serverfarm, die sich auf diesem Server befinden.

[-provision]

Stellt die Dienste bereit, die sich auf diesem Server befinden, und legt die Dienste als online fest, wenn SharePoint-Produkte und -Technologien im eigenständigen Modus installiert sind. Durch die Bereitstellung der Dienste wird außerdem deren Registrierung sichergestellt.

Beispiel

psconfig.exe -cmd services -install

psconfig.exe -cmd services -provision

setup

Führt die Konfiguration für SharePoint-Produkte und-Technologien basierend auf dem Installationsmodus durch und repariert zudem die Konfiguration. Wird das Produkt oder die Technologie im eigenständigen Modus installiert, erfolgt die eigenständige Konfiguration. Wenn das Produkt oder die Technologie nicht im eigenständigen Modus installiert wird, müssen Sie die Erstkonfiguration mithilfe des Konfigurations-Assistenten für SharePoint-Produkte und -Technologien anstelle des Befehlszeilentools psconfig.exe durchführen. Um den Assistenten auszuführen, 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 anschließend psconfig.exe -setup aus. Für Serverfarminstallationen nach der Ausführung von setup /repairsollten Sie den Konfigurations-Assistenten für SharePoint-Produkte und -Technologien anstelle des Befehlszeilentools psconfig.exe verwenden.

Verwendet die folgenden optionalen Parameter:

[-lcid <1033>]

Die Gebietsschema-ID (LCID), die die Installationssprache angibt.

Beispiel

psconfig.exe -cmd setup

standaloneconfig

Führt eine eigenständige Konfiguration für SharePoint-Produkte und -Technologie durch. Verwendet die folgenden optionalen Parameter:

[-lcid <1033>]

Die Gebietsschema-ID (LCID), die die Installationssprache angibt.

Beispiel

psconfig.exe -cmd standaloneconfig

upgrade

Führt eine Aktualisierung der SharePoint-Produkte und -Technologien durch. Dieser Befehl wird automatisch beim Ausführen des Konfigurations-Assistenten für SharePoint-Produkte und-Technologien ausgeführt, wenn das Produkt oder die Technologie aktualisiert werden muss. Verwendet die folgenden optionalen Parameter:

[-wait]

Wird dieser Parameter angegeben, springt der Konfigurations-Assistent für SharePoint-Produkte und -Technologien erst zurück, wenn die Aktualisierung abgeschlossen ist. Wird er nicht angegeben, springt der Assistent zurück, nachdem ein Auftrag für den SharePoint-Timerdienst zum Ausführen der Aktualisierung gesendet wurde. Sie können den Auftragsstatus für die Aktualisierung anzeigen, indem Sie den Konfigurations-Assistenten für Microsoft SharePoint-Produkte und -Technologien über Ihren Webbrowser aufrufen.

[-force]

Wird dieser Parameter angegeben, werden alle zurzeit ausgeführten Aktualisierungsaktionen vom Konfigurations-Assistenten für SharePoint-Produkte und -Technologien beendet und die Aktualisierung neu gestartet.

[-reghostonupgrade]

Wird dieser Parameter angegeben, wird der gesamte Inhalt der Websitedefinitionsversion während der Aktualisierung vom Konfigurations-Assistenten für SharePoint-Produkte und -Technologien zurückgesetzt.

[-finalize]

Wird dieser Parameter angegeben, wird die aktuelle Aktualisierung vom Konfigurations-Assistenten für SharePoint-Produkte und -Technologien abgeschlossen. Führen Sie diese Aktion nur durch, wenn Sie alle Websites erfolgreich aktualisiert haben und eine Verbindung mit der vorherigen Version nicht mehr benötigt wird. Sie können diese Aktion nicht rückgängig machen.

[-inplace <v2v|b2b>]

Wird dieser Parameter angegeben, führt der Konfigurations-Assistent für SharePoint-Produkte und -Technologien eine direkte Aktualisierung aus. Wenn v2v angegeben wird, wird ein direktes Update von Version zu Version ausgeführt. Wenn b2b angegeben wird, wird ein direktes Update von Build zu Build ausgeführt.

[-sidebyside]

Wird dieser Parameter angegeben, führt der Konfigurations-Assistent für SharePoint-Produkte und -Technologien eine schrittweise Aktualisierung aus..

Beispiele

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

Herunterladen dieses Buches

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 Office SharePoint Server 2007.