Параметры конфигурации для средства развертывания Office

With the Office Deployment Tool (ODT), you can download and deploy Microsoft 365 Apps to your client computers. The ODT gives you more control over an Office installation: you can define which products and languages are installed, how those products should be updated, and whether or not to display the install experience to your users. This article covers all the available options in the tool. To learn how to use the tool itself, see Overview of the Office Deployment Tool.

Примечание

Best practice: The options in this article show the XML elements and attributes in the configuration file. You can continue to create the configuration file in a text editor, but we recommend using the Office Customization Tool instead. With the Office Customization Tool, you can easily create and modify configuration files in a web-based interface. For more information, see Overview of the Office Customization Tool.

Пример стандартного файла конфигурации

ODT состоит из двух файлов: setup.exe и configuration.xml. Для работы со средством измените файл конфигурации, чтобы определить нужные параметры, а затем выполните setup.exe из командной строки. Например, вы можете изменить файл конфигурации, чтобы скачать 64-разрядную версию Office на английском языке, или изменить файл, чтобы установить 64-разрядную версию Office на английском языке с автоматически принятым соглашением лицензионного соглашения и без Publisher.

When creating the configuration file, we recommend starting with an example file and updating it with the appropriate options for your environment. You can start by copying and pasting the example below into a text file and saving it with a name of your choosing. Use the file to modify the XML elements and attributes and use the rest of this article to learn more details about each of the elements and attributes.

Этот файл конфигурации включает наиболее популярные элементы и атрибуты. С его помощью можно скачать и установить Office на клиентский компьютер.

<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>
Значение Описание
Add SourcePath="\\Server\Share"
Набор Office будет скачан в сетевую папку "\server\share", после чего будет выполнено его развертывание с помощью расположенных там установочных файлов.
Добавление OfficeClientEdition="64"
Скачивает и устанавливает 64-разрядный выпуск Office
Add Channel="MonthlyEnterprise"
Office будет установлен с помощью Monthly Enterprise Channel.
Product ID="O365ProPlusRetail"
Скачивает и устанавливает Приложения Microsoft 365 для предприятий.
Language ID="en-us"
Language ID="ja-jp"
Скачивает и устанавливает английскую и японскую версии Office.
Updates Enabled="TRUE"
Office будет проверять наличие обновлений.
Updates UpdatePath="\\Server\Share"
Office проверяет наличие обновлений в сетевой папке "\server\share".
Display Level="None" AcceptEULA="TRUE"
При установке Office пользовательский интерфейс не отображается.

Примечание

Элемент Logging больше не поддерживается в качестве параметра конфигурации для средства развертывания Office. Файлы журнала можно найти в папке пользователя %temp%, а также в папке C:\Windows\Temp.

Элемент Add

Определяет продукты и языки, которые необходимо скачать или установить.

Пример

<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 (часть элемента Add)

Необязательно.

Defines the location of the Office installation files. If the ODT is run in download mode, defines where to save the files. If not included, the ODT will look for installation files in the same folder as the tool, and then use the Office Content Delivery Network (CDN). If not included and the ODT is run in download mode, the Office installation files are downloaded to the same folder as the tool.

When you download Office to a folder that already contains that version of Office, the ODT will conserve your network bandwidth by downloading only the missing files. For example, if you use the ODT to download Office in English and German to a folder that already contains Office in English, only the German language pack will be downloaded.

Примеры значений:

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

Значение SourcePath не должно включать часть /Office или имя папки, в которую были загружены данные Office.

Атрибут Version (часть элемента Add)

Optional. Defaults to the latest version available if not specified.

When you use the Version attribute, we recommend including the Channel attribute as well. If you don't include the Channel attribute, the default channel will be used, which might not match the specified version.

If Microsoft 365 Apps is already installed on a device, you can use Version="MatchInstalled" to install the same version of Office, even if a newer version is available. This setting can make it easier to add language packs or Visio and Project without updating Office to a newer version.

Примеры значений:

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

Атрибут OfficeClientEdition (часть элемента Add)

Необязательно.

Определяет, какой выпуск Приложений Microsoft 365 скачивается или устанавливается: 32- или 64-разрядный. Если office не установлен на устройстве и officeClientEdition не указан, odt по умолчанию будет использовать 64-разрядную версию, если устройство не работает под управлением 32-разрядной версии Windows или имеет менее 4 ГБ ОЗУ. Если Office установлен, а атрибут OfficeClientEdition не указан, средство развертывания Office применит такую же архитектуру, как в существующем экземпляре Office. Если Office установлен и указан атрибут OfficeClientEdition, он должен соответствовать уже установленной архитектуре. В противном случае установка завершится сбоем, так как смешанные архитектуры не поддерживаются.

