Freigeben über

Konfigurationsoptionen für das Office-Bereitstellungstool

  • Artikel

Verwenden Sie das Office Deployment Tool (ODT), um Microsoft 365 Apps herunterzuladen und auf Clientcomputern bereitzustellen. Das ODT bietet mehr Kontrolle über die Installation, sodass Sie definieren können, welche Produkte und Sprachen installiert werden sollen, wie sie aktualisiert werden sollen und ob die Installation für Benutzer angezeigt werden soll. In diesem Artikel werden alle verfügbaren Optionen im Tool behandelt. Informationen zur Verwendung des Tools selbst finden Sie unter Übersicht über das Office-Bereitstellungstool.

Hinweis

Beste Praxis: Die Optionen in diesem Artikel zeigen die XML-Elemente und -Attribute in der Konfigurationsdatei an. Sie können die Konfigurationsdatei weiterhin in einem Text-Editor erstellen, es wird jedoch empfohlen, stattdessen das Office-Anpassungstool zu verwenden. Mit dem Office-Anpassungstool können Sie Konfigurationsdateien ganz einfach in einer webbasierten Benutzeroberfläche erstellen und ändern. Weitere Informationen finden Sie unter Übersicht über das Office-Anpassungstool.

Beispiel für eine Standardkonfigurationsdatei

Das ODT besteht aus zwei Dateien: setup.exe und configuration.xml. Um mit dem Tool zu arbeiten, bearbeiten Sie die Konfigurationsdatei, um die gewünschten Optionen zu definieren, und führen dann setup.exe über die Befehlszeile aus. Beispielsweise können Sie die Konfigurationsdatei bearbeiten, um die 64-Bit-Englische Edition von Microsoft 365 Apps herunterzuladen, oder Sie können die Datei bearbeiten, um die 64-Bit-Englische Edition von Microsoft 365 Apps zu installieren, wobei der Endbenutzer-Lizenzvertrag (EULA) automatisch akzeptiert wird und ohne Herausgeber.

Beim Erstellen der Konfigurationsdatei wird empfohlen, dass Sie mit einer Beispieldatei beginnen und diese mit den entsprechenden Optionen für Ihre Umgebung aktualisieren. Sie können zunächst das folgende Beispiel kopieren und in eine Textdatei einfügen und mit einem Namen Ihrer Wahl speichern. Verwenden Sie die Datei, um die XML-Elemente und -Attribute zu ändern, und verwenden Sie den Rest dieses Artikels, um weitere Details zu den einzelnen Elementen und Attributen zu erfahren.

Diese Konfigurationsdatei enthält die am häufigsten verwendeten Elemente und Attribute und kann zum Herunterladen und Installieren von Microsoft 365 Apps auf einem Clientcomputer verwendet werden.

<Configuration>
  <Add SourcePath="\\Server\Share" 
       OfficeClientEdition="64"
       Channel="MonthlyEnterprise" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
    </Product>
    <Product ID="VisioProRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
    </Product>
  </Add>
  <Updates Enabled="TRUE" 
           UpdatePath="\\Server\Share" />
   <Display Level="None" AcceptEULA="TRUE" />  
</Configuration>
Wert Beschreibung
Add SourcePath="\\Server\Share"
 Office wird in "\\server\share" in Ihrem Netzwerk heruntergeladen und mithilfe von Installationsdateien an diesem Speicherort bereitgestellt.
Hinzufügen von OfficeClientEdition="64"
 Herunterladen und Installieren der 64-Bit-Edition von Office
Add Channel="MonthlyEnterprise"
 Office wird mithilfe des monatlichen Enterprise-Kanals installiert.
Product ID="O365ProPlusRetail"
 Lädt Microsoft 365 Apps for Enterprise herunter und installiert sie.
Language ID="en-us"
Language ID="ja-jp"
 Lädt die englische und japanische Version von Office herunter und installiert diese.
Updates Enabled="TRUE"
 Office sucht nach Updates.
Updates UpdatePath="\\Server\Share"
 Office sucht in Ihrem Netzwerk unter "\server\share" nach Updates.
Display Level="None" AcceptEULA="TRUE"
 Bei der Installation von Office wird keine Benutzeroberfläche angezeigt.

Add-Element

Definiert die Produkte und Sprachen, die heruntergeladen oder installiert werden sollen.

Beispiel

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     Version="16.0.15330.20306" >
  <Product ID="O365ProPlusRetail">
    <Language ID="en-us" />
    <Language ID="ja-jp" />
  </Product>
  <Product ID="VisioProRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
  </Product>
</Add>

SourcePath-Attribut (Teil des Add-Elements)

Optional.

Definiert den Speicherort der Microsoft 365 Apps Installationsdateien. Wenn das Office-Bereitstellungstool im Downloadmodus ausgeführt wird, wird dadurch definiert, wo die Dateien gespeichert werden sollen. Falls nicht enthalten, sucht das ODT nach Installationsdateien im gleichen Ordner wie das Tool und verwendet dann das Content Delivery Network (CDN). Wenn nicht enthalten und das ODT im Downloadmodus ausgeführt wird, werden die Microsoft 365 Apps Installationsdateien in denselben Ordner wie das Tool heruntergeladen.

Wenn Sie Microsoft 365 Apps in einen Ordner herunterladen, der diese Version von Microsoft 365 Apps bereits enthält, spart das ODT Ihre Netzwerkbandbreite, indem nur die fehlenden Dateien heruntergeladen werden. Wenn Sie beispielsweise das ODT verwenden, um Microsoft 365 Apps in Englisch und Deutsch in einen Ordner herunterzuladen, der bereits Microsoft 365 Apps in Englisch enthält, wird nur das deutsche Sprachpaket heruntergeladen.

