Deployment config что это

Изменение конфигурации развертывания

Асинхронная операция Change Deployment Configuration инициирует изменения конфигурации развертывания.

Запрос

Запрос Change Deployment Configuration можно указать следующим образом. Замените идентификатором подписки, —именем облачной службы, —вариантом staging или production либо —уникальным именем развертывания.

Метод	Универсальный код ресурса (URI) запроса
POST	https://management.core.windows.net//services/hostedservices//deploymentslots//
POST	https://management.core.windows.net//services/hostedservices//deployments//

Параметры URI

Параметр URI	Описание
comp=config	Обязательный. Указывает, что в конфигурацию развертывания должно быть внесено изменение.

Заголовки запросов

В следующей таблице описаны заголовки запросов.

Заголовок запроса	Описание
Content-Type	Обязательный. Задайте для этого заголовка значение application/xml .
x-ms-version	Обязательный. Задает версию операции, используемой для этого запроса. Этот заголовок должен иметь значение 2009-10-01 или выше.

Текст запроса

Далее приведен формат текста запроса.

   base-64-encoded-configuration-file warnings-as-errors type-of-change  property-name property-value     identifier-of-extension state-of-extension    role_name1  identifier-of-extension state-of-extension       

В следующей таблице описываются элементы текста запроса.

Имя элемента	Описание
Конфигурация	Обязательный. Задает файл конфигурации службы для развертывания (в кодировке Base64).
TreatWarningsAsError	Необязательный элемент. Указывает, должны ли предупреждения обрабатываться как ошибки.

Возможны следующие значения:

Если не задано, по умолчанию используется значение false . Если задано true , то обновление будет заблокировано при возникновении предупреждений.

— Auto
— Manual
— Simultaneous

Если не указано, то значение по умолчанию равно Auto . Если задано значение Manual , для применения обновления необходимо вызвать WalkUpgradeDomain . Если это значение равно Auto , то обновление автоматически применяется к каждому домену обновления для службы.

Элемент Mode доступен только в версии 2011-08-01 или более поздней.

Максимальная длина элемента Name —64 символа, допустимы только буквенно-цифровые символы и знаки подчеркивания, имя должно начинаться с буквы. Попытка использовать другие символы, начать имя не с буквы или ввести имя, которое уже имеется у другого расширенного свойства в той же облачной службе, приведет к ошибке с кодом состояния 400 (неправильный запрос).

Можно удалить расширенное свойство, задав для него значение NULL.

ExtensionConfiguration

Представляет собой расширение, добавляемое к облачной службе.

Имя элемента	Описание
AllRoles	Необязательный элемент. Задает список расширений, применяемых ко всем ролям в развертывании.
Расширение	Обязательный. Представляет расширение для развертывания в роли в облачной службе.
NamedRoles	Необязательный элемент. Задает список расширений, применяемых к конкретным ролям в развертывании.

Расширение

Представляет расширение для развертывания в роли в облачной службе.

Имя элемента	Описание
Идентификатор	Обязательный. Идентификатор расширения. Идентификатор создается при добавлении расширения в облачную службу. Идентификатор расширения, добавленного в облачную службу, можно найти с помощью списка расширений.
Состояние	Необязательный элемент. Указывает состояние расширения. Этот элемент применяется только к настроенным расширениям JSON.

Возможны следующие значения:

— Enable
— Disable
— Uninstall

Значение по умолчанию — Enable .

NamedRoles

Задает список расширений, применяемых к конкретным ролям в развертывании.

Имя элемента	Описание
Роль	Обязательный. Представляет конкретную роль, в которую добавлено расширение.
RoleName	Обязательный. Указывает имя роли.
Расширение	Обязательный. Представляет расширение для развертывания в роли в облачной службе.

Ответ

Ответ включает код состояния HTTP и набор заголовков ответа.

Так как Change Deployment Configuration является асинхронной операцией, необходимо вызвать командлет Get Operation Status , чтобы определить, завершена ли операция, завершилась ли она сбоем или все еще выполняется.

Код состояния

Успешная операция возвращает код состояния 200 (ОК).

Заголовки откликов

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP.

Заголовок ответа	Описание
x-ms-request-id	Значение, которое однозначно определяет запрос к службе управления. Для асинхронной операции можно вызвать Get Operation Status со значением заголовка, чтобы определить, завершена ли операция, завершилась ли она сбоем или все еще выполняется.

Конфигурационный файл развертывания и Свойства