Допустимые значения:

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

Атрибут Channel (часть элемента Add)

Необязательно.

Определяет используемый канал для установки Office. Если office не установлен на устройстве, параметр по умолчанию для атрибута Channel — Current. Если office установлен на устройстве и атрибут channel не указан, ODT будет соответствовать каналу существующей установки.

Это значение определяет, какой канал будет установлен, независимо от того, какой канал обновления указан (необязательно) в разделе Элемент обновления или с помощью параметра групповой политики. При наличии такого параметра с другим каналом обновления переключение канала выполняется после установки во время следующего цикла обновления. Дополнительные сведения см. в статье Изменение канала обновления Приложений Microsoft 365.

Дополнительную информацию о каналах обновления см. в статье Обзор каналов обновления для Приложений Microsoft 365.

Допустимые значения:

  • Channel="BetaChannel"
  • Channel="CurrentPreview"
  • Channel="Current"
  • Channel="MonthlyEnterprise"
  • Channel="SemiAnnualPreview"
  • Channel="SemiAnnual"

Примечание

  • Чтобы применять эти значения атрибутов, вы должны использовать средство развертывания Office не ниже версии 16.0.12827.20268, выпущенной в четверг 9 июня 2020 г.
  • Можно по-прежнему использовать ранее разрешенные значения для каждого канала обновления. Это означает, что вам не нужно обновлять старые XML-файлы конфигурации.
  • Но сборка бета-канала (иногда называемого "Предварительная оценка — ранний доступ") не поддерживается, поэтому ее следует использовать только в тестовых средах и в небольших группах выбранных пользователей, например для ИТ-специалистов или разработчиков приложений.

Если вы развертываете Office LTSC профессиональный плюс 2021 или Office LTSC стандартный 2021, которые являются версиями Office с корпоративной лицензией, необходимо использовать другой канал обновления: PerpetualVL2021. Дополнительные сведения см. в разделе Канал обновления для Office LTSC 2021.

Если вы развертываете Office профессиональный плюс 2019 или Office стандартный 2019, которые являются версиями Office с корпоративной лицензией, необходимо использовать другой канал обновления: PerpetualVL2019. Для получения дополнительных сведений см. Канал обновления для Office 2019.

Атрибут DownloadPath (часть элемента Add)

Optional. Defaults to the CDN if not specified.

Defines where the installation files are downloaded from when running ODT in download mode. Most commonly used to distribute specific languages and products for Office from a central location on your network to another location. Note that you must specify a version when using DownloadPath, as shown in the example.

Примеры значений:

  • DownloadPath="\\servera\share"

Пример

<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 (часть элемента Add)

Optional. Defaults to False if not specified.

Чтобы использовать сеть CDN Office как источник резервного копирования для языковых пакетов, добавьте атрибут AllowCdnFallback в файл конфигурации, как показано в примере.

When installing languages, the ODT looks first for source files in the location specified in the SourcePath attribute. If the language pack isn't available at that location and the AllowCdnFallback setting is set to True, then the ODT will use source files from the Office CDN.

Допустимые значения:

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

Пример

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

Атрибут MigrateArch (часть элемента Add)

Optional. Defaults to False if not specified.

If set to TRUE, then your existing installation of Microsoft 365 Apps will be changed to the architecture (sometimes referred to as the bitness) that is specified in the OfficeClientEdition attribute. For example, you can use this to change a 32-bit installation of Microsoft 365 Apps to a 64-bit installation.

Дополнительные сведения об использовании MigrateArch см. в статье Изменение установки Приложений Microsoft 365 с 32- на 64-разрядную.

Атрибут OfficeMgmtCOM (часть элемента Add)

Необязательно. Если не указано, по умолчанию используется значение False.

Если задано значение True, объект COM регистрируется, что необходимо для разрешения решениям по управлению обновлениями (например, Microsoft Configuration Manager) для управления обновлениями Office. Требуется при использовании Configuration Manager для обновлений Приложения Microsoft 365. Если COM-объект Office включен, параметр "Обновить" на странице учетной записи для Приложений Microsoft 365 автоматически отключается для клиентских устройств.