Beispielwerte:

  • SourcePath="\\server\share"
  • SourcePath="C:\Downloads\Microsoft"

Der SourcePath-Wert darf nicht den Teil /Office oder den Namen des Ordners enthalten, in den Office-Daten heruntergeladen werden.

Versionsattribut (Teil des Add-Elements)

Optional. Wenn nicht angegeben, wird standardmäßig die neueste verfügbare Version verwendet.

Wenn Sie das Version-Attribut verwenden, empfiehlt es sich, auch das Channel-Attribut einzuordnen. Wenn Sie das Channel-Attribut nicht einschließen, wird der Standardkanal verwendet, der möglicherweise nicht mit der angegebenen Version übereinstimmt.

Wenn Microsoft 365 Apps bereits auf einem Gerät installiert ist, können Sie Version="MatchInstalled" verwenden, um dieselbe Version zu installieren, auch wenn eine neuere Version verfügbar ist. Diese Einstellung kann das Hinzufügen von Sprachpaketen oder Visio und Project erleichtern, ohne auf eine neuere Version zu aktualisieren.

Beispielwerte:

  • Version="16.0.15330.20306"
  • Version="MatchInstalled"

OfficeClientEdition-Attribut (Teil des Add-Elements)

Optional.

Definiert, ob die 32-Bit- oder 64-Bit-Edition von Microsoft 365 Apps heruntergeladen oder installiert wird. Wenn Microsoft 365 Apps nicht auf dem Gerät installiert ist und OfficeClientEdition nicht festgelegt ist, wählt das ODT automatisch die 64-Bit-Edition aus. Es wählt jedoch die 32-Bit-Edition aus, wenn das Gerät eine 32-Bit-Version von Windows verwendet oder über weniger als 4 GB RAM verfügt. Wenn Microsoft 365 Apps installiert ist und OfficeClientEdition nicht angegeben ist, entspricht das ODT der Architektur der vorhandenen Installation von Microsoft 365 Apps. Wenn Microsoft 365 Apps installiert ist und OfficeClientEdition angegeben ist, muss sie mit der bereits installierten Architektur übereinstimmen. Ist dies nicht der Fall, schlägt die Installation fehl, da gemischte Architekturen nicht unterstützt werden.

Zulässige Werte:

  • OfficeClientEdition="64"
  • OfficeClientEdition="32"

Hinweis

Arm-basierte Geräte erfordern Windows 11 oder höher, um Microsoft 365 Apps auszuführen. Die 32-Bit-Version von Microsoft 365 Apps wird auf diesen Geräten nicht unterstützt. Wenn Sie die 64-Bit-Version auf einem Arm-basierten Gerät installieren, enthält sie automatisch die Arm-optimierten Komponenten, um die Leistung zu verbessern und die Kompatibilität mit der Arm-Architektur sicherzustellen.

Kanalattribut (Teil des Add-Elements)

Optional.

Definiert, welcher Kanal zum Installieren von Microsoft 365 Apps verwendet werden soll. Wenn Microsoft 365 Apps nicht auf dem Gerät installiert ist, lautet die Standardeinstellung für das Channel-Attribut Current. Wenn Microsoft 365 Apps auf dem Gerät installiert ist und das Channel-Attribut nicht angegeben ist, stimmt das ODT mit dem Kanal der vorhandenen Installation überein.

Dieser Wert bestimmt den zu installierenden Kanal, unabhängig von einem optional angegebenen Updatekanal im Updates-Element oder über Gruppenrichtlinie Setting. Wenn eine solche Einstellung mit einem anderen Updatekanal vorhanden ist, wird der Kanalwechsel nach der Installation während des nächsten Updatezyklus ausgeführt. Weitere Informationen finden Sie unter Ändern des Microsoft 365 Apps Updatekanals.

Weitere Informationen zu Updatekanälen finden Sie unter Übersicht über die Updatekanäle für Microsoft 365 Apps.

Zulässige Werte:

  • Channel="BetaChannel"
  • Channel="CurrentPreview"
  • Channel="Current"
  • Channel="MonthlyEnterprise"
  • Channel="Semi AnnualPreview"
  • Channel="Semi Annual"

Hinweis

  • Frühere zulässige Werte für jeden Updatekanal können weiterhin verwendet werden, was bedeutet, dass Sie Ihre älteren XML-Konfigurationsdateien nicht aktualisieren müssen.
  • Beta-Kanal (manchmal auch als Insider Fast bezeichnet) ist kein unterstützter Build und sollte daher nur in Testumgebungen und von einer kleinen Gruppe ausgewählter Benutzer wie IT-Mitarbeitern oder Anwendungsentwicklern verwendet werden.

Wenn Sie Microsoft Office Long Term Servicing Channel (LTSC) Professional Plus 2021 oder Office LTSC Standard 2021 bereitstellen, bei denen es sich um Volumenlizenzversionen handelt, gibt es einen anderen Updatekanal, den Sie verwenden müssen: PerpetualVL2021. Weitere Informationen finden Sie unter Updatekanal für Office LTSC 2021.

Wenn Sie Office Professional Plus 2019 oder Office Standard 2019 bereitstellen, bei denen es sich um Volumenlizenzversionen handelt, gibt es einen anderen Updatekanal, den Sie verwenden müssen: PerpetualVL2019. Weitere Informationen finden Sie unter Updatekanal für Office 2019.

DownloadPath-Attribut (Teil des Add-Elements)

