"Psconfig"-Befehlszeilenreferenz (SharePoint Server 2010)

  • Artikel

 

Gilt für: SharePoint Foundation 2010, SharePoint Server 2010

Letztes Änderungsdatum des Themas: 2015-03-09

In SharePoint 2010-Produkte können Sie das Befehlszeilentool Psconfig als alternative Schnittstelle verwenden, um mehrere Operationen auszuführen, die steuern, wie SharePoint 2010-Produkte konfiguriert werden. Um diese Vorgänge ausführen zu können, müssen Sie auf dem lokalen Computer Mitglied der Gruppe Administratoren sein.

Inhalt dieses Artikels:

  • So verwenden Sie "Psconfig"-Befehle

  • Verfügbare Befehle und Parameter

So verwenden Sie "Psconfig"-Befehle

Wenn Sie Psconfig an einer Eingabeaufforderung eingeben, können Sie Befehle festlegen, mit denen gesteuert wird, wie das Tool ausgeführt wird. Um Psconfig an einer Eingabeaufforderung auszuführen, navigieren Sie zum Ordner %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\bin, und geben Sie den Befehl mit der folgenden Syntax ein:

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

Die Referenztabelle im nächsten Abschnitt enthält mehrere Beispiele. Über die Befehlszeilenschnittstelle ist auch eine Hilfe verfügbar. Um die Hilfe aufzurufen, geben Sie an der Eingabeaufforderung Folgendes ein:

psconfig.exe -?

Um die Hilfe für einen bestimmten Befehl anzuzeigen, geben Sie Folgendes ein:

psconfig.exe -help <command name>

Die Befehle in Psconfig müssen in einer bestimmten Reihenfolge ausgeführt werden, um erfolgreich zu sein. Wenn Sie den Konfigurations-Assistent für SharePoint-Produkte für die Konfiguration einer Installation verwenden, ruft dieser die Befehle (auch als Konfigurationsaufgaben bezeichnet) in der richtigen Reihenfolge für Sie auf. Wenn Sie jedoch die Befehlszeile verwenden, um Psconfig auszuführen, müssen Sie sicherstellen, die Aufgaben in der richtigen Reihenfolge auszuführen. Die Psconfig-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 feststellt, dass die Serverfarm aktualisiert werden muss, führt es bei seiner Ausführung automatisch eine Aktualisierung aus (selbst wenn Sie den Befehl upgrade nicht ausgeführt haben).

Sie können festlegen, dass alle Befehle in einer einzigen Befehlszeilen-Zeichenfolge ausgeführt werden. In diesem Fall führt Psconfig alle Befehle in der richtigen Reihenfolge aus. Geben Sie an der Eingabeaufforderung beispielsweise einen Befehl wie den folgenden ein:

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 dazu, wie Sie einen Server oder eine Serverfarm über die Befehlszeile konfigurieren, finden Sie im Microsoft SharePoint Server 2010 TechCenter.

Verfügbare Befehle und Parameter

Im Konfigurations-Assistent für SharePoint-Produkte werden die folgenden Befehlszeilenoptionen akzeptiert.

Befehl Beschreibung, Parameter und Beispiele

?

Zeigt die zur Verwendung mit Psconfig verfügbaren Befehle an.

Beispiel

psconfig.exe -?

help <command name>

Zeigt die zur Verwendung mit Psconfig verfügbaren Befehle an. Wenn ein Befehlsname angegeben wird, wird die Hilfe für diesen Befehl angezeigt.

Beispiel

psconfig.exe -help adminvs

adminvs

Verwaltet die SharePoint-Zentraladministrations-Webanwendung auf dem lokalen Computer. Akzeptiert die folgenden optionalen Parameter:

[-provision]

Stellt die SharePoint-Zentraladministrations-Webanwendung auf diesem Server bereit. Durch die Bereitstellung wird eine neue SharePoint-Zentraladministrations-Webanwendung und ein Anwendungspool erstellt, der unter dem Konto des Administrators der Serverfarm ausgeführt wird.

[-unprovision]

Hebt die Bereitstellung der SharePoint-Zentraladministrations-Webanwendung auf diesem Server auf. Durch die Aufhebung der Bereitstellung wird die SharePoint-Zentraladministrations-Webanwendung und ihr Anwendungspool entfernt.

[-port <port number>]

Der Port der SharePoint-Zentraladministrations-Webanwendung ist eine globale Einstellung für die Serverfarm. Wenn der Port geändert wird, wird ein SharePoint-Zeitgeberauftrag ausgegeben, um den Port für alle SharePoint-Zentraladministrations-Webanwendungen in der Serverfarm zu synchronisieren. Wenn kein Port angegeben wird, wird der für bestehende SharePoint-Zentraladministrations-Webanwendungen in der Serverfarm verwendete Port verwendet. Wenn in der Serverfarm keine SharePoint-Zentraladministrations-Webanwendung bereitgestellt wurde, wird der ausgewählte Standardport zufällig verwendet, wenn kein Port festgelegt wurde.

[-windowsauthprovider <enablekerberos | onlyusentlm>]