Дополнительные сведения см. в статье Управление обновлениями для Приложения Microsoft 365 с помощью Microsoft Configuration Manager.

Допустимые значения:

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

Пример

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

Элемент Product

Defines which products to download or install. If you define multiple products, the products are installed in the order in the configuration file. The first product determines the context for the Microsoft Office First Run Experience.

You can also use the Product element to add language packs to existing installations of Microsoft 365 Apps. For more information, including an example configuration file, see Deploy languages to existing installations of Microsoft 365 Apps.

Пример

<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 (часть элемента Product)

Обязательный.

Определяет код продукта, который необходимо скачать или установить.

Примеры значений:

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

Список всех поддерживаемых кодов продуктов см. в статье Коды продуктов, поддерживаемые средством развертывания Office для версии "нажми и работай".

Атрибут MSICondition (часть элемента Product)

Необязательно.

Allows you to control the installation of an Office product, as specified by the ID attribute, based on whether a particular MSI-based Office product is already installed on the device. For example, if an MSI-based version of Project Professional is already installed on the device, then install Project Online Desktop Client.

You can specify any Office product that was installed by Windows Installer (MSI), but MSICondition is most commonly used for Project or Visio installations. The value that you specify for the MSICondition attribute can be either a volume licensed or a retail version of the product, as long as that version of the product was installed by using MSI.

MSICondition will recognize 2007, 2010, 2013, and 2016 versions of the Office product that you specify. But, you can't specify a particular version. For example, you can't have MSICondition look specifically for Visio Standard 2013. MSICondition will look for all MSI-based installations of Visio Standard, including Visio Standard 2007, Visio Standard 2010, Visio Standard 2013, and Visio Standard 2016.

The value that you specify for the MSICondition attribute is the Setup ID that is found in the Setup.xml file in the {product}.WW folder of the installation files for your existing version of the Office product. For example, the Setup.xml file for Visio Professional 2016 is found in the VisPro.WW folder. You can specify multiple types of an Office product, separated by a comma. For example, you can specify "PrjStd,PrjStdR,PrjPro,PrjProR" to look for installations of Project Standard or Project Professional, either volume licensed or retail.

Примечание

  • We recommend that you remove the existing MSI-based Office products as part of installing the products specified in your XML file. To remove existing MSI-based products, use the RemoveMSI element.

Пример атрибута MSICondition

In the following example, Project Online Desktop Client will be installed on the device only if an MSI-based version of Project Standard is already installed on the device. Also, Project Standard will be removed from the device as part of the installation of Project Online Desktop Client.

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

Элемент Language

Defines which languages to download or install. If you define multiple languages, the first language in the configuration file determines the Shell UI culture, including shortcuts, right-click context menus, and tooltips. If you decide that you want to change the Shell UI language after an initial installation, you have to uninstall and reinstall Office.

Пример

<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 (часть элемента Language)

Обязательный.

Определяет код языка, который необходимо скачать или установить.

Примеры значений

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

Список всех языков см. в статье Языки и региональные параметры, а также дополнительные языки проверки правописания.

Дополнительные сведения о MatchPreviousMSI см. в статье Удаление существующих MSI-версий Office при обновлении до приложений Microsoft 365.

MatchOS и MatchInstalled не могут установить языки операционной системы, если Office не поддерживает этот язык или если ODT не может найти правильный языковой пакет в локальных исходных файлах. Чтобы решить эту проблему, рекомендуем указать резервный языковой пакет и разрешить ODT использовать CDN Office для поиска отсутствующих файлов. Для этого задайте атрибуты Fallback и AllowCdnFallBack.

MatchInstalled can be used only if there is at least one Click-to-Run product already installed. It can't be used with the /download switch for the ODT. For more information about MatchInstalled, see Overview of deploying languages and Build dynamic, lean, and universal packages for Microsoft 365 Apps.

Атрибут Fallback (часть элемента Language)

Необязательно.

When using MatchOS, we recommend that you specify a fallback language to install when a matched language isn't supported by Office or can't be found in the local source files. To do so, use the "Fallback" attribute. For more information, see Install the same languages as the operating system.

Примеры значений:

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

Атрибут TargetProduct (часть элемента Language)

Необязательно.

When using MatchInstalled, you can specify if you want to match the list of already installed languages for a specific product or the combination of all installed products. To target a specific product, you can specify any supported product ID. If you want to match the languages of all already installed products, you specify "All". ODT will then install the new product with the same set of languages as the one specified in TargetProduct.