Optional. Wenn nicht angegeben, wird standardmäßig das CDN verwendet.

Hinweis

Netzwerkkonnektivität ist erforderlich, wenn ODT im Downloadmodus ausgeführt wird, auch wenn der Download von dem mit DownloadPath angegebenen Speicherort stammt.

Definiert, wo die Installationsdateien heruntergeladen werden, wenn ODT im Downloadmodus ausgeführt wird. Wird am häufigsten verwendet, um bestimmte Sprachen und Produkte für Microsoft 365 Apps von einem zentralen Standort in Ihrem Netzwerk an einen anderen Standort zu verteilen. Sie müssen eine Version angeben, wenn Sie DownloadPath verwenden, wie im Beispiel gezeigt.

Beispielwerte:

  • DownloadPath="\\servera\share"

Beispiel

<Configuration> 
  <Add SourcePath="\\serverb\share" OfficeClientEdition="64" Version="16.0.6741.2056" DownloadPath="\\servera\share"> 
    <Product ID="O365ProPlusRetail" > 
      <Language ID="en-us" />      
    </Product> 
  </Add> 
</Configuration>

AllowCdnFallback-Attribut (Teil des Add-Elements)

Optional. Der Standardwert ist False, wenn nicht angegeben.

Um das CDN als Sicherungsquelle für Sprachpakete zu verwenden, fügen Sie das Attribut "AllowCdnFallback" in die Konfigurationsdatei ein, wie im Beispiel gezeigt.

Wenn Sie Sprachen installieren, sucht das ODT zuerst nach Quelldateien an dem speicherort, der im SourcePath-Attribut angegeben ist. Wenn das Sprachpaket an diesem Speicherort nicht verfügbar ist und die Einstellung AllowCdnFallback auf True festgelegt ist, verwendet das ODT Quelldateien aus dem CDN.

Zulässige Werte:

  • AllowCdnFallback="True"
  • AllowCdnFallback="False"

Beispiel

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     AllowCdnFallback="True">
  <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
      <Language ID="ja-jp" />
  </Product>
</Add>

MigrateArch-Attribut (Teil des Add-Elements)

Optional. Der Standardwert ist False, wenn nicht angegeben.

Wenn sie auf TRUE festgelegt ist, wird Ihre vorhandene Installation von Microsoft 365 Apps in die Architektur (manchmal auch als Bitanzahl bezeichnet) geändert, die im OfficeClientEdition-Attribut angegeben wird. Sie können dieses Attribut beispielsweise verwenden, um eine 32-Bit-Installation von Microsoft 365 Apps in eine 64-Bit-Installation zu ändern.

Weitere Informationen zur Verwendung von MigrateArch finden Sie unter Ändern einer Microsoft 365 Apps Installation von 32-Bit in 64-Bit.

OfficeMgmtCOM-Attribut (Teil des Add-Elements)

Optional. Der Standardwert ist False, wenn nicht angegeben.

Wenn true festgelegt ist, wird ein COM-Objekt registriert, das erforderlich ist, damit Updateverwaltungslösungen (z. B. Microsoft Configuration Manager) Updates verwalten können. Erforderlich, wenn sie Configuration Manager für Microsoft 365 Apps Updates verwenden. Wenn das Office COM-Objekt aktiviert ist, wird die Option Jetzt aktualisieren auf der Seite Konto für Microsoft 365 Apps für Clientgeräte automatisch deaktiviert.

Weitere Informationen finden Sie unter Verwalten von Updates für Microsoft 365 Apps mit Microsoft Configuration Manager.

Zulässige Werte:

  • OfficeMgmtCOM="True"
  • OfficeMgmtCOM="False"

Beispiel

<Configuration>
  <Add OfficeClientEdition="64" Channel="MonthlyEnterprise" OfficeMgmtCOM="True" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>  
  <Updates Enabled="True"  /> 
</Configuration>

Product-Element

Definiert, welche Produkte heruntergeladen oder installiert werden sollen. Wenn Sie mehrere Produkte definieren, werden die Produkte in der Reihenfolge wie in der Konfigurationsdatei installiert. Das erste Produkt bestimmt den Kontext für die Microsoft Office First Run Experience.

Sie können auch das Product-Element verwenden, um sprachpakete zu vorhandenen Installationen von Microsoft 365 Apps hinzuzufügen. Weitere Informationen, einschließlich einer Beispielkonfigurationsdatei, finden Sie unter Bereitstellen von Sprachen für vorhandene Installationen von Microsoft 365 Apps.

Beispiel

<Product ID="O365ProPlusRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>
<Product ID="VisioProRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>

ID-Attribut (Teil des Product-Elements)

Erforderlich.

Definiert die ID des zu herunterladenden oder zu installierenden Produkts.

Beispielwerte:

  • ID="O365ProPlusRetail"
  • ID="VisioProRetail"
  • ID="ProjectProRetail"

Eine Liste aller unterstützten Produkt-IDs finden Sie unter Produkt-IDs, die vom Office-Bereitstellungstool für Klick-und-Los unterstützt werden.

MSICondition-Attribut (Teil des Product-Elements)

Optional.

Ermöglicht es Ihnen, die Installation eines Office-Produkts zu steuern, wie durch das ID-Attribut angegeben, basierend darauf, ob ein bestimmtes MSI-basiertes Office-Produkt bereits auf dem Gerät installiert ist. Wenn beispielsweise bereits eine MSI-basierte Version von Project Professional auf dem Gerät installiert ist, installieren Sie Project Online Desktopclient.

