.png)
.png)
Datei "Configuration.xml" für Klick-und-Los für Office 365
Zusammenfassung: Enthält Informationen zur Datei "Configuration.xml" für Klick-und-Los für Office 365-Produkte.
Betrifft:
Zielgruppe: IT-Spezialisten
Die Klick-und-Los für Office 365-Datei "Configuration.xml" dient zum Angeben von Installations- und Updateinformationen für Klick-und-Los. Das Office-Bereitstellungstool ist ein herunterladbares Tool und enthält eine Beispieldatei vom Typ "Configuration.xml". Administratoren können die Datei "Configuration.xml" ändern und so Installationsoptionen für Klick-und-Los für Office 365-Produkte konfigurieren.
Die Datei "Configuration.xml" für Klick-und-Los ist eine erforderliche Komponente des Office-Bereitstellungstools. Klick-und-Los-Anpassungen werden hauptsächlich durch Starten des Office-Bereitstellungstools und Angeben einer benutzerdefinierten Datei vom Typ "Configuration.xml" vorgenommen. Vom Office-Bereitstellungstool werden die Aufgaben ausgeführt, die mithilfe der optionalen Eigenschaften in der Konfigurationsdatei angegeben wurden. Für die Office 2013-Version des Produkts können Administratoren das Office-Bereitstellungstool über das Microsoft Download Center herunterladen.
Die Datei "Configuration.xml" für Klick-und-Los wird für folgende Aufgaben verwendet:
-
Hinzufügen oder Entfernen von Produkten für die Installation
-
Hinzufügen oder Entfernen von Sprachen für die Installation
-
Angeben von Anzeigeoptionen
-
Festlegen von Protokollierungsoptionen
-
Angeben des Softwareaktualisierungsverhaltens für Klick-und-Los
 Wichtig: |
|---|
| Das Office-Bereitstellungstool für Klick-und-Los unterstützt derzeit nur Office Customer Preview-Quellen. Eine spätere Version des Office-Bereitstellungstools wird auch die endgültigen Versionen der neuen Office-Produkte unterstützen. |
Inhalt dieses Artikels:
 Hinweis: |