Если targetProduct не указан с параметром MatchInstalled, ODT попытается сопоставить тот же идентификатор продукта, к которому принадлежит тег Language в файле конфигурации. Например, если вы используете MatchInstalled при установке VisioProRetail без targetProduct, ODT попытается сопоставить уже установленные языки для этого продукта.

Примеры значений:

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

Элемент Display

Определяет, что видит пользователь во время установки Office.

Пример

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

Атрибут Level (часть элемента Display)

Optional. Default is set to Full if not specified.

Если для атрибута Level задано значение None, Office устанавливается без индикаторов выполнения, экранов завершения, сообщений об ошибках и других элементов пользовательского интерфейса.

Если для атрибута Level задано значение Full, Office устанавливается как обычно.

Допустимые значения:

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

Атрибут AcceptEULA (часть элемента Display)

Необязательно. Если не указано, по умолчанию используется значение FALSE.

Если параметр AcceptEULA имеет значение TRUE, пользователь не увидит диалоговое окно Условия лицензионного соглашения на использование программного обеспечения Майкрософт. Если для этого атрибута задано значение FALSE или он не включен, пользователь может увидеть диалоговое окно Условия лицензионного соглашения на использование программного обеспечения Майкрософт. Администраторам рекомендуется задать для атрибута AcceptEULA значение TRUE.

Допустимые значения:

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

Примечание

При развертывании версии Office до версии 1803 этот параметр будет применяться только при установке с учетной записью пользователя. Microsoft Configuration Manager и другие средства распространения программного обеспечения, использующие учетную запись SYSTEM для установки, не будут применять этот параметр.

Элемент ExcludeApp

Определяет, какие продукты Приложения Microsoft 365 не следует устанавливать. OneDrive автоматически устанавливается при установке Приложений Microsoft 365 или отдельных приложений, таких как Word, Excel, PowerPoint, Publisher, Visio или Skype. Если вы не хотите, чтобы OneDrive устанавливался с этими приложениями, используйте элемент ExcludeApp, чтобы удалить его. Дополнительные сведения см. в разделе Исключение OneDrive при установке Приложений Microsoft 365 или других приложений.

Пример

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

Если для установки Office на устройстве, уже содержащем экземпляр Приложений Microsoft 365, используется файл конфигурации с параметром ExcludeApp, параметр ExcludeApp будет обрабатываться по-разному в зависимости от списка языков:

  • If the list of languages in the configuration file includes all the installed languages, then the ExcludeApp setting in the file replaces any existing ExcludeApp setting on the device. This is also true if the list of languages in the configuration file includes both all the installed languages and additional languages.
  • Если список языков в файле конфигурации не содержит все установленные языки, параметр ExcludeApp из файла конфигурации объединяется с параметром ExcludeApp на устройстве.

Атрибут ID (часть элемента ExcludeApp)

Обязательный.

Определяет идентификатор продукта, который не следует устанавливать.

Допустимые значения:

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

For OneDrive for Business, use Groove. For Skype for Business, use Lync.

Дополнительные сведения о Microsoft Teams см. в статье Развертывание Microsoft Teams с помощью Приложений Microsoft 365.

Элемент Property

Определяет некоторые действия и свойства Office.

Пример

<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 (часть элемента Property)

Обязательный.

Определяет свойство, значение которого требуется задать.

Атрибут Value (часть элемента Property)

Определяет значение указанного свойства.

Свойство AUTOACTIVATE (часть элемента Property)

Необязательно. Если не указано, по умолчанию используется значение 0.

Так как Приложения Microsoft 365 настроен для автоматической активации, это свойство не следует задавать для Приложения Microsoft 365 продуктов. Для автоматической активации других продуктов присвойте свойству AUTOACTIVATE значение 1.

Допустимые значения:

  • Имя свойства="AUTOACTIVATE" Значение="0"
  • Имя свойства="AUTOACTIVATE" Значение="1"

Свойство FORCEAPPSHUTDOWN (часть элемента Property)

Optional. Default is FALSE if not specified.

When set to TRUE, forces any apps that are blocking the install of Office to shut down. Data loss may occur.

Допустимые значения:

  • Имя свойства="FORCEAPPSHUTDOWN" Значение="FALSE"
  • Имя свойства="FORCEAPPSHUTDOWN" Значение="TRUE"

Свойство PACKAGEGUID (часть элемента Property)

Необязательно.