deployment.properties файл используется для хранения и получения свойств конфигурации развертывания в Панели управления Java. Они также используются для того, чтобы настроить поведение времени выполнения и для Плагина Java и для Сети Java, Запускаются.

всегда есть На уровне пользователя deployment.properties файл. Его расположение, которое неконфигурируемо, описывается ниже. Может также быть (дополнительный) На уровне системы deployment.properties файл. Если это существует, его расположение определяется Системным администратором через deployment.config файл как описано ниже.

Конфигурационный файл развертывания (deployment.properties)

Пользовательский Уровень

На уровне пользователя deployment.properties файл располагается следующим образом:

Операционная система	Расположение
Windows	\Sun\Java\Deployment\deployment.properties
Unix	$/.java/deployment/deployment.properties

Примеры:

Для пользователя jsmith работая на Windows, 2000/XP, deployment.properties файл был бы расположен следующим образом:

C:\Documents and Settings\jsmith\Application Data\Sun\Java\Deployment\deployment.properties

Для пользователя bjones работая на Unix, deployment.properties файл был бы расположен следующим образом:

Системный Уровень

deployment.config файл используется для того, чтобы определить На уровне системы deployment.properties в инфраструктуре. По умолчанию нет deployment.config файл существует; таким образом, нет в масштабе всей системы deployment.properties файл существует. Если deployment.config существует, это располагается любой здесь

Операционная система	Расположение
Windows	\Sun\Java\Deployment\deployment.config
Unix	/etc/.java/deployment/deployment.config

Операционная система	Расположение
Windows	$\lib\deployment.config
Unix	$/lib/deployment.config

( $ расположение jre, от которого выполняются продукты развертывания. Продукты развертывания включают Сеть Java, Запускаются, Плагин Java, Панель управления Java. ),

deployment.config (если это существует), содержит два свойства: deployment.system.config и deployment.system.config.mandatory .

deployment.system.config URL к системе (всего предприятия) deployment.properties файл. Это может использоваться системными администраторами, чтобы центрально управлять или «строгая изоляция» специфичные для пользователя параметры конфигурации.

deployment.system.config.mandatory булево. Значение по умолчанию false . Если false , будет попытка загрузиться deployment.properties файл, на который указывают deployment.system.config URL. Если URL может быть найден и загружен, он будет использоваться. Если true , аналогично будет попытка загрузить систему deployment.properties файл, на который указывают deployment.system.config URL. Если URL может быть найден и загружен, он будет использоваться; но если это не может быть найдено или загружено, тогда ничему не позволят работать.

Свойства Конфигурации развертывания

Следующая таблица описывает свойства, которые могут быть установлены в deployment.properties файл.

Отметьте: Любое свойство развертывания системы, говорят SomeKey=SomeValue , может быть заблокирован включением другого ключа, SomeKey.locked . Ключ SomeKey.locked май или не может быть установлен в значение; в любом случае, SomeKey=SomeValue будет заблокирован так, чтобы пользователь не мог изменить это. Если свойство развертывания системы не будет заблокировано, то пользователю разрешат изменить его.

Инфраструктура

Ключ свойства	Ввести	Значение по умолчанию	Описание
deployment.user.cachedir	Строка	«$USER_HOME» + File.separator + «кэш»	Каталог кэша на уровне пользователя.
deployment.system.cachedir	Строка	нуль	Каталог кэша на уровне системы.
deployment.user.logdir	Строка	«$USER_HOME» + File.separator + «журнал»	Каталог журнала на уровне пользователя.
deployment.user.tmp	Строка	«$USER_HOME» + File.separator + «tmp»;	Временный пользовательский каталог.

Хранилища сертификата и файлы политики

Файл политики безопасности на уровне пользователя. Протокол URL является или файлом, HTTP, или HTTPS.

Строка «$USER_HOME» + File.separator + «безопасность» + File.separator + «trusted.cacerts»;

Корневое хранилище сертификата CA на уровне пользователя.

Строка «$USER_HOME» + File.separator + «безопасность» + File.separator + «trusted.jssecacerts»

Хранилище сертификата CA JSSE на уровне пользователя.

Строка «$USER_HOME» + File.separator + «безопасность» + File.separator + «trusted.certs»

Доверяемое хранилище сертификата подписывающего лица на уровне пользователя.

Строка «$USER_HOME» + File.separator + «безопасность» + File.separator + «trusted.jssecerts»;