Der Authentifizierungsanbieter der SharePoint-Zentraladministrations-Webanwendung ist eine globale Einstellung für die Serverfarm. Wenn der Authentifizierungsanbieter geändert wird, wird ein SharePoint-Zeitgeberauftrag ausgegeben, um den Anbieter für alle SharePoint-Zentraladministrations-Webanwendungen in der Serverfarm zu synchronisieren. Wenn onlyusentlm festgelegt wird, ist NTLM der alleinige Authentifizierungsanbieter für alle SharePoint-Zentraladministrations-Webanwendungen. Alle anderen Authentifizierungsanbieter werden deaktiviert, und NTLM ist der einzige zulässige Authentifizierungsanbieter. Wenn enablekerberos festgelegt wird, wird die Kerberos-Authentifizierung für alle SharePoint-Zentraladministrations-Webanwendungen aktiviert. Wenn kein Authentifizierungsanbieter angegeben wird, wird der für bestehenden SharePoint-Zentraladministrations-Webanwendungen in der Serverfarm verwendete Anbieter verwendet. Wenn in der Serverfarm keine SharePoint-Zentraladministrations-Webanwendung bereitgestellt wurde, wird der Kerberos-Authentifizierungsanbieter aktiviert, wenn kein Authentifizierungsanbieter festgelegt wurde.

Beispiele

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

psconfig.exe -cmd adminvs -unprovision

applicationcontent

Verwaltet freigegebene Anwendungsinhalte. Akzeptiert die folgenden erforderlichen Parameter:

-install

Kopiert freigegebene Anwendungsdaten (beispielsweise Ressourcendateien und Webanwendungs-Binärdateien) in virtuelle Verzeichnisse vorhandener Webanwendungen.

Beispiel

psconfig.exe -cmd applicationcontent -install

configdb

Erstellt diesen Server und verbindet ihn mit der Serverfarm oder trennt ihn von dieser. Akzeptiert die folgenden optionalen Parameter:

[-create]

Erstellt eine neue Konfigurationsdatenbank und richtet daher eine neue Serverfarm ein. Wenn dieser Server bereits mit einer Konfigurationsdatenbank verbunden ist, wird der Server zunächst getrennt, und anschließend wird die neue Konfigurationsdatenbank erstellt.

[-disconnect]

Trennt diesen Server von der Konfigurationsdatenbank und trennt diesen Server daher von der Serverfarm.

[-connect]

Stellt eine Verbindung zu einer vorhandenen Konfigurationsdatenbank her, und ordnet diesen Server daher einer vorhandenen Serverfarm zu. Wenn dieser Server bereits mit einer Konfigurationsdatenbank verbunden ist, wird der Server zunächst getrennt und anschließend mit der vorhandenen Konfigurationsdatenbank verbunden.

[-server <SQLServerName>]

Der Computer, auf dem Microsoft SQL Server ausgeführt wird, 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 Administratorbenutzerkonto der Serverfarm

[-password <Password>]

Das Kennwort des Administratorbenutzerkontos der Serverfarm

[-addomain <value>]

Der für die Serverfarm verwendete Active Directory-Domänenname

[-adorgunit <value>]

Der für die Serverfarm verwendete Active Directory-Organisationseinheitsname

[-admincontentdatabase <SQLAdminContentDatabaseName>]

Der Inhaltsdatenbankname der Zentraladministrations-Webanwendung

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 (Testmodus) bereit. Akzeptiert die folgenden erforderlichen und optionalen Parameter:

-provision

Führt eine Bereitstellung im eigenständigen Modus auf diesem Server aus.

[-port <port number>]

Die der Standard-SharePoint-Webanwendung zugeordnete Portnummer. Wenn diese nicht angegeben wird, wird Port 80 verwendet. Wenn bereits eine SharePoint-Webanwendung vorhanden ist und diesen Port verwendet, wird die bestehende Website überschrieben. Wenn eine bestehende Website diesen Port verwendet, die keine SharePoint-Webanwendung ist, wird die Website deaktiviert, und eine neue SharePoint-Webanwendung wird erstellt, die diesen Port verwendet.

[-overwrite]

Legt fest, ob eine vorhandene Microsoft SharePoint Server 2010-Website während der Installation überschrieben werden soll. Wenn der Parameter nicht angegeben wird, wird die Website nicht gelöscht.

Beispiel

psconfig.exe -cmd evalprovision -provision -port 1100

helpcollections

Verwaltet Hilfesammlungen. Akzeptiert die folgenden erforderlichen Parameter:

-installall

Installiert alle verfügbaren Hilfesammlungen.

Beispiel

psconfig.exe -cmd helpcollections -installall

installfeatures

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

Beispiel

psconfig.exe -cmd installfeatures

quiet

Führt den Konfigurations-Assistent für SharePoint-Produkte im stillen Modus aus. Die Ausgabe wird in die Protokolldatei mit dem Namen 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 Uhrzeit, zu dem bzw. der das Dienstprogramm ausgeführt wurde. Das Protokoll wird im Verzeichnis %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\LOGS gespeichert.

Beispiel

psconfig.exe -cmd quiet