По умолчанию все пакеты App-V, созданные с помощью ODT, имеют одинаковый код. С помощью PACKAGEGUID администраторы могут указать другой код пакета. Это позволяет публиковать несколько пакетов App-V с Office на сервере управления App-V, но не дает возможности развертывать более одного пакета App-V с Office на компьютере. С помощью средства развертывания Office можно создавать пакеты App-V для Приложений Microsoft 365. Создание пакетов для корпоративных лицензируемых версий Office профессиональный плюс или Office стандартный не поддерживается.

Идентификатор пакета должен соответствовать формату примера и содержать только следующие символы: 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, A, B, C, D, E, F

При использовании других символов пакет App-V будет создан с идентификатором по умолчанию.

Примеры значений:

  • Имя свойства="PACKAGEGUID" Значение="12345678-ABCD-1234-ABCD-1234567890AB"

Свойство SharedComputerLicensing (часть элемента Property)

Optional. Default value is 0 if not specified.

Если вы развертываете Приложения Microsoft 365 на общих компьютерах, используя службу удаленных рабочих столов, установите для свойства SharedComputerLicensing значение 1.

Дополнительные сведения см. в статье Обзор активации на общем компьютере для Приложений Microsoft 365.

Допустимые значения:

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

Свойство SCLCacheOverride (часть элемента Property)

Optional. Default value is 0 if not specified.

Set SCLCacheOverride to 1 if you're using shared computer activation and you want to roam the licensing token. Use in conjunction with SCLCacheOverrideDirectory. This is only needed if you choose to move the licensing token from its default location. For more information, see Overview of shared computer activation for Microsoft 365 Apps.

Допустимые значения:

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

Свойство SCLCacheOverrideDirectory (часть элемента Property)

Необязательно.

Set SCLCacheOverrideDirectory to specify a folder location for the licensing token if you're using shared computer activation and you want to roam the licensing token. Use in conjunction with SCLCacheOverride. This is only needed if you choose to move the licensing token from its default location.

Дополнительные сведения см. в статье Обзор активации на общем компьютере для приложений Microsoft 365.

Примеры значений:

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

Свойство DeviceBasedLicensing (часть элемента свойства)

Optional. Default value is 0 if not specified.

Defines the Office licensing mode for device-based activation. For more information, see Device-based licensing for Microsoft 365 Apps for enterprise.

Допустимые значения:

  • Имя свойства="DeviceBasedLicensing" Значение="1"
  • Имя свойства="DeviceBasedLicensing" Значение="0"

Свойство PinIconsToTaskBar (часть элемента Property)

Необязательно. Если не указано, по умолчанию используется значение True.

Определяет, добавляются ли на панель задач Windows 7 и 8.1 значки продуктов Office. При установке Office с помощью системной учетной записи, что часто встречается при развертывании с помощью Microsoft Configuration Manager, значки не будут закреплены, даже если для этого свойства задано значение True.

Допустимые значения:

  • Имя свойства="PinIconsToTaskbar" Значение="FALSE"
  • Имя свойства="PinIconsToTaskbar" Значение="TRUE"

Примечание

Microsoft 365 Apps is no longer supported on Windows 7. For more information, see Windows 7 end of support and Microsoft 365 Apps.

Элемент Remove

Определяет, какие продукты и языки необходимо удалить из предыдущей установки Приложений Microsoft 365. Чтобы удалить установленный язык, укажите и продукт, и язык, как в примере. Чтобы удалить все установленные языки, не включайте атрибут языка. В этом случае средство развертывания Office автоматически обнаруживает и удаляет все установленные языки продукта.

Дополнительные сведения см. в статье Общие сведения о средстве развертывания Office.

Пример

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

Атрибут All (часть элемента Remove)

Optional. The default value is FALSE if not specified.

Если присвоено значение TRUE, будут удалены все продукты и языки Приложений Microsoft 365, включая Project и Visio.

Допустимые значения:

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

Элемент Updates

Определяет способ обновления Office.

Пример

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

Атрибут Enabled (часть элемента Updates)

Optional. The default value is TRUE if not specified.

If set to TRUE, Office will check for updates. If set to FALSE, Office won't check for updates, but the user can check for updates by going to File > Account > Update Options > Update Now.

Допустимые значения:

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

Атрибут UpdatePath (часть элемента Updates)

Optional. Defaults to the CDN if not specified.

Defines where the updates for Office come from. UpdatePath can specify a network, local, or HTTP path of a source for Office installation files. Environment variables can be used for network or local paths.

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.