Хранилище сертификата JSSE на уровне пользователя, Которому доверяют.

Строка «$USER_HOME» + File.separator + «безопасность» + File.separator + «trusted.clientcerts»

Хранилище сертификата Аутентификации клиента на уровне пользователя.

Строка нуль

Файл политики безопасности на уровне системы. Протокол URL является или файлом, HTTP, или HTTPS.

Строка «$JAVA_HOME» + File.separator + «lib» + File.separator + «безопасность» + File.separator + «cacerts»

Корневое хранилище сертификата CA на уровне системы.

Строка «$JAVA_HOME» + File.separator + «lib» + File.separator + «безопасность» + File.separator + «jssecacerts»;

Хранилище сертификата CA JSSE на уровне системы.

Строка «$SYSTEM_HOME» + File.separator + «безопасность» + File.separator + «trusted.certs»

Хранилище сертификата Подписывающего лица на уровне системы.

Строка «$SYSTEM_HOME» + File.separator + «безопасность» + File.separator + «trusted.jssecerts»

Хранилище сертификата JSSE на уровне системы.

Строка «$SYSTEM_HOME» + File.separator + «безопасность» + File.separator + «trusted.clientcerts»

Хранилище сертификата Аутентификации клиента на уровне системы.

Настройки Access And Control безопасности

• «НИКОГДА»: недоверяемый контент будет всегда выполнять со значением по умолчанию JRE
• «ПОДСКАЗКА»: Запросите пользователя перед использованием небезопасных версий JRE; пользователи будут видеть, что новое предупреждает диалоговые окна
• «ВСЕГДА»: недоверяемый контент будет работать с требуемым JRE без любого запроса

Файл политики содержит политику потолка полномочий, предоставленных доверяемым приложениям и апплетам. По умолчанию это — все полномочия, но при использовании этого параметра конфигурации, пользователь или предприятие могут сконфигурировать меньший набор полномочий.

Сети

интервал 3 для PROX_TYPE_BROWSER

Это для типа прокси, который должен быть использованием. Варианты:

PROX_TYPE_UNKNOWN =-1;
PROX_TYPE_NONE = 0;
PROX_TYPE_MANUAL = 1;
PROX_TYPE_AUTO = 2; и
PROX_TYPE_BROWSER = 3;

Должны обойтись все локальные узлы.

Кэш и Дополнительный Репозитарий Пакета

Максимальный размер кэша развертывания в Мбайте. Это — размер кэша для каждого кэша: Сеть Java Запускается и Плагин Java.

«0» — Отключает кэширование в Плагине Java; размер кэша в Веб-Запуске Java будет неограничен.

«-1» — Для неограниченного размера кэша.

0-9 коэффициентов сжатия, которые будут использоваться в сжатии фляги апплета.

Консоль Java

• «СКРОЙТЕСЬ», чтобы скрыть Консоль Java;
• «ПОКАЖИТЕ», чтобы показать Консоль Java;
• «ОТКЛЮЧИТЕ», чтобы отключить Консоль Java;

Трассировка и Журналирование

Ключ свойства	Ввести	Значение по умолчанию	Описание
deployment.trace	Строка	ложь	Позвольте проследить.
deployment.log	Строка	ложь	Позвольте регистрировать.

Сеть Java Запускается: Ассоциация JNLP

Ассоциации JNLP. Варианты:

ASSOCIATION_NEVER = 0;
ASSOCIATION_NEW_ONLY = 1;
ASSOCIATION_ASK_USER = 2;
ASSOCIATION_REPLACE_ASK = 3;

Сеть Java Запускается: Интеграция настольных систем

Строка «ASK_IF_HINTED»

Это касается создания настольного ярлыка для Сети Java, Запускаются. Варианты:

• «НИКОГДА»
• «ВСЕГДА»
• «ASK_USER»
• «ASK_IF_HINTED»
• «ALWAYS_IF_HINTED»

Сеть Java Запускает Выборы JRE

Строка «http://java.sun.com/products/autodl/j2se»

Сеть Java Запускает управление JRE

Строка «ВСЕГДА»

Это устанавливает варианты для того, чтобы автозагрузить. Варианты:

Выбор браузера и путь

Это — путь к браузеру для того, чтобы показать веб-страницы от средства просмотра приложения, О Поле, и Сеть Запускает приложения.