Sie können ein beliebiges Office-Produkt angeben, das von Windows Installer (MSI) installiert wird, aber MSICondition wird am häufigsten für Project- oder Visio-Installationen verwendet. Der Wert, den Sie für das MSICondition-Attribut angeben, kann entweder eine Volumenlizenzversion oder eine Verkaufsversion des Produkts sein, solange diese Version des Produkts mithilfe von MSI installiert wurde.

MSICondition erkennt die Versionen 2007, 2010, 2013 und 2016 des von Ihnen angegebenen Office-Produkts. Sie können jedoch keine bestimmte Version angeben. Beispielsweise können Sie MSICondition nicht speziell für Visio Standard 2013 suchen lassen. MSICondition sucht nach allen MSI-basierten Installationen von Visio Standard, einschließlich Visio Standard 2007, Visio Standard 2010, Visio Standard 2013 und Visio Standard 2016.

Der Wert, den Sie für das MSICondition-Attribut angeben, ist die Setup-ID, die sich in der Setup.xml-Datei im {product} befindet. WW-Ordner der Installationsdateien für Ihre vorhandene Version des Office-Produkts. Beispielsweise befindet sich die Setup.xml-Datei für Visio Professional 2016 im Ordner VisPro.WW. Sie können mehrere Typen eines Office-Produkts angeben, die durch ein Komma getrennt sind. Beispielsweise können Sie "PrjStd,PrjStdR,PrjPro,PrjProR" angeben, um nach Installationen von Project Standard oder Project Professional zu suchen, entweder volumenlizenziert oder im Einzelhandel.

Hinweis

Es wird empfohlen, die vorhandenen MSI-basierten Office-Produkte im Rahmen der Installation der in Ihrer XML-Datei angegebenen Produkte zu entfernen. Um vorhandene MSI-basierte Produkte zu entfernen, verwenden Sie das RemoveMSI-Element.

Sie können auch ein Video zur Verwendung von MSICondition in Kombination mit RemoveMSI watch, um Ihr Upgrade zu vereinfachen.

Beispiel für das MSICondition-Attribut

Im folgenden Beispiel wird Project Online Desktopclient nur dann auf dem Gerät installiert, wenn bereits eine MSI-basierte Version von Project Standard auf dem Gerät installiert ist. Außerdem wird Project Standard im Rahmen der Installation von Project Online Desktopclient vom Gerät entfernt.

<Configuration>
  <Add>
      <Product ID="ProjectProRetail" MSICondition="PrjStd,PrjStdR">
         <Language ID="en-us" />
         <Language ID="MatchPreviousMSI" />
      </Product>
  </Add>
  <RemoveMSI />
</Configuration>

Language-Element

Definiert, welche Sprachen heruntergeladen oder installiert werden sollen. Wenn Sie mehrere Sprachen definieren, bestimmt die erste Sprache in der Konfigurationsdatei die Shell-Benutzeroberflächenkultur, einschließlich Tastenkombinationen, Kontextmenüs und QuickInfos. Wenn Sie die Sprache der Shell-Benutzeroberfläche nach der ersten Installation ändern möchten, müssen Sie Microsoft 365 Apps deinstallieren und dann erneut installieren.

Beispiel

<Product ID="O365ProPlusRetail">
  <Language ID="en-us" />
  <Language ID="ja-jp" />
</Product>

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise"
     AllowCdnFallback="True">
  <Product ID="O365ProPlusRetail">
     <Language ID="MatchInstalled" />
     <Language ID="MatchOS" Fallback="en-us" />
  </Product>
</Add>

ID-Attribut (Teil des Language-Elements)

Erforderlich.

Definiert die ID der zu herunterladenden oder zu installierenden Sprache.

Beispielwerte

  • ID="en-us"
  • ID="ja-jp"
  • ID="MatchOS"
  • ID="MatchPreviousMSI"
  • ID="MatchInstalled"

Stellen Sie sicher, dass die von Ihnen angegebenen Sprachen das Produkt unterstützen, das Sie installieren. Andernfalls tritt bei der Installation ein Fehler auf.

Beispielsweise unterstützt Microsoft 365 Apps Englisch (Vereinigtes Königreich), Französisch (Kanada) und Spanisch (Mexiko), aber Project und Visio unterstützen diese Sprachen nicht.

Weitere Informationen zu MatchPreviousMSI finden Sie unter Entfernen vorhandener MSI-Versionen von Office beim Upgrade auf Microsoft 365 Apps.

MatchOS und MatchInstalled können die Betriebssystemsprachen nicht installieren, wenn Microsoft 365 Apps diese Sprache nicht unterstützt oder wenn das ODT das richtige Sprachpaket in den lokalen Quelldateien nicht finden kann. Um dieses Problem zu beheben, empfehlen wir, dass Sie eine Sicherungssprache angeben und dem ODT erlauben, das CDN für fehlende Dateien zu verwenden. Verwenden Sie dazu das Fallback-Attribut und das AllowCdnFallBack-Attribut.

MatchInstalled kann nur verwendet werden, wenn mindestens ein Klick-und-Run-Produkt bereits installiert ist. Sie kann nicht mit dem Schalter /download für das ODT verwendet werden. Weitere Informationen zu MatchInstalled finden Sie unter Übersicht über die Bereitstellung von Sprachen und Erstellen dynamischer, schlanker und universeller Pakete für Microsoft 365 Apps.

Ausweich-Attribut (Teil des Language-Elements)

Optional.