secureresources

Setzt die Sicherheit für SharePoint 2010-Produkte-Ressourcen auf dem Server durch. Die Sicherheit wird beispielsweise für Dateien, Ordner und Registrierungsschlüssel durchgesetzt.

Beispiel

psconfig.exe -cmd secureresources

services

Verwaltet SharePoint 2010-Produkte-Dienste. Akzeptiert die folgenden optionalen Parameter:

[-install]

Registriert die auf diesem Server vorhandenen Dienste in der Serverfarm.

[-provision]

Stellt die auf diesem Server vorhandenen Dienste bereit, und legt die Dienste als online fest, wenn SharePoint 2010-Produkte im eigenständigen Modus installiert wurden. Die Bereitstellung von Diensten stellt auch sicher, dass diese registriert werden.

Hinweis

Der [-provision]-Parameter wird nur für einen einzelnen Server als eigenständige Installation unterstützt. Verwenden Sie diesen Parameter nicht für eine Farminstallation.

Beispiel

psconfig.exe -cmd services -install

psconfig.exe -cmd services -provision

setup

Führt die Konfiguration für SharePoint 2010-Produkte auf der Grundlage des Installationsmodus aus. Repariert darüber hinaus die Konfiguration. Wenn das Produkt im eigenständigen Modus installiert wird, ist die eigenständige Konfiguration vollständig. Wenn sich das Produkt nicht im eigenständigen Modus befindet, müssen Sie die Erstkonfiguration unter Verwendung des Konfigurations-Assistent für SharePoint-Produkte anstatt des Befehlszeilentool Psconfig vornehmen. Um den Assistenten zu starten, zeigen Sie im Startmenü auf Alle Programme, zeigen Sie auf Verwaltung, und klicken Sie dann auf Konfigurations-Assistent für SharePoint-Produkte.

Wenn Sie eine eigenständige Installation reparieren möchten, führen Sie zunächst setup /repair aus (weitere Informationen finden Sie im Hilfesystem für Setup) und anschließend psconfig.exe -setup. Verwenden Sie für Serverfarminstallationen nach der Ausführung von setup /repairKonfigurations-Assistent für SharePoint-Produkte anstatt das Befehlszeilentool Psconfig.

Akzeptiert den folgenden optionalen Parameter:

[-lcid <1033>]

Der Gebietsschemabezeichner (LCID), der die Installationssprache festlegt

Beispiel

psconfig.exe -cmd setup

standaloneconfig

Führt eine eigenständige Konfiguration für SharePoint-Produkte und -Technologien aus. Akzeptiert die folgenden optionalen Parameter:

[-lcid <1033>]

Der Gebietsschemabezeichner (LCID), der die Installationssprache festlegt

Beispiel

psconfig.exe -cmd standaloneconfig

upgrade

Führt ein Upgrade von SharePoint 2010-Produkte aus. Dieser Befehl wird automatisch ausgeführt, wenn Sie den Konfigurations-Assistent für SharePoint-Produkte ausführen, wenn das Produkt aktualisiert werden muss. Akzeptiert die folgenden optionalen Parameter:

[-wait]

Wenn dieser Parameter angegeben wird, wird der Konfigurations-Assistent für SharePoint-Produkte nicht wieder aufgerufen, bis das Upgrade abgeschlossen ist. Wenn der Parameter nicht festgelegt wird, wird der Assistent wieder aufgerufen, nachdem er einen SharePoint-Timer Service-Auftrag für die Ausführung des Upgrades ausgegeben hat. Um den Status des Upgradeauftrags anzuzeigen, können Sie über Ihren Webbrowser die SharePoint-Zentraladministrations-Website aufrufen.

[-force]

Wenn der Parameter angegeben wird, stoppt der Konfigurations-Assistent für SharePoint-Produkte alle zurzeit ausgeführten Upgradeaktionen und startet das Upgrade neu.

[-reghostonupgrade]

Wenn der Parameter angegeben wird, setzt der Konfigurations-Assistent für SharePoint-Produkte während des Upgrades alle Inhalte auf die Version der Websitedefinition zurück.

[-inplace <v2v|b2b>]

Wenn der Parameter angegeben wird, führt der Konfigurations-Assistent für SharePoint-Produkte ein direktes Upgrade aus. Wenn v2v festgelegt wird, wird ein direktes Version-zu-Version-Upgrade ausgeführt. Wenn b2b festgelegt wird, wird ein direktes Build-zu-Build-Upgrade ausgeführt.

[-preserveolduserexperience]

Wenn der Parameter auf "false" festgelegt wird, aktualisiert der Konfigurations-Assistent für SharePoint-Produkte Websites für die Verwendung der letzen SharePoint-Benutzeroberfläche. Wenn Sie diesen Parameter nicht festlegen, ist die Standardeinstellung "true".

[-passphrase]

Für die Mitgliedschaft in der Serverfarm verwendete Passphrase. Der Passphrasenwert muss auf allen Servern in der Farm der gleiche sein, damit die Farm ordnungsgemäß funktioniert.

Beispiel

psconfig.exe -cmd upgrade -inplace v2v -wait