Отметьте, что это свойство используется для Соляриса и Linux только. На Висячих строках игнорируется это свойство, и браузер значения по умолчанию определяется тем же самым путем, что это любым другим приложением, которое запускает браузер на Windows.

Проверьте на Тайм-аут обновления

Ключ свойства	Ввести	Значение по умолчанию	Описание
deployment.javaws.update.timeout	интервал	500	Модули являются миллисекундами.

Отличия DeploymentConfig от Deployment и примеры использования

Объекты DeploymentConfig накапливаются до определённого количества (типа retention-history limit) или сразу удаляются по завершению работы его pod-а ? В любом случае если возможно указать экземпляр DeploymentConfig в OwnerReferences ReplicaSet-а его pod-a, этот pod будет удалён автоматически с удалением экземпляра DeploymentConfig

This comment wasn’t rated yet 0
Reply Add to bookmarks More
Show previous comment

Они обновляются кмк, но автор ответит лучше.

при удалении реплика сет просто поднимет новый — деплоймент конфиг те же яйца только в профиль от редхата.

контроллеры — постоянная величина, она просто есть 🙂 никто никуда ничего не удаляет после завершения работы пода

This comment wasn’t rated yet 0
Reply Add to bookmarks More
Show previous comment

самое забавное — что ReplicationController, это старая версия ReplicaSet, о котором умлочали в «статье»

Total votes 1: ↑1 and ↓0 +1
Reply Add to bookmarks More
Show previous comment

Здесь я перепутал — ReplicaSet создаётся Deployment-ом, а вот конфигурация деплоймента самого компонента DeploymentConfig запускает создание ReplicationController-а (и его pod-a).

This comment wasn’t rated yet 0
Reply Add to bookmarks More
Show previous comment

DPC-RS ок, конфигурация компонента ? вы имеете в виду количество реплик?

This comment wasn’t rated yet 0
Reply Add to bookmarks More
Show previous comment

Я имел ввиду конфигурацию развёртываемого компонента, описанного в DeploymentConfig. Впервые о деталях OpenShift деплоймента читаю, так что путаюсь.

This comment wasn’t rated yet 0
Reply Add to bookmarks More
Show previous comment

это автор запутал, DPC — объект OCP, тут нет никакого рокет-сайнс, Редхат просто создал такое вот в API своей системы, если посмотреть на прмеры, оно прям простое.

Total votes 1: ↑1 and ↓0 +1
Reply Add to bookmarks More
Show previous comment

коллеги, какой ReplicationController я не понимаю — это старая сущность, автор вещал о ОКД4+, в свежем кубере нет этого

This comment wasn’t rated yet 0
Reply Add to bookmarks More

А зачем вы отдали билд на OCP?

почему не отдать его на Jenkins/GCI/Bamboo/etc ?

почему отказались от helm?

imagestreams — imho плохо, зачем тегировать, и отдавать на контейнерную платформу, какой OCP и является, такую важную часть процесса, как сборка и обновление?

как вы смотрите и дебажите билды? что у вас с IAC — в плане сборки?

This comment wasn’t rated yet 0
Reply Add to bookmarks More

«— это та же штука, что и деплоймент,» — это не так — вы сами описываете различия в этих сущностях.

Далее — я бы для первой статьи о «особенностях» рассмотрел скорее темплейты OCP, чем сравнение «родной» сущности и кастомной.

«Я бы назвал это некой заменой инструмента CI/CD, упрощающей жизнь разработчику» — сложно с Вами согласиться. Разработчик должен получать доступ до пайпалайна, как понимать как он работает. Главная особенность OCP — доступ до терминала, логов, мониторинга, да и в принципе через GUI решение OCP.

Вносить изменения вместе с командой DevOps — а так же, иметь гибкие настройки пайплайна, втч и обращение к секретам, которые не лежат в b64 etcd — вы же банкинг. =).

А было бы здорово, например использовать Vault? Вы рассматривали интеграцию с волтом при такой сборке?

Как можно таким прямым инструментом заменить тот же jenkins/gitlab-ci? вопрос в теорию, конечно.

«реквестов/лимитов ресурсов для POD’ов» — если Вы пишете о лимитах, то добавьте еще квоты и для самих контейнеров, они так же присутствуют в OCP и чаще более важны, чем то, о чем вы пишите. Вы же наверняка используете пре-стартеры/сопутствующие и сайдкары?

Так же — для знакомства коллег с OCP — приложили бы пример с лимитами к NS, раз у нас тут ямлы.

