Referenz zu "Config.xml" (SharePoint Foundation 2010)

 

Gilt für: SharePoint Foundation 2010

Letztes Änderungsdatum des Themas: 2015-03-09

Wenn Sie steuern möchten, wie Microsoft SharePoint Foundation 2010 installiert wird, verwenden Sie die Datei Config.xml zusammen mit dem Befehlszeilentool Setup. Die Datei Config.xml ermöglicht beispielsweise Folgendes:

• Ausführen einer automatischen Installation von SharePoint Foundation 2010

• Installieren von SharePoint Foundation 2010 mithilfe einer gemeinsamen Konfiguration auf mehreren Servern

• Ausführen einer automatischen Installation oder einer Skriptinstallation von SharePoint Foundation 2010

Inhalt dieses Artikels:

• Anpassen von "Config.xml"

• Kurzübersicht zu den Elementen in "Config.xml"

• Funktionsweise

• Dateiformat von "Config.xml"

• Elementreferenz zu "Config.xml"

Anpassen von "Config.xml"

Wenn Sie die Installation steuern möchten, bearbeiten Sie zunächst die Datei Config.xml in einem Text-Editor, um die benötigten Elemente mit den entsprechenden Einstellungen für diese Elemente einzuschließen. Führen Sie dann setup.exe /config [path and file name] aus, um anzugeben, dass Setup ausgeführt wird und die in der Datei Config.xml von Ihnen festgelegten Optionen verwendet.

Die Produkt-DVD enthält Beispiele für Config.xml. Diese Beispieldateien sind im Ordner Files im Stammverzeichnis der DVD gespeichert, und zwar in den betreffenden Ordnern für die verschiedenen Szenarien. Folgende Ordner sind vorhanden:

• Setup   Enthält eine Datei Config.xml zum Einrichten einer Neuinstallation. Nach der Ausführung von Setup müssen Sie das Befehlszeilentool Psconfig ausführen, um die Konfiguration des Servers oder der Serverfarm abzuschließen.

• SetupFarmSilent   Enthält eine Datei Config.xml zum Einrichten einer Serverfarm im unbeaufsichtigten Modus.

• SetupSilent   Enthält eine Datei Config.xml zum Einrichten einer Neuinstallation für einen einzelnen Server (eigenständig, mit Windows Windows Internal Database) im unbeaufsichtigten Modus.

• SetupUpgradeSilent   Enthält eine Datei Config.xml für das direkte Upgrade einer vorhandenen Serverfarm an Ort und Stelle.

Weitere Informationen zu den Unterschieden der verschiedenen Upgradeszenarien finden Sie unter Bestimmen der Upgrademethode (SharePoint Foundation 2010).

Kurzübersicht zu den Elementen in "Config.xml"

Die folgende Tabelle enthält eine Liste der Elemente in Config.xml. Diese Elemente können in beliebiger Reihenfolge verwendet werden. Eine Ausnahme ist das Configuration-Element-Element, das als erstes angegeben werden muss, sowie Elemente wie beispielsweise Command-Element, deren Reihenfolge in Config.xml die Verarbeitung der Elemente während der Installation beeinflusst.

Element	Beschreibung
Configuration-Element	Element der obersten Ebene.
ARP-Element	Werte, die für das Produkt den Text und das Verhalten der Option Software in der Systemsteuerung steuern.
Command-Element	Führt während der Installation einen Befehl aus.
Display-Element	Die Ebene der Benutzeroberfläche, die dem Benutzer angezeigt wird.
Logging-Element	Optionen für den von Setup ausgeführten Protokollierungstyp
DATADIR-Element	Der Speicherort für die Datendateien.
Package-Element	Das zu installierende Paket oder Produkt.
Setting-Element	Werte für Windows Installer-Eigenschaften.

Funktionsweise

Setup sucht im selben Ordner, in dem Setup.exe gespeichert ist, nach einem Exemplar von Config.xml. Wenn keine Datei gefunden wird, wird die Datei Config.xml verwendet, die im Ordner Files für das zu installierende Produkt gespeichert ist.