Примеры значений:

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

Атрибут TargetVersion (часть элемента Updates)

Optional. Defaults to the latest version from the specified update path.

Defines which version Office updates to. If TargetVersion is set to a specific build number, Office attempts to update to that version.

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.

Примеры значений:

  • TargetVersion="16.0.12345.12345"
  • TargetVersion=""

Атрибут Deadline (часть элемента Updates)

Необязательно.

Defines a deadline by which updates must be applied. The deadline is specified in Coordinated Universal Time (UTC). You can use Deadline with Target Version to make sure that Office is updated to a particular version by a particular date. We recommend that you set the deadline at least a week in the future to allow users time to install the updates.

До наступления крайнего срока пользователи получают несколько напоминаний об установке обновлений. Если Office не обновляется до наступления крайнего срока, пользователи получают уведомление о том, что обновления будут применены через 15 минут. Это позволяет пользователям сохранять документы Office, над которыми они работают, и закрывать все открытые программы Office. Если пользователи не закрывают программы Office, они закрываются автоматически по истечении 15 минут, что может привести к потере данных.

After the Office programs are closed, the updates are applied automatically. The deadline only applies to one set of updates. If you want to use a deadline to make sure that Office is always up to date, you must change the deadline every time a new update for Office is available.

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.

Пример значения:

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

Атрибут Channel (часть элемента Updates)

Необязательно. Значение по умолчанию: Current.

Определяет, какой канал следует использовать для обновления Office после установки. Атрибут Channel в элементе Add используется для указания канала обновления при установке Office, а атрибут Channel в элементе Update — для изменения канала для существующего экземпляра Office.

Дополнительную информацию о каналах обновления см. в статье Обзор каналов обновления для Приложений Microsoft 365.

If you use Group Policy with the Administrative Template files (ADMX/ADML) for Office, you can set Channel by using the Update Channel policy setting. 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.

Допустимые значения:

  • Channel="BetaChannel"
  • Channel="CurrentPreview"
  • Channel="Current"
  • Channel="MonthlyEnterprise"
  • Channel="SemiAnnualPreview"
  • Channel="SemiAnnual"

Примечание

  • Чтобы применять эти значения атрибутов, вы должны использовать средство развертывания Office не ниже версии 16.0.12827.20268, выпущенной в четверг 9 июня 2020 г.
  • Можно по-прежнему использовать ранее разрешенные значения для каждого канала обновления. Это означает, что вам не нужно обновлять старые XML-файлы конфигурации.
  • Но сборка бета-канала (иногда называемого "Предварительная оценка — ранний доступ") не поддерживается, поэтому ее следует использовать только в тестовых средах и в небольших группах выбранных пользователей, например для ИТ-специалистов или разработчиков приложений.

Если вы развертываете Office LTSC профессиональный плюс 2021 или Office LTSC стандартный 2021, которые являются версиями Office с корпоративной лицензией, необходимо использовать другой канал обновления: PerpetualVL2021. Дополнительные сведения см. в разделе Канал обновления для Office LTSC 2021.

Если вы развертываете Office профессиональный плюс 2019 или Office стандартный 2019, которые являются версиями Office с корпоративной лицензией, необходимо использовать другой канал обновления: PerpetualVL2019. Для получения дополнительных сведений см. Канал обновления для Office 2019.

Элемент RemoveMSI

Необязательно.

Определяет, удалены ли версии 2007, 2010, 2013 или 2016 продуктов Office, Visio и Project, установленных с помощью установщика Windows (MSI), до установки указанного продукта, например Приложений Microsoft 365.

We recommend that you uninstall any previous versions of Office before installing Microsoft 365 Apps. For more information about using RemoveMSI, see Remove existing MSI versions of Office when upgrading to Microsoft 365 Apps.

Атрибут IgnoreProduct (часть элемента RemoveMSI)

Необязательно.

Если идентификатор указан, то соответствующий продукт, установленный с помощью Windows Installer (MSI), не будет удален.

Примеры значений:

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

Элемент AppSettings

Необязательно.

Defines application preferences for Microsoft 365 Apps, including VBA Macro notifications, default file locations, and default file format. To create a configuration file with application preferences, we recommend you use the Office Customization Tool for Click-to-Run, a web application with a full user interface. You can also use the tool to learn more about the available application preferences.

Дополнительные сведения о настройках приложений см. в разделах Применение настроек приложений и Применение настроек приложений к установленному экземпляру Office.

Пример

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