oc delete pod —field-selector=status.phase==Succeeded -> вы используете это на продуктиве? Тут все же странно, есть прекрасный хелм, о котором я писал выше.

«из maxSurge;» — стоит добавить, что это необязательное значение. Многие компании работают на OKD3, не совсем актуально. Хотя сущности, которые Вы описали — есть в обоих версиях. Тут могу ошибаться.

«Поддержка prehook и posthook» — про HPA расскажите пожалуйста, и кастомные метрики, информация которую Вы взяли из базы знаний редхат не так интересна, ее, я думаю все читали.

Еще несколько вопросов, если у Вас будет время ответить:

• «Build клонирует git-репозиторий от ветки main» — мы работаем только по мастеру? Какой это юзкейс для команд? Вы автобилдите что-то? А кастомные ветки? Прошу пояснить.
• «репозиторий битбакета или гитхаба» — других систем хранения кода нет/не поддерживается?
• «пушит собранный образ в репозиторий кластера»

Как вы пушите в репозиторий кластера и за ним следите? GC? правила версионирования? Это реджестри внутри OCP? Какие правила для обновления для этого необходимы? По каким правилам вы пушите — latest? Или 7ver? Или что вы используете и как тегируете? Как происходит тегирование образа? по ветке/хеш комиту? — тут то и интересно, а не копипаст.

• «создаётся новый deployer POD с суффиксом -deploy, который контролирует процесс развёртывания»;

или вы имеете ввиду — что создается дефолтный под с суффиксом деплой при разворачивании компонента? тогда зачем об этом писать?

• «создаётся ещё один ReplicationController, который создаёт новый экземпляр POD с нашим приложением»»

т.е создается именно новый контроллер? зачем? объясните пожалуйста

• после успешного старта контейнера внутри нового POD’а deployer POD завершает работу и переходит в состояние Completed;

как это работает? Readiness проба отработала? Как вы аккумулируете логи? и анализируете ли их?

И самое главное — как вы интегрируете такую сборку с QG?

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

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

Рекомендация. Параметры в этой статье показывают XML-элементы и атрибуты в файле конфигурации. Файл конфигурации можно продолжать создавать в текстовом редакторе, но вместо этого рекомендуется использовать центр развертывания Office . С помощью центра развертывания Office можно легко создавать и изменять файлы конфигурации в веб-интерфейсе. Дополнительные сведения см. в разделе Обзор средства настройки Office.

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

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

При создании файла конфигурации рекомендуется начать с примера файла и обновить его соответствующими параметрами для вашей среды. Для начала можно скопировать и вставить приведенный ниже пример в текстовый файл и сохранить его с выбранным именем. Используйте файл для изменения XML-элементов и атрибутов, а в оставшейся части этой статьи — дополнительные сведения о каждом из элементов и атрибутов.

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

Значение	Описание
Добавление SourcePath=»\\Server\Share»	Office загружается в папку \\server\share в сети и развертывается с помощью установочных файлов в этом расположении.
Добавление OfficeClientEdition=»64″	Скачивает и устанавливает 64-разрядный выпуск Office
Add Channel=»MonthlyEnterprise»	Office устанавливается с помощью Monthly Enterprise Channel.
Product	Скачивает и устанавливает Приложения Microsoft 365 для предприятий.
Language Language	Скачивает и устанавливает английскую и японскую версии Office.
Updates Enabled=»TRUE»	Office проверяет наличие обновлений.
Обновления UpdatePath=»\\Server\Share»	Office проверяет наличие обновлений в папке \server\share в вашей сети.
Display Level=»None» AcceptEULA=»TRUE»	При установке Office пользовательский интерфейс не отображается.

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

Элемент Add

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

Пример

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

Определяет расположение установочных файлов Office. Если ODT запущен в режиме скачивания, определяет, где нужно сохранить файлы. Если он не включен, ODT ищет файлы установки в той же папке, что и средство, а затем использует сеть доставки содержимого Office (CDN). Если он не включен, а ODT запущен в режиме скачивания, установочные файлы Office скачиваются в ту же папку, в которой находится средство.

При скачивании Office в папку, которая уже содержит эту версию Office, ODT экономит пропускную способность сети, скачивая только отсутствующие файлы. Например, если вы используете ODT для скачивания Office на английском и немецком языках в папку, которая уже содержит Office на английском языке, загружается только немецкий языковой пакет.

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

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

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

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