Geben Sie bei Verwendung von MatchOS eine Fallbacksprache an, die installiert werden soll, wenn die übereinstimmende Sprache von Microsoft 365 Apps nicht unterstützt wird oder in den lokalen Quelldateien nicht verfügbar ist. Verwenden Sie dazu das Attribut "Fallback". Weitere Informationen finden Sie unter Installieren der gleichen Sprachen wie das Betriebssystem.

Beispielwerte:

  • Fallback="en-us"
  • Fallback="ja-jp"

TargetProduct-Attribut (Teil des Language-Elements)

Optional.

Wenn Sie MatchInstalled verwenden, können Sie angeben, ob Sie die Liste der bereits installierten Sprachen für ein bestimmtes Produkt oder die Kombination aller installierten Produkte abgleichen möchten. Um ein bestimmtes Produkt als Ziel festzulegen, können Sie eine beliebige unterstützte Produkt-ID angeben. Wenn Sie mit den Sprachen aller bereits installierten Produkte übereinstimmen möchten, geben Sie "Alle" an. ODT installiert dann das neue Produkt mit dem gleichen Satz von Sprachen wie die in TargetProduct angegebene.

Wenn kein TargetProduct mit MatchInstalled angegeben ist, versucht das ODT, dieselbe Produkt-ID abzugleichen, zu der das Language-Tag in der Konfigurationsdatei gehört. Wenn Sie beispielsweise MatchInstalled verwenden, während Sie "VisioProRetail" ohne TargetProduct installieren, versucht ODT, die bereits installierten Sprachen für dieses Produkt abzugleichen.

Beispielwerte:

<Language ID="MatchInstalled" TargetProduct="O365ProPlusRetail" />
<Language ID="MatchInstalled" TargetProduct="All" />

Display-Element

Definiert, was dem Benutzer angezeigt wird, wenn Microsoft 365 Apps installiert wird.

Beispiel

<Display Level="None" AcceptEULA="TRUE" />

Level-Attribut (Teil des Display-Elements)

Optional. Der Standardwert ist auf Full festgelegt, wenn nicht angegeben.

Wenn Level auf Keine festgelegt ist, wird Microsoft 365 Apps ohne Benutzeroberfläche installiert: Es werden keine Statusanzeigen, Abschlussbildschirme, Fehlermeldungen oder andere Benutzeroberfläche angezeigt.

Wenn Level auf Full festgelegt ist, wird Microsoft 365 Apps mit der normalen Installationserfahrung installiert.

Zulässige Werte:

  • Level="None"
  • Level="Full"

AcceptEULA-Attribut (Teil des Display-Elements)

Optional. Der Standardwert ist FALSE , wenn nicht angegeben.

Wenn AcceptEULA auf TRUE festgelegt ist, wird dem Benutzer kein Dialogfeld Microsoft-Software-Lizenzbedingungen angezeigt. Wenn dieses Attribut auf FALSE festgelegt ist oder nicht enthalten ist, könnte dem Benutzer das Dialogfeld Microsoft-Software-Lizenzbedingungen angezeigt werden. Es wird empfohlen, dass Administratoren AcceptEULA auf TRUE festlegen.

Zulässige Werte:

  • AcceptEULA="TRUE"
  • AcceptEULA="FALSE"

ExcludeApp-Element

Definiert, welche Microsoft 365 Apps Produkte nicht installiert werden sollen. OneDrive wird automatisch mit Microsoft 365 Apps oder mit einzelnen Anwendungen wie Word, Excel, PowerPoint, Publisher, Visio oder Skype installiert. Wenn OneDrive nicht mit diesen Anwendungen installiert werden soll, verwenden Sie das ExcludeApp-Element, um es zu entfernen. Weitere Informationen finden Sie unter Ausschließen von OneDrive bei der Installation von Microsoft 365 Apps oder anderen Anwendungen.

Beispiel

<Add SourcePath="\\Server\Share" 
     OfficeClientEdition="64"
     Channel="MonthlyEnterprise">
  <Product ID="O365ProPlusRetail">
    <Language ID="en-us" />
    <Language ID="ja-jp" />
    <ExcludeApp ID="Publisher" />
  </Product>
</Add>

Wenn eine Konfigurationsdatei mit ExcludeApp verwendet wird, um Office auf einem Gerät zu installieren, auf dem bereits Microsoft 365 Apps installiert ist, wird die Einstellung ExcludeApp basierend auf der Liste der Sprachen unterschiedlich behandelt:

  • Wenn die Konfigurationsdatei alle Sprachen auflistet, die bereits auf dem Gerät installiert sind, setzt die ExcludeApp-Einstellung alle vorherigen ExcludeApp-Einstellungen außer Kraft. Dies gilt auch, wenn die Sprachliste der Datei sowohl die installierten Sprachen als auch zusätzliche Sprachen enthält.
  • Wenn die Liste der Sprachen in der Konfigurationsdatei nicht alle installierten Sprachen enthält, wird die Einstellung ExcludeApp in der Konfigurationsdatei mit der ExcludeApp-Einstellung auf dem Gerät kombiniert.

ID-Attribut (Teil des ExcludeApp-Elements)

Erforderlich.

Definiert die ID des Produkts, das nicht installiert werden soll.

Zulässige Werte:

  • ID="Access"
  • ID="Bing"
  • ID="Excel"
  • ID="Groove"
  • ID="Lync"
  • ID="OneDrive"
  • ID="OneNote"
  • ID="Outlook"
  • ID="OutlookForWindows"
  • ID="PowerPoint"
  • ID="Publisher"
  • ID="Teams"
  • ID="Word"

Hinweis

Property-Element

Definiert bestimmte Microsoft 365 Apps Verhalten und Eigenschaften.