Sie können auch mit der Setup-Befehlszeilenoption /config den Speicherort der Datei Config.xml angeben. Beispiel:

\\<Server>\<Freigabe>\setup.exe /config \\<Server>\<Freigabe>\<Ordner>\config.xml

Dateiformat von "Config.xml"

XML-Elemente in Config.xml beginnen mit einer spitzen Klammer (<) und enden mit einem Schrägstrich />) und einer spitzen Klammer (/>).

Das grundlegende Elementformat lautet:

<Elementname [Attributname="Wert"] [Attributname="Wert"] … />

Beispiel:

<Display Level="none" CompletionNotice="no" />

Bei Elementen und Attributen wird die Groß- und Kleinschreibung berücksichtigt. Attributwerte müssen in Anführungszeichen (") eingeschlossen werden und werden nicht nach Groß- und Kleinschreibung unterschieden.

Eine Elementdefinition kann mehrere Zeilen umfassen. Leerzeichen, Wagenrücklaufzeichen, Zeilenvorschubzeichen und Tabulatoren werden innerhalb einer Elementdefinition ignoriert.

Beispiel:

<Display
   Level="none"
   CompletionNotice="no"
/>

Das Configuration-Element-Element ist ein Sonderfall und erforderlich. Alle anderen Elemente sind innerhalb des Configuration-Element-Elements enthalten, wobei dieses Element mit </Configuration> beendet wird.

Es folgt ein Beispiel einer Konfigurationsdatei für die Neuinstallation von Microsoft SharePoint Foundation 2010:

<Configuration>

   <Package Id="sts">

      <Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>

   </Package>

   <DATADIR Value="%CommonProgramFiles%\Microsoft Shared\Web Server Extensions\14\Data"/>

   <Logging Type="verbose" Path="%temp%" Template="Microsoft SharePoint Foundation 2010 Setup *.log"/>

   <Setting Id="UsingUIInstallMode" Value="1"/>

   <Setting Id="SETUP_REBOOT" Value="Never"/>

</Configuration>

Kommentare können überall hinzugefügt werden und werden durch eine spitze Klammer, ein Ausrufezeichen und zwei Bindestriche (<!--) und zwei Bindestriche und eine spitze Klammer (-->) getrennt.

Beispiel:

<!-- Install Microsoft SharePoint Server for clean install, using UI-->

<Configuration>

   <Package Id="sts">

      <Setting Id="LAUNCHEDFROMSETUPSTS" Value="Yes"/>

   </Package>

   <Package Id="spswfe">

      <Setting Id="SETUPCALLED" Value="1"/>

   </Package>

   <Logging Type="verbose" Path="%temp%" Template="SharePoint Server Setup(*).log"/>

      <!--<PIDKEY Value="Enter Product Key Here" />-->

      <Setting Id="SERVERROLE" Value="SINGLESERVER"/>

      <Setting Id="USINGUIINSTALLMODE" Value="1"/>

      <Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>

      <Setting Id="SETUP_REBOOT" Value="Never"/>

   <!-- Tells Setup.exe not to reboot -->

</Configuration>

Elementreferenz zu "Config.xml"

Die folgenden typografischen Vereinbarungen werden in den Beschreibungen dieser Referenz verwendet:

Fett	Element- oder Attributname
Normal	Genau wie angezeigt einzugebender Text
Kursiv	Platzhalter für einen hinzuzufügenden Wert
x|y	Auswahl zwischen mehreren Werten
[x]	Optionaler Wert

Configuration-Element

Element der obersten Ebene. Dieses Element ist erforderlich, und alle anderen Elemente müssen in diesem Element enthalten sein.

Syntax

<Configuration>

<Package Id="ID">

...

</Package>

...

</Configuration>

Attribute

Attribut	Wert	Beschreibung
Package ID	Paket-ID	Das zu installierende Paket

Hinweise

Mit dem Package Id-Attribut werden das Produkt und die Technologien identifiziert, die von der Datei Config.xml betroffen sind.

Beispiel

Die Paket-ID für SharePoint Foundation 2010 lautet sts. Verwenden Sie die Paket-ID sts in Config.xml, um SharePoint Foundation 2010 anzugeben, indem Sie Folgendes eingeben:

<Configuration>
   <Package Id="sts">
   ...
   </Package>
   ...
</Configuration>

ARP-Element

Gibt Werte an, die für das Produkt den Text und das Verhalten der Option Software in der Systemsteuerung steuern.

Syntax

<ARP Attribut =" Wert " [Attribut**="Wert"**] ... />

Attribute

Attribut	Wert	Beschreibung
ARPCOMMENTS	Text	Zusätzlicher Text mit bis zu 255 Zeichen. Möglicherweise werden jedoch nicht alle Zeichen angezeigt.
ARPCONTACT	Text	Liste der Kontaktpersonen für den technischen Support.
ARPNOMODIFY	Yes	Hindert die Benutzer am Ändern der Produktinstallation, indem die Schaltfläche Ändern nicht verfügbar ist.
	No (Standard)	Ermöglicht Benutzern das Ändern der Produktinstallation.
ARPNOREMOVE	Yes	Hindert die Benutzer am Entfernen des Produkts, indem die Schaltfläche Entfernen nicht verfügbar ist.
	No (Standard)	Erlaubt den Benutzern das Entfernen des Produkts.
ARPURLINFOABOUT	URL	URL für die Homepage des Produkts.
ARPURLUPDATEINFO	URL	URL für Informationen zu Produktupdates.
ARPHELPLINK	URL	URL einer Website, auf der Benutzer technischen Support erhalten.
ARPHELPTELEPHONE	Text	Telefonnummern für den technischen Support.

Command-Element

Gibt eine auszuführende Befehlszeile an. Die Befehle im Command -Element werden nur während der Erstinstallation und während der Deinstallation verarbeitet. Wenn Befehle im Command -Element für Anpassungen nach der Erstinstallation verwendet werden, werden sie ignoriert.

Syntax

<Command

Path=" Pfad "

[QuietArg="Argumente"]

[Args="Argumente"]

   [ChainPosition="Before" | "After"(Standard)]

[Wait="Millisekunden"]

   [Execute="Install"(Standard) | "Uninstall"]

   [Platform="x86"(Standard) | "x64"]

/>

Attribute

Sie können doppelte Anführungszeichen (") für die Attribute Path und Args angeben, indem Sie zwei doppelte Anführungszeichen verwenden ("").

Attribut	Wert	Beschreibung
Path	Pfad	Der vollqualifizierte Pfad des ausführbaren Windows Installer-Pakets.
QuietArg	Zeichenfolge	Eine Argumentzeichenfolge, die an die Befehlszeile angefügt wird, wenn Display-ElementLevel=None
Args	Zeichenfolge	Argumentzeichenfolge, die der ausführbaren Datei übergeben werden soll.
ChainPosition	Before	Dieser Befehl wird vor der primären Produktinstallation ausgeführt.
	After (Standard)	Dieser Befehl wird nach der primären Produktinstallation ausgeführt.
Wait	Millisekunden	Wenn bei der Installation Display-ElementLevel auf Full oder Basic festgelegt wird, wird hiermit angegeben, wie viele Millisekunden nach der Ausführung des Programms gewartet wird, bevor Sie die Installation fortsetzen. Der Standardwert ist 0 (null), womit überhaupt nicht gewartet wird.
Execute	Install (Standard)	Dieser Befehl wird bei der Installation des primären Produkts installiert.
	Uninstall	Dieser Befehl wird bei der Installation des primären Produkts deinstalliert.
Platform	x86 (Standard)	Gibt an, dass für dieses Programm die Intel x86-Plattform erforderlich ist. Dieser Befehl wird nur ausgeführt, wenn der Computer, auf dem die Installation ausgeführt wird, diese Plattformanforderung erfüllt.
	x64	Gibt an, dass für dieses Programm ein 64-Bit-Prozessor erforderlich ist, der die x64-Erweiterungen zur x86-Architektur unterstützt. Dieser Befehl wird nur ausgeführt, wenn der Computer, auf dem die Installation ausgeführt wird, diese Plattformanforderung erfüllt.

Hinweise

Das Command-Element in der Datei Config.xml ist nur für die erste Produktinstallation und für Deinstallationen vorgesehen. Die Befehle im Command-Element werden nur während der Erstinstallation und während der Deinstallation verarbeitet. Wenn Befehle im Command-Element für Anpassungen nach der Erstinstallation verwendet werden, werden die Befehle ignoriert.

Die Befehlszeile kann angegeben werden, um einen beliebigen Befehl ausführen oder eine kompakte ausführbare Datei auszuführen, die bei der Installation des Produkts ausgeführt werden soll.

Das Command-Element in Config.xml bietet nicht die gleichen Möglichkeiten bei der Softwarebereitstellung wie ein Tool für die Softwarebereitstellung und -verwaltung in Unternehmen. Dazu gehört beispielsweise die Möglichkeit, den Bereitstellungsfortschritt nachzuverfolgen und eine Problembehandlung auszuführen. Daher wird empfohlen, das Command-Element in Config.xml nur zum Ausführen kompakter ausführbarer Dateien oder für beliebige Befehle zu verwenden, durch die keine Änderungen am Computer vorgenommen werden oder die keine Benutzereingabe erfordern. Sie können beispielsweise ein Hilfsprogramm zum Kopieren von Protokollen ausführen oder einen Befehl zum Starten einer Willkommensseite am Ende der Installation.

Die Befehlszeile kann für eine verkettete Installation oder eine ausführbare Datei angegeben werden, die bei der Installation dieses Produkts ausgeführt wird. Wenn dies angegeben ist, müssen Sie für Setup eine Befehlszeile anstelle einer einzigen MSI-Datei angeben.

Wenn mindestens zwei Command-Elemente in der Datei Config.xml vorhanden sind, werden sie in der in Config.xml angegebenen Reihenfolge ausgeführt.

Die Attribute Args und QuietArg werden wie folgt verwendet:

• Das Args-Attribut wird immer an den Befehl angefügt. Dazu können Schalter wie z. B. /install oder **Company=**MeinUnternehmen gehören.

• Das QuietArg-Attribut wird auch angefügt, wenn Setup unbeaufsichtigt ausgeführt wird (wenn Display auf Display="none" festgelegt ist). In diesen Fällen können Sie das QuietArg-Attribut mit dem Schalter "/quiet" angeben, beispielsweise QuietArg="/quiet".

• Wenn der Wert des Args-Elements Anführungszeichen enthält, können Sie den gesamten Wert wie im folgenden Beispiel gezeigt in einzelne Anführungszeichen (') einschließen: Args='"/param value"'

Die folgenden Aussagen treffen auf das Wait-Attribut zu:

• Wenn Sie das Wait-Attribut auf 0 Millisekunden festlegen, wird nach dem Ausführen des Programms nicht gewartet, bevor die Installation fortgesetzt wird. Der Befehl wird ausgeführt und die Installation sofort fortgesetzt.

  Rückgabecodes werden nur beachtet, wenn der Wert von Wait ungleich 0 ist. Wenn Sie 0 angeben, wird mit dem Fortsetzen der Installation nach dem Ausführen des angegebenen Programms nicht gewartet. Daher ist in diesem Fall kein Rückgabecode vorhanden.

• Wenn Sie das Wait-Attribut auf einen positiven Wert ungleich 0 festlegen, entspricht die Wartezeit der Anzahl der angegebenen Millisekunden. Wenn der Prozess früher als zum angegebenen Zeitpunkt beendet ist, wird Setup fortgesetzt. Wenn der Prozess nach Ablauf der angegebenen Zeit nicht beendet ist, tritt beim Setup ein Fehler auf.

• Wenn Sie das Wait-Attribut auf -1 festlegen, wird unbegrenzt gewartet. Dies kann problematisch sein, da Setup nicht mehr reagiert, falls der Befehlsprozess nicht mehr reagiert (hängt). In diesem Fall wird unbegrenzt auf die Ausführung des Befehls gewartet.

Beispiel

<Command Path="\\server\share\myscript.exe" Args='/id "123 abc"' QuietArg="/q" Wait="3000">

<Command Path="\\<server>\<share>\setup.exe /config \\<server>\<share>\<folder>\config.xml"

DATADIR-Element

Der Speicherort für die Datendateien, einschließlich der Suchindexdateien.

Syntax

<DATADIR Value=" Pfad "/>

Attribute

Attribut	Wert	Beschreibung
Value	Pfad	Die Datendaten werden im angegebenen Pfad gespeichert.

Hinweise

Sie können im Pfad Systemumgebungsvariablen verwenden. Wenn dieses Element nicht angegeben ist, werden die Daten im folgenden Pfad gespeichert:

%ProgramFiles%\Microsoft SQL Server\MSSQL$SHAREPOINT\Data

Beispiel

<DATADIR Value="d:\data"/>

Display-Element

Die Ebene der Benutzeroberfläche, die dem Benutzer angezeigt wird.

Syntax

<Display

Level="None" | "Basic" | "Full"(Standard)

CompletionNotice="Yes"(Standard) | "No"

SuppressModal="Yes" | "No"(Standard)

NoCancel="Yes" | "No"(Standard)

AcceptEula="Yes" | "No"(Standard)

/>

Attribute

Attribut	Wert	Beschreibung
Level	None	Es wird keine Setupbenutzeroberfläche angezeigt.
	Basic	Die Willkommensseite, die Seite Microsoft-Software-Lizenzbedingungen (falls erforderlich), eine Statusanzeige und der Abschlusshinweis (sofern zulässig) werden angezeigt.
	Full (Standard)	Dem Benutzer wird die komplette Benutzeroberfläche angezeigt.
CompletionNotice	Yes	Trifft nur zu, wenn Level auf Basic oder None festgelegt ist. In diesem Fall wird der Abschlusshinweis angezeigt.
	No (Standard)	Trifft nur zu, wenn Level auf Basic festgelegt ist. In diesem Fall wird der Abschlusshinweis nicht angezeigt.
SuppressModal	Yes	Trifft nur zu, wenn Level auf Basic festgelegt ist. In diesem Fall werden keine Fehlermeldungen und anderen Dialogfelder angezeigt, die die Installation unterbrechen könnten.
	No (Standard)	Trifft nur zu, wenn Level auf Basic festgelegt ist. In diesem Fall werden bei Bedarf Fehlermeldungen und andere Dialogfelder angezeigt.
NoCancel	Yes	Wenn Level auf Full oder Basic festgelegt ist, wird die Schaltfläche zum Abbrechen (X in der rechten oberen Ecke des Statusdialogfelds) angezeigt.
	No (Standard)	Wenn Level auf Full oder Basic festgelegt ist, kann der Benutzer die Installation über die Statusanzeige abbrechen.
AcceptEULA	Yes	Die Microsoft-Software-Lizenzbedingungen werden im Namen des Benutzers akzeptiert. Die Seite Microsoft-Software-Lizenzbedingungen wird nicht angezeigt.
	No (Standard)	Wenn Level nicht auf None festgelegt ist, wird die Seite Microsoft-Software-Lizenzbedingungen angezeigt.

Hinweise

Wenn dieses Element nicht definiert ist, werden die Standardeinstellungen verwendet. Wenn ein ungültiger Wert angegeben wird, wird die Installation beendet.

Beispiel

<Display Level="basic"
   CompletionNotice="yes"
   SupressModal="no"
   AcceptEula="yes"
/>

Logging-Element

Gibt den von Setup ausgeführten Protokollierungstyp an.

Syntax

<Logging

Type="Off" | "Standard"(Standard) | "Verbose"

Path=" Pfad "

Template=" Dateiname .txt"

/>

Attribute

Attribut	Wert	Beschreibung
Type	Off	Es wird keine Protokollierung vorgenommen.
	Standard (Standard)	Installationsinformationen werden in die Protokolldatei geschrieben.
	Verbose	Alle Installationsinformationen werden in die Protokolldatei geschrieben.
Path	Pfad	Der vollqualifizierte Pfad des für die Protokolldatei verwendeten Ordners. Sie können Umgebungsvariablen verwenden. Der Standardwert ist %temp%.
Template	Dateiname .txt	Der Name der Protokolldatei. Wenn Sie die Zeichenfolge * an einer beliebigen Stelle des Dateinamens einfügen, wird eine eindeutige Protokolldatei für jede von Setup ausgeführte Installation erstellt (siehe die Erklärung weiter unten). Wenn * nicht verwendet wird und der angegebene Dateiname bereits vorhanden ist, werden Protokollinformationen an die vorhandene Datei angefügt. Die Dateierweiterung TXT muss angegeben werden. Die Standardvorlage ist SetupExe(*).log.

Hinweise

Sie können * überall für Template angeben. Eine Zeichenfolge wird an dieser Stelle mit folgendem Format eingefügt:

JJJJMMTTHHMMSSxxx

Dabei gilt Folgendes:

1. JJJJ = Jahr

2. MM = Monat

3. TT = Tag

4. HH = Stunde

5. MM = Minuten

6. SS = Sekunden

7. xxx = eine von Setup generierte eindeutige Zeichenfolge

Beispiel

<Logging Type="standard" Path="%temp%"
   Template="MyLog(*).txt"
/>

In diesem Beispiel wird bei jeder Installation des Produkts eine Protokolldatei erstellt. Setup verwendet eindeutige Dateinamen, wie beispielsweise:

%temp%\MyLog(20060428110717CFC).txt
%temp%\MyLog(20060429113143C70).txt

Package-Element

Das zu installierende Paket oder Produkt.

Die Paket-ID für SharePoint Foundation 2010 lautet sts.

Setting-Element

Hiermit können Sie Werte für Windows Installer-Eigenschaften angeben.

Syntax

<Setting Id=" Name " Value=" Wert " />

Attribute

Attribut	Wert	Beschreibung
Id	Name	Der Name der Windows Installer-Eigenschaft.
Value	Wert	Der Wert, der der Eigenschaft zugewiesen werden soll.

Werte

Die folgenden Einstellungs-IDs werden für Serverinstallationen verwendet:

ID	Akzeptierte Werte	Beschreibung
REBOOT	ReallySuppress	Gibt (für Windows Installer) an, ob nach Abschluss von Setup ein Neustart zulässig ist. Verwenden Sie ReallySuppress, um keinen Neustart festzulegen. Diese Option muss auf globaler Ebene, nicht pro Paket angegeben werden.
SETUP_REBOOT	Never, AutoAlways, Always, AutoIfNeeded, IfNeeded	Gibt (für Setup) an, ob nach Abschluss von Setup ein Neustart zulässig ist. Verwenden Sie Never, um keinen Neustart festzulegen. Diese Option muss auf globaler Ebene, nicht pro Paket angegeben werden.
SETUPTYPE	CLEAN_INSTALL, V2V_INPLACE_UPGRADE	Gibt an, ob eine neue Kopie des Produkts oder der Technologie (CLEAN_INSTALL) installiert oder ob die neue Version installiert und die vorherige Version direkt aktualisiert werden soll (V2V_INPLACE_UPGRADE). Diese Option muss auf globaler Ebene, nicht pro Paket angegeben werden.
SETUPCALLED	0 | 1	Verwenden Sie dies als Teil des Package Id-Attributs.
SERVERROLE	SINGLESERVER, APPLICATION	Gibt den Servertyp an, auf dem installiert wird: eigenständig (SINGLESERVER) oder Anwendung (APPLICATION).
USINGUIINSTALLMODE	0 | 1	Gibt an, ob Sie eine unbeaufsichtigte Installation (0) durchführen oder die Benutzeroberfläche für die Installation (1) verwenden.

Hinweise

Nicht alle Windows Installer-Eigenschaften können für das Setting-Element angegeben werden. Bei Angabe einer blockierten Eigenschaft wird der Installationsvorgang beendet. Wenn eine unterstützte Eigenschaft angegeben wird, wird die Eigenschaft direkt an Windows Installer übergeben.

Beispiel

<Setting Id="REBOOT" Value="ReallySuppress" />