При использовании атрибута Version рекомендуется также включить атрибут Channel. Если не включить атрибут Channel, используется канал по умолчанию, который может не соответствовать указанной версии.

Если Приложения Microsoft 365 уже установлен на устройстве, можно использовать Version=»MatchInstalled» для установки той же версии Office, даже если доступна более новая версия. Этот параметр упрощает добавление языковых пакетов или Visio и Project без обновления Office до более новой версии.

• Version=»16.0.15330.20306″
• Version=»MatchInstalled»

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

Определяет, будет ли скачан или установлен 32-разрядный или 64-разрядный выпуск Приложения Microsoft 365. Если office не установлен на устройстве и OfficeClientEdition не указан, по умолчанию ODT использует 64-разрядную версию, если устройство работает под управлением 32-разрядной версии Windows или имеет менее 4 ГБ ОЗУ. Если office установлен, а OfficeClientEdition не указан, ODT соответствует архитектуре существующей установки 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»

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

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

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

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

Необязательный параметр. По умолчанию используется CDN, если не указано.

Определяет, откуда скачиваются установочные файлы при запуске ODT в режиме загрузки. Чаще всего используется для распространения определенных языков и продуктов для Office из центрального сетевого расположения в другое. При использовании DownloadPath необходимо указать версию, как показано в примере.

• DownloadPath=»\\servera\share»

Пример

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

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

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

При установке языков ODT сначала ищет исходные файлы в расположении, указанном в атрибуте SourcePath. Если языковой пакет недоступен в этом расположении и параметр AllowCdnFallback имеет значение True, то ODT использует исходные файлы из cdN Office.

• AllowCdnFallback=»True»
• AllowCdnFallback=»False»

Пример

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

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

Если задано значение TRUE, то существующая установка Приложения Microsoft 365 изменяется на архитектуру (иногда называемую разрядностью), которая указана в атрибуте OfficeClientEdition. Например, этот атрибут можно использовать для изменения 32-разрядной установки Приложения Microsoft 365 на 64-разрядную.

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

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

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

• OfficeMgmtCOM=»True»
• OfficeMgmtCOM=»False»

Пример

Элемент Product

Определяет, какие продукты необходимо скачать или установить. Если вы укажете несколько продуктов, они будут установлены в порядке, заданном в файле конфигурации. Контекст первого запуска Microsoft Office определяется первым продуктом.

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

Пример

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

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

• ID=»O365ProPlusRetail»
• ID=»VisioProRetail»
• ID=»ProjectProRetail»

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

Позволяет управлять установкой продукта Office, как указано в атрибуте ID, в зависимости от того, установлен ли на устройстве определенный продукт Office на основе MSI. Например, если на устройстве уже установлена версия Project профессиональный на основе MSI, установите Project Online настольном клиенте.

Вы можете указать любой продукт Office, установленный установщиком Windows (MSI), но MSICondition чаще всего используется для установки Project или Visio. Значение, указанное для атрибута MSICondition, может быть корпоративной или розничной версией продукта, если эта версия продукта была установлена с помощью MSI.

MSICondition распознает указанные вами версии Office 2007, 2010, 2013 и 2016. Но вы не можете указать определенную версию. Например, вы не можете использовать MSICondition для поиска специально для Visio стандартный 2013. MSICondition ищет все установки Visio стандартный на основе MSI, включая Visio стандартный 2007, Visio стандартный 2010, Visio стандартный 2013 и Visio стандартный 2016.

Значение, указанное для атрибута MSICondition, — это идентификатор установки, который находится в файле Setup.xml в . Папка WW файлов установки для существующей версии продукта Office. Например, файл Setup.xml для Visio профессиональный 2016 находится в папке VisPro.WW. Можно указать несколько типов продукта Office, разделенных запятой. Например, можно указать «PrjStd,PrjStdR,PrjPro,PrjProR», чтобы найти установки Project стандартный или Project профессиональный с корпоративной лицензией или розничной лицензией.

Мы рекомендуем удалить существующие продукты Office на основе MSI при установке продуктов, указанных в XML-файле. Чтобы удалить существующие продукты на основе MSI, используйте элемент RemoveMSI.

Вы также можете watch видео о том, как использовать MSICondition в сочетании с RemoveMSI для упрощения обновления.

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

В следующем примере классический клиент Project Online устанавливается на устройстве только в том случае, если на устройстве уже установлена версия Project стандартный на основе MSI. Кроме того, Project стандартный удаляется с устройства при установке клиента Project Online desktop.