Beispiel

<Property Name="FORCEAPPSHUTDOWN" Value="FALSE"/>
<Property Name="SharedComputerLicensing" Value="1"/>
<Property Name="SCLCacheOverride" Value="1" />
<Property Name="DeviceBasedLicensing" Value="1" />
<Property Name="SCLCacheOverrideDirectory" Value="\\server\share\%username%" />
<Property Name="PinIconsToTaskbar" Value="TRUE"/>

Name-Attribut (Teil des Property-Elements)

Erforderlich.

Definiert die bestimmte Eigenschaft, deren Wert Sie festlegen möchten.

Value-Attribut (Teil des Property-Elements)

Definiert den Wert der benannten Eigenschaft.

AUTOACTIVATE-Eigenschaft (Teil des Property-Elements)

Optional. Der Standardwert ist 0 , wenn nicht angegeben.

Da Microsoft 365 Apps auf die automatische Aktivierung festgelegt ist, sollten Sie diese Eigenschaft nicht für Microsoft 365 Apps Produkte festlegen. Für andere Produkte können Sie AUTOACTIVATE auf 1 festlegen, damit das Produkt automatisch aktiviert wird.

Zulässige Werte:

  • Property Name="AUTOACTIVATE" Value="0"
  • Property Name="AUTOACTIVATE" Value="1"

FORCEAPPSHUTDOWN-Eigenschaft (Teil des Property-Elements)

Optional. Der Standardwert ist FALSE , wenn nicht angegeben.

Wenn diese Einstellung auf TRUE festgelegt ist, wird das Herunterfahren aller Apps erzwungen, die die Installation von Microsoft 365 Apps blockieren. Es kann zu Datenverlusten kommen.

Zulässige Werte:

  • Property Name="FORCEAPPSHUTDOWN" Value="FALSE"
  • Property Name="FORCEAPPSHUTDOWN" Value="TRUE"

PACKAGEGUID-Eigenschaft (Teil des Property-Elements)

Optional.

Standardmäßig verwenden App-V-Pakete, die vom ODT erstellt wurden, dieselbe App-V-Paket-ID. Administratoren können PACKAGEGUID zur Angabe einer anderen Paket-ID verwenden. Damit können Sie mehrere App-V-Pakete mit Microsoft 365 Apps auf einem App-V-Verwaltungsserver veröffentlichen. Sie können jedoch nicht mehr als ein Microsoft 365 Apps App-V-Paket auf einem einzelnen Computer bereitstellen. Sie können das ODT verwenden, um App-V-Pakete für Microsoft 365 Apps zu erstellen. Das Erstellen von Paketen für die volumenlizenzierten Versionen von Office Professional Plus oder Office Standard wird nicht unterstützt.

Die Paket-ID muss dem Format aus dem Beispiel entsprechen und kann nur die folgenden Zeichen enthalten: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F

Wenn Sie andere Zeichen verwenden, wird das App-V-Paket mit der standardmäßigen Paket-ID erstellt.

Beispielwerte:

  • Property Name="PACKAGEGUID" Value="12345678-ABCD-1234-ABCD-1234567890AB"

SharedComputerLicensing-Eigenschaft (Teil des Property-Elements)

Optional. Der Standardwert ist 0 , wenn er nicht angegeben ist.

Legen Sie SharedComputerLicensing auf 1 fest, wenn Sie Microsoft 365 Apps mithilfe von Remotedesktopdiensten auf gemeinsam genutzten Computern bereitstellen.

Weitere Informationen finden Sie unter Überblick über die Aktivierung gemeinsam genutzter Computer für Microsoft 365 Apps.

Zulässige Werte:

  • Property Name="SharedComputerLicensing" Value="0"
  • Property Name="SharedComputerLicensing" Value="1"

SCLCacheOverride-Eigenschaft (Teil des Property-Elements)

Optional. Der Standardwert ist 0 , wenn er nicht angegeben ist.

Legen Sie SCLCacheOverride auf 1 fest, wenn Sie die Aktivierung gemeinsam genutzter Computer verwenden und das Lizenzierungstoken roamingn möchten. Verwenden Sie diese Eigenschaft mit SCLCacheOverrideDirectory. Diese Eigenschaft ist nur erforderlich, wenn Sie das Lizenzierungstoken vom Standardspeicherort verschieben möchten. Weitere Informationen finden Sie unter Überblick über die Aktivierung gemeinsam genutzter Computer für Microsoft 365 Apps.

Zulässige Werte:

  • Property Name="SCLCacheOverride" Value="0"
  • Property Name="SCLCacheOverride" Value="1"

SCLCacheOverrideDirectory-Eigenschaft (Teil des Property-Elements)

Optional.

Legen Sie SCLCacheOverrideDirectory fest, um einen Ordnerspeicherort für das Lizenzierungstoken anzugeben, wenn Sie die Aktivierung gemeinsam genutzter Computer verwenden und das Lizenzierungstoken roamingn möchten. Verwenden Sie die -Eigenschaft mit SCLCacheOverride. Diese Eigenschaft ist nur erforderlich, wenn Sie das Lizenzierungstoken vom Standardspeicherort verschieben möchten.

Weitere Informationen finden Sie unter Überblick über die Aktivierung gemeinsam genutzter Computer für Microsoft 365 Apps.

Beispielwerte:

  • Property Name="SCLCacheOverrideDirectory" Value="%appdata%\Microsoft"
  • Property Name="SCLCacheOverrideDirectory" Value="\\server\share\%username%"

DeviceBasedLicensing-Eigenschaft (Teil des Property-Elements)