|---|
| Sie können das Installationsverzeichnis für Klick-und-Los für Office 365-Produkte nicht anpassen. Klick-und-Los kann nur auf dem Systemlaufwerk (in der Regel Laufwerk C) bereitgestellt werden. Klick-und-Los ist auf Anwendungsebene nicht anpassbar. Einige Optionen sind jedoch verfügbar:
|
Neueste Informationen zu bekannten Problemen für Klick-und-Los finden Sie auf der Website "office.com" in den bekannten Problemen für Office.
Kurzübersicht für die Klick-und-Los-Datei "Configuration.xml"
Die folgende Tabelle enthält eine Liste der Elemente in der Klick-und-Los-Datei "Configuration.xml":
Referenz für "Configuration.xml"
| Element | Beschreibung |
|---|---|
| Element der obersten Ebene. | |
| Dient zum Angeben der zu installierenden Produkte und Sprachen. | |
| Die Ebene der Benutzeroberfläche, die dem Benutzer angezeigt wird. | |
| Ein untergeordnetes Element desProduct-Elements. Fügt der Installation eine Sprache hinzu. | |
| Optionen zum Angeben des auszuführenden Protokollierungstyps. | |
| Ein untergeordnetes Element desAdd- oderRemove-Elements. Dient zum Angeben des zu installierenden Produkts. | |
| Dient zum Angeben der zu entfernenden Produkte und Sprachen. | |
| Dient zum Angeben, wie Updates von Office gesucht und abgerufen werden sollen. |
Format der Klick-und-Los-Datei "Configuration.xml"
XML-Elemente in der Klick-und-Los-Datei "Configuration.xml" beginnen mit < und enden mit />.
Grundlegende Elementformat:
< Element [Attribut="Wert"] [Attribut="Wert"] … />
Im folgenden Beispiel wird während der Installation des Produkts keine Benutzeroberfläche angezeigt, und die Lizenzbedingungen werden im Namen des Benutzers akzeptiert:
<Display Level="None" AcceptEULA="TRUE" />
Referenz für die Klick-und-Los-Datei "Configuration.xml"
Die folgende Tabelle enthält die in dieser Referenz verwendeten Konventionen:
Formatierungskonventionen
| Format | Beschreibung |
|---|---|
| Fett | Element- oder Attributname |
| Normal | Geben Sie den Text wie angegeben ein. |
| Kursiv | Platzhalter für einen Wert |
| X | Y | Wählen Sie 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>
{maximal ein Add-Element}
{maximal ein Remove-Element}
{maximal ein Updates-Element}
{maximal ein Display-Element}
{maximal ein Logging-Element}
</Configuration>
Add-Element
Dient zum Angeben der zu installierenden Produkte und Sprachen.
Syntax
<Add
SourcePath="\\Server\Freigabe\"
Version="15.1.2.3"
ForceDowngrade= TRUE | FALSE
OfficeClientEdition=32 | 64
>
{0 oder n Product-Elemente}
</Add>
In der folgenden Tabelle werden die Attribute und Werte für dasAdd-Element beschrieben:
Attribute und Werte für das Add-Element
| Attribut | Wert | Beschreibung |
|---|---|---|
| SourcePath | \\Server\Freigabe\ C:\Vorladen\Office http://internApps/Office/ | Erforderlich. SourcePath muss festgelegt werden. Der Wert SourcePath kann auf einen lokalen Pfad oder auf einen Netzwerk- oder HTTP-Pfad festgelegt werden, an dem sich die Klick-und-Los-Quelle befindet. Für Netzwerkpfade und lokale Pfade können Umgebungsvariablen verwendet werden. |
| Version | 15.1.2.3 | Optional. Ist kein Wert vom Typ Version festgelegt, wird von der Klick-und-Los-Produktinstallation die neueste verfügbare aus der Quelle gestreamt. Version kann auf eine Office 2013-Buildnummer im folgenden Format festgelegt werden: X.X.X.X |
| ForceDowngrade | TRUE oder FALSE | Optional. Ist ForceDowngrade nicht festgelegt, wird der Wert als FALSE interpretiert. Wenn Sie Produkte hinzufügen, werden nur dann neue Dateien heruntergeladen, wenn die Dateien neuer sind als die bereits auf dem Client installierten Dateien. Wenn Sie ForceDowngrade auf TRUE festlegen und das Attribut Version angeben, werden für das herunterzuladende Produkt alle Produktdateien für die angegebene Version heruntergeladen – und zwar auch, wenn auf dem Client bereits neuere Dateien installiert sind. |
| OfficeClientEdition | 32 oder 64 | Optional. Dient zum Angeben der zu verwendenden Edition des Produkts vom Typ "Klick-und-Los für Office 365": 32 Bit oder 64 Bit. Falls OfficeClientEdition nicht auf einen gültigen Wert festgelegt ist, tritt ein Fehler auf. Vorgänge im Konfigurationsmodussind unter Umständen nicht erfolgreich, wenn OfficeClientEdition nicht korrekt festgelegt ist. Dieser Fall kann beispielsweise eintreten, wenn Sie versuchen, eine 64-Bit-Edition eines Produkts vom Typ "Klick-und-Los für Office 365" auf einem Computer unter einem Windows-Betriebssystem mit 32 Bit zu installieren, oder wenn Sie versuchen, ein 32-Bit-Produkt vom Typ "Klick-und-Los für Office 365" auf einem Computer zu installieren, auf dem eine 64-Bit-Edition von Office installiert ist. |
| Hinweis: |
|---|
| Mit dem Product-Elementwerden die zu installierenden Produkte und Sprachen (angegeben durch {0 oder n Language-Elemente}) angegeben. Siehe Language-Element. |
Mit dem Code im folgenden Beispiel wird die 32-Bit-Edition von Office 365 ProPlus in englischer Sprache installiert:
<Add SourcePath="\\server\share\" Version="15.1.2.3" OfficeClientEdition="32"> <Product ID="O365ProPlusRetail> <Language ID="en-us" /> </Product> </Add>
Mit dem Code im folgenden Beispiel wird die 32-Bit-Version 15.1.2.3 von Office 365 ProPlus über die angegebene Netzwerkfreigabe \\server\share installiert:
<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
<Product ID="O365ProPlusRetail" />
</Add>
Display-Element
Dient zum Angeben der Benutzeroberflächenebene, die den Benutzern angezeigt werden soll.
Syntax
<Display
Level=None | Full
AcceptEULA=TRUE | FALSE
/>
In der folgenden Tabelle werden die Attribute und Werte für dasDisplay-Element beschrieben:
Attribute und Werte für das Display-Element
| Attribut | Wert | Beschreibung |
|---|---|---|
| Level | None Full | Optional. Bestimmt die Benutzeroberfläche, die Benutzern beim Ausführen des Vorgangs angezeigt wird. Ist Level auf None festgelegt, wird dem Benutzer keine Benutzeroberfläche angezeigt. Der Benutzer sieht also keinen Status, keinen Abschlussbildschirm, keine Fehlerdialogfelder und keine automatisch gestartete Benutzeroberfläche bei der Erstausführung. Ist Level auf Full festgelegt, wird dem Benutzer die normale Benutzeroberfläche von Klick-und-Los angezeigt: automatischer Start, Anwendungs-Begrüßungsbildschirm und Fehlerdialogfelder. |
| AcceptEULA | TRUE FALSE | Optional. Es wird empfohlen, AcceptEULA auf TRUE festzulegen. Ist dieses Attribut auf TRUE festgelegt, wird dem Benutzer kein Dialogfeld mit den Microsoft-Software-Lizenzbedingungen angezeigt. Ist dieses Attribut auf FALSE oder gar nicht festgelegt, wird dem Benutzer ggf. ein Dialogfeld mit den Microsoft-Software-Lizenzbedingungen angezeigt. |
Beispiel:
<Display Level="None" AcceptEULA="TRUE" />
Language-Element
Dient zum Angeben der zu installierenden Sprachen.
Syntax
<Language ID= "sc-lc" />
| Wichtig: |
|---|
| Im Rahmen der Vorabversion kann lediglich eine einzelne Sprache installiert werden. Wenn Sie zusätzliche Sprachen installieren möchten, führen Sie das Office-Bereitstellungstool erneut aus, und geben Sie die zusätzliche Sprache in der Datei "Configuration.xml" an. Von der Vorabversion werden die Sprachen Englisch, Japanisch und Spanisch unterstützt. |
In der folgenden Tabelle werden die Attribute und Werte für dasLanguage-Element beschrieben:
Attribute und Werte für das Language-Element
| Attribut | Wert | Beschreibung |
|---|---|---|
| ID | sc-lc | Erforderlich. Ist der Wert Language ID nicht festgelegt, tritt ein Fehler mit dem Hinweis auf, dass die Eingabe ungültig ist. Der Wert ID kann auf eine gültige Office-Kultursprache (beispielsweise "en-us" für Englisch (USA) oder "ja-jp" für Japanisch) festgelegt werden. Der Wert sc-lc ist die Sprachen-ID. |
Im folgenden Beispiel wird gezeigt, wie Sie die 32-Bit-Edition von Office 365 ProPlus in englischer, japanischer und spanischer Sprache installieren. Beachten Sie, dass für die Vorabversion lediglich eine einzelne Sprache installiert werden kann. Führen Sie das Office-Bereitstellungstool erneut aus, wenn Sie weitere Sprachen hinzufügen möchten.
<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
<Product ID="O365ProPlusRetail" >
<Language ID="en-us" />
<Language ID="es-es" />
<Language ID="ja-jp" />
<Product/>
</Add>
Logging-Element
Gibt den von Klick-und-Los ausgeführten Protokollierungstyp an.
Syntax
<Logging
Level = Off | Standard
Path = UNC-Pfad oder lokaler Pfad
Name = gültiger Dateiname
/>
In der folgenden Tabelle werden die Attribute und Werte für dasLogging-Element beschrieben:
Attribute und Werte für das Logging-Element
| Attribut | Wert | Beschreibung |
|---|---|---|
| Level | Off Standard | Optional. Dient zum Angeben von Optionen für die vom Setup für Klick-und-Los ausgeführte Protokollierung. Standardwert: Standard. |
| Path | %temp%\\server\share\userlogs\ | Optional. Gibt den vollqualifizierten Pfad zum für die Protokolldatei verwendeten Ordner an. Umgebungsvariablen können verwendet werden. Standardwert: %temp%. |
| Name | Optional. Gibt den Namen der Protokolldatei an. Der Name kann ein Sternchen ("*") enthalten. Bei Verwendung eines Sternchens wird dieses dynamisch durch einen Zeitstempel ersetzt. |
Beispiel:
<Logging Level="Standard" Path="%temp%" Name="C2RLog(*).txt" />
Product-Element
Dient zum Angeben des zu installierenden Klick-und-Los-Produkts.
Syntax
<Product
ID= "O365ProPlusRetail"
PIDKEY="12345-12345-12345-12345-12345"
>
{0 oder n Language-Elemente}
</Product>
In der folgenden Tabelle werden die Attribute und Werte für dasProduct-Element beschrieben:
Attribute und Werte für das Product-Element
| Attribut | Wert | Beschreibung |
|---|---|---|
| ID | O365ProPlusRetail | Erforderlich. ID muss auf eine gültige Produktversions-ID festgelegt werden. Für Produkte vom Typ "Klick-und-Los für Office 365" werden folgende Produktversions-IDs unterstützt:
Ist der Wert ID nicht festgelegt, tritt ein Fehler mit dem Hinweis auf, dass die Eingabe ungültig ist. |
| PIDKEY | 12345-12345-12345-12345-12345 | Optional. Ist PIDKEY festgelegt, wird der 25-stellige PIDKEY-Wert für dieses Produkt verwendet. |
| Hinweis: |
|---|
| Die zu installierenden Produktsprachen werden mithilfe von Language-Elementen festgelegt. Administratoren müssen angeben, welche Sprachen sie installieren möchten. Die erste Sprache bestimmt die Kultur der Shellbenutzeroberfläche. Die Shellbenutzeroberfläche ist die Sprache für Tastenkombinationen, Rechtsklick-Kontextmenüs und QuickInfos. |
Im folgenden Beispiel wird Office 365 ProPlus angegeben:
<Product ID="O365ProPlusRetail" />
Im folgenden Beispiel werden Office 365 ProPlus und Visio Pro für Office 365 in englischer, spanischer und japanischer Sprache angegeben:
<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
<Product ID="O365ProPlusRetail" >
<Language ID="en-us" />
<Language ID="es-es" />
<Language ID="ja-jp" />
<Product/>
<Product ID="VisioProRetail" >
<Language ID="en-us" />
<Language ID="es-es" />
<Language ID="ja-jp" />
<Product/>
</Add>
Remove-Element
Dient zum Entfernen von Produkten und Sprachen.
Syntax
<Remove
All="TRUE" | "FALSE"
>
{0 oder n Product-Elemente}
</Remove>
In der folgenden Tabelle werden die Attribute und Werte für dasRemove-Element beschrieben:
Attribute und Werte für das Remove-Element
| Attribut | Wert | Beschreibung |
|---|---|---|
| All | TRUE FALSE | Optional. Der Standardwert ist FALSE. Wird All auf TRUE festgelegt, werden alle Klick-und-Los-Produkte entfernt. |
| Wichtig: |
|---|
| Wenn Product-Element angegeben werden und diese IDs für Language-Element enthalten, werden die Sprachressourcen für dieses Produkt entfernt. Dies gilt nicht, wenn dadurch alle Sprachressourcen für das Produkt entfernt werden oder die Kombination aus Produkt und Sprache auch im Add-Element in der Klick-und-Los-Datei "Configuration.xml" angegeben ist. Falls Product-Element ohne Language-Element angegeben werden, wird das Produkt zusammen mit allen zugeordneten Sprachressourcen entfernt. Die gilt, sofern im Add-Element in der Klick-und-Los-Datei "Configuration.xml" nicht das gleiche Produkt gefunden wird. Ist All auf TRUE festgelegt, wird die gesamte Installation unabhängig davon entfernt, was im Add-Element angegeben ist. |
Mit dem Code im folgenden Beispiel wird Office 365 ProPlus entfernt:
<Remove>
<Product ID="O365ProPlusRetail" />
</Remove>
Mit dem Code im folgenden Beispiel werden die Sprachressourcen für Spanisch aus der Office 365 ProPlus-Installation entfernt:
<Remove>
<Product ID="O365ProPlusRetail" >
<Language ID="es-es" />
<Product/>
</Remove>
Mit dem Code im folgenden Beispiel wird die gesamte Installation entfernt:
<Remove All="TRUE" />
Updates-Element
Dient zum Angeben der Attribute zum Konfigurieren von Updates.
Syntax
<Updates
Enabled= TRUE | FALSE
UpdatePath= UNC-Pfad | lokaler Pfad | HTTP-Pfad
TargetVersion= X.Y.Z.W
/>
In der folgenden Tabelle werden die Attribute und Werte für dasUpdates-Element beschrieben:
Attribute und Werte für das Updates-Element
| Attribut | Wert | Beschreibung |
|---|---|---|
| Enabled | TRUE FALSE | Optional. Ist Enabled auf TRUE festgelegt, wird vom Klick-und-Los-Updatesystem nach Updates gesucht. Bei FALSE wird das Klick-und-Los-Updatesystem nicht verwendet. |
| UpdatePath | \\Server\Freigabe\ C:\Vorladen\Office http://internApps/Office/ "" | Optional. Ist UpdatePath nicht festgelegt, werden Updates von Klick-und-Los-Installationen über die Microsoft-Quelle für Klick-und-Los (Netzwerk für die Inhaltsübermittlung; Content Delivery Network, CDN) abgerufen. Dies ist die Standardeinstellung. Ist UpdatePath auf einen leeren Wert ("") festgelegt, werden Updates über die Microsoft-Quelle für Klick-und-Los (CDN) abgerufen. Mit UpdatePath kann ein Netzwerkpfad, ein lokaler Pfad oder ein HTTP-Pfad einer Quelle für Klick-und-Los angegeben werden. Für Netzwerkpfade und lokale Pfade können Umgebungsvariablen verwendet werden. |
| TargetVersion | 15.1.2.3 "" | Optional. Ist TargetVersion nicht festgelegt, wird von Klick-und-Los eine Aktualisierung auf die neueste Version aus der Microsoft-Quelle für Klick-und-Los ausgeführt. Ist TargetVersion auf einen leeren Wert ("") festgelegt, wird von Klick-und-Los eine Aktualisierung auf die neueste Version aus der Microsoft-Quelle für Klick-und-Los ausgeführt. TargetVersion kann auf eine Office-Buildnummer (beispielsweise "15.1.2.3") festgelegt werden. Wenn die Version festgelegt ist, wird von Office im nächsten Aktualisierungszyklus versucht, zur angegebenen Version zu wechseln. |
Im folgenden Beispiel sind Office-Updates aktiviert, es wird ein alternativer Updatepfad verwendet, Internet-Fallback ist zulässig, und die Produktversion ist auf "15.1.2.3" festgelegt:
<Updates Enabled="TRUE" UpdatePath="\\Server\share\" TargetVersion="15.1.2.3" />
Im folgenden Beispiel sind Updates deaktiviert:
<Updates Enabled="FALSE" />
Beispiel für die Klick-und-Los-Datei "Configuration.xml"
Mit dem Code im folgenden Beispiel für die Klick-und-Los-Datei "Configuration.xml" wird angegeben, dass die 32-Bit-Version von Office 365 ProPlus in englischer Sprache installiert werden soll. Darüber hinaus werden Updates auf Enabled festgelegt, eine alternative Quelle wird verwendet, und die Zielversion für Updates wird festgelegt:
<Configuration>
<Add SourcePath="\\server\share" Version="15.1.2.3" OfficeClientEdition="32">
<Product ID="O365ProPlusRetail" >
<Language ID="en-us" />
<Product/>
</Add>
<Updates Enabled="TRUE" UpdatePath="\\Server\share\" TargetVersion="15.1.2.3" />
</Configuration>
Change History
| Date | Description |
|---|---|
| February 19, 2013 | Updated information about the Language element and the SourcePath description. Added information about the Property element (new), and provided a new Click-to-run Configuration.xml example. |
| 16.07.2012 | Erstveröffentlichung |