Элемент Language

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

Пример

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

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

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

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

Убедитесь, что указанные вами языки поддерживаются устанавливаемым продуктом. В противном случае установка завершится ошибкой.

Например, Приложения Microsoft 365 поддерживает английский (Соединенное Королевство), французский (Канада) и испанский (Мексика), но Project и Visio не поддерживают эти языки.

• Список языков, поддерживаемых Приложения Microsoft 365, см. в разделе Языки, коды языка и региональные параметры и сопутствующие языки правописания.
• Список языков, поддерживаемых Visio, см. в разделе Языки отображения, поддерживаемые в классическом приложении Visio.
• Project поддерживает те же языки, что и Visio.

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

MatchInstalled можно использовать только в том случае, если уже установлен хотя бы один продукт «нажми и запускай». Его нельзя использовать с параметром /download для ODT. Дополнительные сведения о MatchInstalled см. в статье Обзор развертывания языков и создание динамических, экономичных и универсальных пакетов для Приложения Microsoft 365.

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

При использовании MatchOS рекомендуется указать резервный язык для установки, если соответствующий язык не поддерживается Office или не может быть найден в локальных исходных файлах. Для этого используйте атрибут «Fallback». Дополнительные сведения см . в разделе Установка на те же языки, что и операционная система.

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

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

При использовании MatchInstalled можно указать, нужно ли соответствовать списку уже установленных языков для определенного продукта или сочетанию всех установленных продуктов. Чтобы выбрать конкретный продукт, можно указать любой поддерживаемый идентификатор продукта. Если вы хотите соответствовать языкам всех уже установленных продуктов, укажите «Все». Затем ODT устанавливает новый продукт с тем же набором языков, что и тот, который указан в TargetProduct.

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

Элемент Display

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

Пример

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

Необязательный параметр. Значение по умолчанию равно Full, если не указано.

Если для атрибута 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 или других приложений.

Пример

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

• Если список языков в файле конфигурации включает все установленные языки, параметр ExcludeApp в файле заменяет все существующие параметры ExcludeApp на устройстве. Это также верно, если список языков в файле конфигурации включает как все установленные языки, так и дополнительные языки.
• Если список языков в файле конфигурации содержит не все установленные языки, параметр ExcludeApp в файле конфигурации будет объединён с параметром ExcludeApp на устройстве.

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

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

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

• Для OneDrive для бизнеса используйте Groove. Для Skype для бизнеса используйте Lync.
• Дополнительные сведения о Microsoft Teams см. в статье Развертывание Microsoft Teams с помощью Приложения Microsoft 365.
• Bing относится к фоновой службе поиска (Майкрософт) в Bing. Дополнительные сведения см. в статье Поиск (Майкрософт) в Bing и Приложения Microsoft 365 для предприятий.

Элемент Property

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

Пример

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

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

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

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

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

Необязательный параметр. Значение по умолчанию равно 0 , если не указано.

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

• Имя свойства=»AUTOACTIVATE» Value=»0″
• Имя свойства=»AUTOACTIVATE» Value=»1″

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

Необязательный параметр. Значение по умолчанию — FALSE , если не указано.

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

• Имя свойства=»FORCEAPPSHUTDOWN» Value=»FALSE»
• Имя свойства=»FORCEAPPSHUTDOWN» Value=»TRUE»

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

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

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

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

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

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

Необязательный параметр. Значение по умолчанию — 0 , если не указано.

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

• Property Name=»SharedComputerLicensing» Value=»0″
• Property Name=»SharedComputerLicensing» Value=»1″

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

Необязательный параметр. Значение по умолчанию — 0 , если не указано.

Установите для параметра SCLCacheOverride значение 1, если вы используете активацию общего компьютера и хотите перемещать маркер лицензирования. Используйте это свойство с SCLCacheOverrideDirectory. Это свойство необходимо, только если вы решили переместить маркер лицензирования из расположения по умолчанию. Дополнительные сведения см. в статье Обзор активации общего компьютера для Приложения Microsoft 365.

• Property Name=»SCLCacheOverride» Value=»0″
• Property Name=»SCLCacheOverride» Value=»1″

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

Задайте SCLCacheOverrideDirectory , чтобы указать расположение папки для маркера лицензирования, если вы используете активацию общего компьютера и хотите перемещать маркер лицензирования. Используйте свойство с SCLCacheOverride. Это свойство необходимо, только если вы решили переместить маркер лицензирования из расположения по умолчанию.

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

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