Optional. Der Standardwert ist 0 , wenn er nicht angegeben ist.

Definiert den Office-Lizenzierungsmodus für die gerätebasierte Aktivierung. Weitere Informationen finden Sie unter Gerätebasierte Lizenzierung für Microsoft 365 Apps for Enterprise.

Zulässige Werte:

  • Property Name="DeviceBasedLicensing" Value="1"
  • Property Name="DeviceBasedLicensing" Value="0"

PinIconsToTaskBar-Eigenschaft (Teil des Property-Elements)

Optional. Der Standardwert ist True , wenn er nicht angegeben wird.

Definiert, ob Verknüpfungssymbole für Microsoft 365 Apps Produkte der Windows-Taskleiste in Windows 7 und Windows 8.1 hinzugefügt werden. Wenn Sie Microsoft 365 Apps mithilfe eines Systemkontos installieren, was bei der Bereitstellung mit Microsoft Configuration Manager üblich ist, werden die Symbole auch dann nicht angeheftet, wenn diese Eigenschaft auf True festgelegt ist.

Zulässige Werte:

  • Property Name="PinIconsToTaskbar" Value="FALSE"
  • Property Name="PinIconsToTaskbar" Value="TRUE"

Hinweis

Remove-Element

Definiert, welche Produkte und Sprachen aus einer vorherigen Installation von Microsoft 365 Apps entfernt werden sollen. Um eine installierte Sprache zu entfernen, müssen Sie sowohl das Produkt als auch die Sprache wie im Beispiel angeben. Um alle installierten Sprachen zu entfernen, schließen Sie nicht das Sprachsattribut ein. In diesem Fall erkennt und entfernt das ODT automatisch alle installierten Sprachen für das Produkt.

Weitere Informationen finden Sie unter Übersicht über das Office-Bereitstellungstool.

Beispiel

<Remove All="FALSE">
  <Product ID="O365ProPlusRetail" >
    <Language ID="es-es" />
  </Product>
</Remove>

All-Attribut (Teil des Remove-Elements)

Optional. Der Standardwert ist FALSE , wenn er nicht angegeben ist.

Bei Festlegung auf TRUE werden alle Microsoft 365 Apps Produkte und Sprachen entfernt, einschließlich Project und Visio.

Zulässige Werte:

  • All="FALSE"
  • All="TRUE"

Updates-Element

Definiert, wie Microsoft 365 Apps nach der Installation aktualisiert wird.

Beispiel

<Updates Enabled="TRUE" 
         UpdatePath="\\Server\Share\"
         Channel="SemiAnnual" />

Enabled-Attribut (Teil des Updates-Elements)

Optional. Der Standardwert ist TRUE , wenn er nicht angegeben wird.

Wenn dieser Wert auf TRUE festgelegt ist, sucht Microsoft 365 Apps nach Updates. Wenn dieser Wert auf FALSE festgelegt ist, sucht Microsoft 365 Apps nicht nach Updates, aber der Benutzer kann nach Updates suchen, indem er zuDateikonto-Updateoptionen>>>Jetzt aktualisieren wechselt.

Zulässige Werte:

  • Enabled="TRUE"
  • Enabled="FALSE"

UpdatePath-Attribut (Teil des Updates-Elements)

Optional. Wenn nicht angegeben, wird standardmäßig das CDN verwendet.

Definiert, woher die Updates für Microsoft 365 Apps stammen. UpdatePath kann einen Netzwerk-, lokalen oder HTTP-Pfad einer Quelle für Installationsdateien angeben. Für Netzwerkpfade oder lokale Pfade können Umgebungsvariablen verwendet werden.

If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set UpdatePath by using the Update Path policy setting. You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Beispielwerte:

  • UpdatePath="\\server\share"
  • UpdatePath="C:\Preload\Office"
  • UpdatePath="http://internalApps/Office/"

TargetVersion-Attribut (Teil des Updates-Elements)

Optional. Standardmäßig wird die neueste Version aus dem angegebenen Updatepfad verwendet.

Definiert, auf welche Version Microsoft 365 Apps Updates aktualisiert wird. Wenn TargetVersion auf eine bestimmte Buildnummer festgelegt ist, versucht Microsoft 365 Apps, auf diese Version zu aktualisieren.

If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set TargetVersion by using the Target Version policy setting. You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Beispielwerte:

  • TargetVersion="16.0.12345.12345"
  • TargetVersion=""

Deadline-Attribut (Teil des Updates-Elements)

Optional.

Definiert einen Stichtag, bis zu dem Updates übernommen werden müssen. Der Stichtag wird in koordinierter Weltzeit (Coordinated Universal Time, UTC) angegeben. Sie können Deadline mit Zielversion verwenden, um sicherzustellen, dass Microsoft 365 Apps bis zu einem bestimmten Datum auf eine bestimmte Version aktualisiert wird. Es wird empfohlen, den Stichtag mindestens eine Woche im Voraus festzulegen, damit allen Benutzern genügend Zeit zum Installieren der Updates bleibt.

Vor dem Stichtag erhalten Benutzer mehrere Erinnerungen zur Installation der Updates. Wenn Microsoft 365 Apps nicht bis zum Stichtag aktualisiert wird, wird benutzern eine Benachrichtigung angezeigt, dass die Updates in 15 Minuten angewendet werden. Diese Benachrichtigung gibt Benutzern die Möglichkeit, die Dokumente, an denen sie gerade arbeiten, zu speichern und alle geöffneten Microsoft 365-Anwendungen zu schließen. Wenn Benutzer die Microsoft 365-Anwendungen nicht schließen, werden die Anwendungen nach Ablauf der 15 Minuten automatisch geschlossen, was zu Datenverlusten führen kann.