Необязательный параметр. Значение по умолчанию — 0 , если не указано.

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

• Имя свойства=»DeviceBasedLicensing» Value=»1″
• Имя свойства=»DeviceBasedLicensing» Value=»0″

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

Необязательный параметр. Значение по умолчанию — True, если не указано.

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

• Имя свойства=»PinIconsToTaskbar» Value=»FALSE»
• Имя свойства=»PinIconsToTaskbar» Value=»TRUE»

• Приложения Microsoft 365 больше не поддерживается в Windows 7. Дополнительные сведения см. в статье Окончание поддержки Windows 7 и использование Приложений Microsoft 365.
• Приложения Microsoft 365 больше не поддерживается в Windows 8.1. Дополнительные сведения см. в разделе Windows 8.1 прекращения поддержки и Приложения Microsoft 365.

Элемент Remove

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

Пример

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

Необязательный параметр. Значение по умолчанию — FALSE , если не указано.

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

• All=»FALSE»
• All=»TRUE»

Элемент Updates

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

Пример

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

Необязательный параметр. Значение по умолчанию — TRUE , если не указано.

Если задано значение TRUE, Office проверяет наличие обновлений. Если задано значение FALSE, Office не проверка обновления, но пользователь может проверка обновления, перейдя в менюПараметры> обновленияучетной записи>файла>.

• Enabled=»TRUE»
• Enabled=»FALSE»

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

Необязательный параметр. По умолчанию используется CDN, если не указано.

Определяет источник обновлений для Office. UpdatePath может указать сетевой, локальный или HTTP-путь источника для установочных файлов Office. При указании сетевых или локальных путей можно использовать переменные.

Если вы используете групповая политика с файлами административных шаблонов (ADMX/ADML) для Office, можно задать UpdatePath с помощью параметра политики Путь обновления. Этот параметр политики можно найти в разделе «Конфигурация компьютера\Политики\Административные шаблоны\Microsoft Office 2016 (компьютер)\Обновления».

• UpdatePath=»\\server\share»
• UpdatePath=»C:\Preload\Office»
• UpdatePath

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

Необязательный параметр. По умолчанию используется последняя версия из указанного пути обновления.

Определяет, до какой версии необходимо обновить Office. Если параметр TargetVersion имеет определенный номер сборки, Office пытается выполнить обновление до этой версии.

Если вы используете групповая политика с файлами административных шаблонов (ADMX/ADML) для Office, можно задать TargetVersion с помощью параметра политики Целевая версия. Этот параметр политики можно найти в разделе «Конфигурация компьютера\Политики\Административные шаблоны\Microsoft Office 2016 (компьютер)\Обновления».

• TargetVersion=»16.0.12345.12345″
• TargetVersion=»»

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

Определяет крайний срок обновления. Крайний срок указывается в формате UTC. Вы можете использовать атрибут Deadline с атрибутом Target Version, чтобы Office точно обновился до определенной версии к определенной дате. Рекомендуем устанавливать срок по крайней мере на неделю вперед, чтобы у пользователей было время установить обновления.

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

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

Чтобы использовать этот атрибут, в Office должен быть запущен по крайней мере пакет обновления 1 (версия 15.0.4569.1507). Если вы используете групповая политика с файлами административных шаблонов (ADMX/ADML) для Office, вы можете задать крайний срок с помощью параметра политики Обновить крайний срок. Этот параметр политики можно найти в разделе «Конфигурация компьютера\Политики\Административные шаблоны\Microsoft Office 2016 (компьютер)\Обновления».

• Deadline=»05/16/2014 18:30″

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

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

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

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

Если вы используете групповая политика с файлами административных шаблонов (ADMX/ADML) для Office, можно задать канал с помощью параметра политики Обновить канал. Этот параметр политики можно найти в разделе «Конфигурация компьютера\Политики\Административные шаблоны\Microsoft Office 2016 (компьютер)\Обновления». Если этот параметр включен, он имеет приоритет над значением Channel, заданным с помощью средства развертывания Office.

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

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

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

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

Элемент RemoveMSI

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

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

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

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

• IgnoreProduct
• IgnoreProduct

Элемент AppSettings

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

Пример

Связанные статьи

• Общие сведения о средстве развертывания Office
• Руководство по развертыванию для приложений Microsoft 365
• Языки и региональные параметры, а также дополнительные языки проверки правописания