Nachdem Microsoft 365 Apps geschlossen wurde, werden die Updates automatisch angewendet. Der Stichtag bezieht sich nur auf eine Updategruppe. Wenn Sie einen Stichtag verwenden möchten, um sicherzustellen, dass Microsoft 365 Apps immer auf dem neuesten Stand ist, müssen Sie den Stichtag jedes Mal ändern, wenn ein neues Update verfügbar ist.

To use this attribute, Office must be running at least Service Pack 1 (version 15.0.4569.1507). If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set Deadline by using the Update Deadline policy setting. You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates.

Beispielwert:

  • Deadline="05/16/2014 18:30"

Channel-Attribut (Teil des Updates-Elements)

Optional. Der Standardwert ist Aktuell.

Definiert, welcher Kanal zum Aktualisieren von Microsoft 365 Apps nach der Installation verwendet werden soll. Es gibt zwei Kanalattribute: Der Kanal für das Add-Element wird verwendet, um einen Updatekanal bei der Installation von Microsoft 365 Apps anzugeben, und der Kanal für das Updates-Element wird verwendet, um den Kanal für eine vorhandene Installation von Microsoft 365 Apps zu ändern.

Weitere Informationen zu Updatekanälen finden Sie unter Übersicht über die Updatekanäle für Microsoft 365 Apps.

Wenn Sie Gruppenrichtlinie mit den administrativen Vorlagendateien (ADMX/ADML) für Office verwenden, können Sie Kanal mithilfe der Richtlinieneinstellung Kanal aktualisieren festlegen. You can find this policy setting under Computer Configuration\Policies\Administrative Templates\Microsoft Office 2016 (Machine)\Updates. If enabled, this Group Policy setting takes precedence over the Channel value set by using the Office Deployment Tool.

Zulässige Werte:

  • Channel="BetaChannel"
  • Channel="CurrentPreview"
  • Channel="Current"
  • Channel="MonthlyEnterprise"
  • Channel="Semi AnnualPreview"
  • Channel="Semi Annual"

Hinweis

  • Um diese Attributwerte verwenden zu können, müssen Sie mindestens Version 16.0.12827.20268 des Office-Bereitstellungstools verwenden, das am Dienstag, den 9. Juni 2020 veröffentlicht wurde.
  • Frühere zulässige Werte für jeden Updatekanal können weiterhin verwendet werden, was bedeutet, dass Sie Ihre älteren XML-Konfigurationsdateien nicht aktualisieren müssen.
  • Beta-Kanal (manchmal auch als Insider Fast bezeichnet) ist kein unterstützter Build und sollte daher nur in Testumgebungen und von einer kleinen Gruppe ausgewählter Benutzer wie IT-Mitarbeitern oder Anwendungsentwicklern verwendet werden.

Wenn Sie Office LTSC Professional Plus 2021 oder Office LTSC Standard 2021 bereitstellen, bei denen es sich um Volumenlizenzversionen handelt, müssen Sie diesen Updatekanal verwenden: PerpetualVL2021. Weitere Informationen finden Sie unter Updatekanal für Office LTSC 2021.

Wenn Sie Office Professional Plus 2019 oder Office Standard 2019 bereitstellen, bei denen es sich um Volumenlizenzversionen von Office handelt, gibt es einen anderen Updatekanal, den Sie verwenden müssen: PerpetualVL2019. Weitere Informationen finden Sie unter Updatekanal für Office 2019.

RemoveMSI-Element

Optional.

Gibt an, ob versionen 2007, 2010, 2013 oder 2016 von Office, Visio und Project, die mit Windows Installer (MSI) installiert wurden, vor der Installation des angegebenen Produkts vom Computer deinstalliert werden, z. B. Microsoft 365 Apps.

Es wird empfohlen, vor der Installation von Microsoft 365 Apps alle früheren Versionen von Office zu deinstallieren. Weitere Informationen zur Verwendung von RemoveMSI finden Sie unter Entfernen vorhandener MSI-Versionen von Office beim Upgrade auf Microsoft 365 Apps.

IgnoreProduct-Attribut (Teil des RemoveMSI-Elements)

Optional.

Wenn eine ID angegeben wird, wird dieses Windows Installer-Produkt (MSI) nicht auf dem Computer deinstalliert.

Beispielwerte:

  • IgnoreProduct ID="VisPro"
  • IgnoreProduct ID="PrjPro"

AppSettings-Element

Optional.

Definiert Anwendungseinstellungen für Microsoft 365 Apps, einschließlich VBA-Makrobenachrichtigungen, Standarddateispeicherorten und Standarddateiformat. Um eine Konfigurationsdatei mit Anwendungseinstellungen zu erstellen, empfiehlt es sich, die Office-Anpassungstool für Klick-und-Los zu verwenden, eine Webanwendung mit einer vollständigen Benutzeroberfläche. Sie können das Tool auch verwenden, um mehr über die verfügbaren Anwendungseinstellungen zu erfahren.

Weitere Informationen zu Anwendungseinstellungen finden Sie unter Anwenden von Anwendungseinstellungen und Anwenden von Anwendungseinstellungen auf eine vorhandene Installation von Office.

Beispiel

  <AppSettings>
    <User Key="software\microsoft\office\16.0\excel\security"
          Name="vbawarnings" 
          Value="3" 
          Type="REG_DWORD" 
          App="excel16" 
          Id="L_VBAWarningsPolicy" />
  </AppSettings>