Средства Release Management для развертывания приложений

В каждом действии выпуска используется тот или иной инструмент управления выпуском. Например, средство запуска командной строки — это инструмент, который выполняет для действия определенный исполняемый файл. Если требуется выполнить задачу, которую предусмотренные инструменты не поддерживают, можно создать собственный пользовательский инструмент и добавьте его в настраиваемое действие выпуска. Инструменты также могут использоваться для развертывания компонента приложения.

Ниже приведен список инструментов, предусмотренных в управлении выпусками, вместе с их параметрами.

Агент развертывания баз данных - выполнить скрипт

Этот инструмент выполняет запрос SQL в определенной базе данных. Он основан на стандартном исполняемом файле sqlcmd, распространяемом в составе сервера SQL Server. Дополнительные сведения об этом исполняемом файле см. в документации по sqlcmd. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-S	ServerName	Да	Имя сервера базы данных SQL.
-i	ScriptName	Да	Имя скрипта, который требуется выполнить.
-b	Н/Д	Нет	Этот параметр является переключателем. Его наличие означает, что при возникновении ошибки выполнение пакета прекращается.

Агент развертывания службы отчетов

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

Параметр	Переменная	Обязательно	Описание
-s	serverUrl	Да	Полный URL-адрес сервера службы отчетов.
-l	itemLocation	Да при наличии нескольких элементов	Расположение элементов. Если указано, должна быть задана папка (-f).
-f	folder	Да при наличии нескольких элементов	Папка элементов. Если указана, должно быть задано расположение элементов (-l).
-t		Да	Тип обрабатываемых элементов. Допустимые значения: Отчет Рисунок
-sp		Нет	Список шаблонов поиска, используемых для фильтрации элементов. Каждый шаблон поиска должен отделяться запятой или точкой с запятой (например, *.bmp;*.jpg). Если этот параметр не задан, шаблон поиска будет следующим в зависимости от выбранного типа элемента (-t): Отчет: *.rdl Рисунок: *.bmp,*.gif,*.jpg,*.jpeg,*.png
-i		Да в случае одного элемента	Файл элемента. Если указан, должно быть указано имя элемента (-n). Этот параметр используется, когда требуется выполнить развертывание одного элемента. В таком случае не должно быть параметров расположения (-l) и папки (-f) элементов.
-n		Да в случае одного элемента	Имя элемента. Если указано, должен быть указан файл элемента (-i). Этот параметр используется, когда требуется выполнить развертывание одного элемента. В таком случае не должно быть параметров расположения (-l) и папки (-f) элементов.
-log		Нет	В физическом каталоге будет создан файл журнала с этим именем.
-o	Н/Д	Нет	Этот параметр является переключателем. Его наличие означает, что если конечный объект существует, он будет перезаписан.
-ds ds1,...,dsN			Полное имя (с разделением запятыми) всех источников данных, связываемых с элементом. В именах учитывается регистр. Этот параметр применяется только к отчетам. Источник данных может быть указан в формате [имя]: ссылка. Имя — это имя источника данных, указанное в отчете, где требуется заменить ссылки. Ссылка — это полная ссылка на источник данных на целевом сервере, который требуется использовать для отчета.

Агент развертывания MSI

Этот инструмент развертывает установщик Microsoft Windows (MSI). Он удаляет предыдущую версию продукта, прежде чем устанавливать новую. Он основан на специальном скрипте PowerShell системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-command	Н/Д	Да	Фиксированное значение ./msiexec.ps1.
-MsiFileName	Installer	Да	Полный путь (если требуется) и имя устанавливаемого MSI-файла.
-MsiCustomArgs	MsiCustomArgs	Нет	Пользовательские аргументы, используемые для установки MSI-файла. Эти аргументы передаются непосредственно в исполняемый файл msiexec. Если пользовательские аргументы не требуются, этот параметр следует удалить из аргументов.
-PrevProductName		Нет	Позволяет пользователю указать имя предыдущего продукта, который требуется удалить перед установкой MSI-файла. По умолчанию система использует имя продукта в устанавливаемом MSI-файле.

Агент развертывания XCopy

Этот инструмент копирует расположение пакета в определенное конечное расположение. Он основан на специальном пакетном скрипте системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-source	Н/Д	Да	Фиксированное значение, указывающее, что необходимо копировать все расположения источника.
-destination	Installation Path	Да	Место назначения копирования.

Средство запуска командной строки

Этот инструмент выполняет определенный исполняемый файл. Он основан на специальном скрипте PowerShell системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-file	Н/Д	Да	Фиксированное значение ./RunCommandLine.ps1.
-FilePath	FilePath	Да	Полный путь (если требуется) и имя запускаемого исполняемого файла.
-Arguments	Аргументы	Нет	Аргументы, необходимые для запуска исполняемого файла.
-UserDomain	UserDomain	Нет	Домен пользователя, используемый, если исполняемый файл требуется запустить с определенным удостоверением. Если домен не предоставлен, будет использоваться локальный пользователь (. \localuser).
-UserName	UserName	Нет	Имя пользователя, используемое, если исполняемый файл требуется запустить с определенным удостоверением.
-UserPassword	UserPassword	Нет	Пароль пользователя, используемый, если исполняемый файл требуется запустить с определенным удостоверением.

Диспетчер реестра Windows

Этот инструмент позволяет манипулировать информацией в реестре Windows. Он основан на специальном скрипте PowerShell системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-command	Н/Д	Да	Фиксированное значение ./ManageWindowsRegistry.ps1.
-Action	Действие	Да	Выполняемое действие. Допустимые значения: CreateKey: создание нового раздела реестра ModifyKey: изменение раздела реестра или его данных DeleteKey: удаление раздела реестра вместе со всеми его значениями и вложенными разделами CreateValue: создание нового значения реестра в разделе ModifyValue: изменение значения реестра в разделе DeleteValue: удаление значения реестра из раздела
-OperatingSystemType		Нет	Указывает, в каком реестре осуществляется доступ к разделу или значению — 32-разрядном или 64-разрядном. Если параметр не задан, по умолчанию предполагается 32-разрядный реестр.
-RegistryKey	RegistryKey	Да	Путь и имя раздела реестра (например, HKLM\Software\MyKey).
-RegistryValue		Нет*	Значение реестра, к которому будут применены изменения (например, MyValue). Обязательно для действий CreateValue, ModifyValue и DeleteValue.
-ValueType		Нет	Тип обрабатываемого значения. Допустимые значения: REG_SZ: строка (значение по умолчанию не определено) REG_QWORD_LITTLE_ENDIAN: 64-разрядное число в формате с прямым порядком байтов REG_QWORD: 64-разрядное число REG_NONE: нет значения REG_MULTI_SZ: строковое значение с несколькими строками (отделяемыми символами \0) REG_LINK: символическая ссылка REG_EXPAND_SZ: строка с неразвернутыми ссылками на переменные среды REG_DWORD_BIG_ENDIAN: 32-разрядное число в формате с обратным порядком байтов REG_DWORD_LITTLE_ENDIAN: 32-разрядное число в формате с прямым порядком байтов REG_DWORD: 32-разрядное число REG_BINARY: двоичные данные в любой форме
-RegistryData		Нет	Данные, применяемые к значению (при использовании действия CreateValue или ModifyValue) или к значению по умолчанию для раздела (при использовании действия CreateKey или ModifyKey).
-RegistryKeyDestination		Нет*	Имя раздела реестра, применяемое при использовании действия ModifyKey для переименования раздела реестра. Например: RegistryKey = HKLM\Software\MyKey RegistryKeyDestination = HKLM\Software\MyModifiedKey Обязательно для действия ModifyKey.

Общий ввод-вывод Windows

Этот инструмент выполняет общие операции ввода-вывода в Windows. Он основан на специальном скрипте PowerShell системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-command	Н/Д	Да	Фиксированное значение ./ManageWindowsIO.ps1.
-Action	Действие	Да	Укажите выполняемое действие: Create: создать новую папку Delete: удалить файлы или папку Rename: переименовать файл или папку Move: переместить файл или папку Attrib: изменить атрибуты (включая владельца) файлов или папки
-FileFolderName	FileFolderName	Да	Путь и имя файла или папки.
-DestinationName		Нет*	Конечное имя (для операции переименования) или путь и имя папки (для операции перемещения). Является обязательным для действий переименования и перемещения.
-ReadOnly		Нет	Позволяет пользователю установить или сбросить атрибут "только для чтения" файлов или папки. + : установить флаг - : снять флаг Любое другое значение: оставить флаг в текущем состоянии
-Archive		Нет	Позволяет пользователю установить или сбросить атрибут "архивный" файлов или папки. + : установить флаг - : снять флаг Любое другое значение: оставить флаг в текущем состоянии
-System		Нет	Позволяет пользователю установить или сбросить атрибут "системный" файлов или папки. + : установить флаг - : снять флаг Любое другое значение: оставить флаг в текущем состоянии
-Hidden		Нет	Позволяет пользователю установить или сбросить атрибут "скрытый" файлов или папки. + : установить флаг - : снять флаг Любое другое значение: оставить флаг в текущем состоянии
-OwnerDomain		Нет	Представляет домен нового владельца файла или папки.
-OwnerName		Нет	Представляет имя нового владельца файла или папки.

Диспетчер служб Windows

Этот инструмент позволяет управлять службами Windows. Он основан на специальном скрипте PowerShell системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-command	Н/Д	Да	Фиксированное значение ./ManageWindowsServices.ps1.
-Action	Действие	Да	Укажите выполняемое действие: Create: создать новую службу Config: настроить существующую службу Delete: удалить существующую службу Start: запустить службу Stop: остановить службу Restart: остановить и запустить службу
-ServiceName	ServiceName	Да	Имя службы.
-ServerName		Нет	Имя сервера, на котором будет выполнено это действие. Если не указан, будут использоваться текущий сервер.
-BinPath		Нет*	Двоичные путь и имя службы. Обязательно для действия Create, необязательно для действия Config, игнорируется для всех остальных действий.
-DisplayName		Нет	Отображаемое имя, которое будет использоваться для этой службы. Необязательно для действий Create и Config, игнорируется для всех остальных действий.
-Description		Нет	Описание, которое будет присвоено этой службе. Необязательно для действий Create и Config, игнорируется для всех остальных действий.
-UserName		Нет	Имя пользователя, используемое для учетных данных, с которыми запускается служба (должно указываться в виде ДОМЕН\ПОЛЬЗОВАТЕЛЬ). Если указано, необходимо также указать значение параметра -Password. Если не указано, по умолчанию используется учетная запись LocalSystem. Необязательно для действий Create и Config, игнорируется для всех остальных действий. Для сброса учетных данных на LocalSystem введите LocalSystem в качестве пользователя и "" в качестве пароля.
-Password		Нет	Пароль имени пользователя, указанного для запуска службы. Необязательно для действий Create и Config, игнорируется для всех остальных действий.
-StartMode		Нет	Режим запуска службы. По умолчанию служба создается с режимом запуска Automatic. Возможные варианты: Manual: служба запускается только вручную. Automatic: служба будет запущена автоматически при следующей перезагрузке компьютера. Disabled: служба отключена. Необязательно для действий Create и Config, игнорируется для всех остальных действий.

Агент развертывания баз данных DACPAC

Этот инструмент развертывает DACPAC-пакет. Он основан на служебной программе командной строки SQL Server. У этой служебной программы множество возможных параметров, но здесь перечислены только параметры, используемые для данного инструмента. Дополнительные сведения см. в описании служебной программы командной строки SqlPackage.exe. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
/Action:		Да	Фиксированное значение: Publish — указывает, что пакет будет опубликован.
/SourceFile:	FileName	Да	Полный путь (если требуется) и имя файла пакета DACPAC.
/TargetServerName:	ServerName	Да	Имя сервера SQL Server, на котором требуется опубликовать пакет.
/TargetDatabaseName:	DatabaseName	Да	Имя базы данных SQL Server, в которой требуется опубликовать пакет.

Агент развертывания IIS

Этот инструмент позволяет манипулировать объектами и настройками IIS. Он основан на специальном исполняемом файле системы управления выпусками. Переменные конфигурации этого инструмента зависят от типа выполняемых действий.

Для действий с пулом приложений:

Параметр	Переменная	Обязательно	Описание
-Action		Да	Укажите выполняемое действие: CreateApplicationPool ConfigureApplicationPool DropApplicationPool StartApplicationPool StopApplicationPool RecycleApplicationPoo
-ap		Да	Имя пула приложений.
-apAllow32Bit		Нет	Флаг, указывающий, должен ли пул приложений разрешать 32-разрядные приложения. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5. Допустимые значения: 1 или True: 32-разрядные приложения разрешены 0 или False: 32-разрядные приложения запрещены
-apIdentUserDomain		Нет	Домен пользователя, используемый для идентификации пула приложений. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5. Если он не задан, но при этом задан параметр "IdentityUserName", пользователь считается локальным (. \localuser).
-apIdentUserName		Нет	Имя пользователя, используемое для идентификации пула приложений. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5. Если он не задан, параметры "IdentityUserDomain" и "IdentityUserPassword" игнорируются и используется значение по умолчанию, принятое в IIS (т. е., ApplicationPoolIdentity).
-apIdentUserPassword		Нет	Пароль пользователя, используемый для идентификации пула приложений. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5.
-apNetVers		Нет	Версия платформы .NET Framework, используемая для пула приложений. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5. Допустимы следующие значения: v1.0, v1.1, v2.0, v4.0
-apPipelineMode		Нет	Режим управляемого конвейера для использования в пуле приложений. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5. Допустимые значения: Classic Integrated
-apProcessIdleTimeout		Нет	Время в минутах, в течение которого может простаивать процесс в пуле приложений. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5.
-apRecycleKbMemory		Нет	Максимальный объем памяти (в килобайтах), используемый, прежде чем пул приложений будет использоваться повторно. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5.
-apRecycleMinutes		Нет	Фиксированное время в минутах, по истечении которого производится повторное использование пула приложений. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5.
- apRecycleSpecificTime		Нет	Фиксированное время выполнения повторного использования пула приложений. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5. Должен использоваться формат ЧЧ:ММ (например, 23:58 или 01:23).
-apStartMode		Нет	Режим запуска, используемый для пула приложений. Этот параметр допустим только для IIS 8.0 и 8.5. Допустимые значения: OnDemand AlwaysRunning
-AutoStart		Нет	Флаг, указывающий, должен ли пул приложений запускаться автоматически. Этот параметр допустим только для IIS 7.0, 7.5, 8.0 и 8.5. Допустимые значения: 1 или True: пул приложений будет запускаться автоматически при запуске Windows. 0 или False: пул приложений не будет запускаться автоматически при запуске Windows.
-log		Нет

Для действий с веб-сайтами:

Параметр	Переменная	Обязательно	Описание
-Action		Да	Укажите выполняемое действие: CreateWebSite ConfigureWebSite DropWebSite StartWebSite StopWebSite RestartWebSite
-sn		Да	Имя веб-сайта.
-port		Нет*	Номер порта веб-сайта. Обязателен для действия создания, необязателен при конфигурировании.
-pd		Нет*	Полный путь, ведущий к расположению, где было опубликовано приложение. Обязателен для действия создания, необязателен при конфигурировании. Примечание Необходимо убедиться, что в пути нет обратных косых черт.
-ap		Нет	Имя пула приложений. Если этот параметр не указан при создании пула приложений, будет использоваться пул приложений по умолчанию. Необязательно для действий создания и конфигурирования.
-EnablePreload		Нет	Допускается в IIS 7.0, 7.5, 8.0 и 8.5. Флаг, указывающий, требуется ли предварительная загрузка веб-сайта. Необязательно для действий создания и конфигурирования. Допустимые значения: 1 или True: предварительная загрузка включена 0 или False: предварительная загрузка отключена
-AutoStart		Нет	Допускается в IIS 7.0, 7.5, 8.0 и 8.5. Флаг, указывающий, должен ли веб-сайт запускаться автоматически. Необязательно для действий создания и конфигурирования. Допустимые значения: 1 или True: запускать автоматически 0 или False: не запускать автоматически
-log		Нет	В физическом каталоге будет создан файл журнала с этим именем.

Для действий с веб-приложениями:

Параметр	Переменная	Обязательно	Описание
-Action		Да	Укажите выполняемое действие: CreateWebApplication ConfigureWebApplication DropWebApplication
-ws		Да	Имя создаваемого приложения.
-pd		Нет*	Полный путь, ведущий к расположению, где было опубликовано приложение. Обязателен для действия создания, необязателен при конфигурировании.
-sn		Нет	Имя веб-сайта. Если не указано, при создании нового приложения система будет использовать веб-сайт по умолчанию. Необязательно для действий создания и конфигурирования.
-ap		Нет	Имя пула приложений. Если этот параметр не указан при создании пула приложений, будет использоваться пул приложений по умолчанию. Необязательно для действий создания и конфигурирования.
-EnablePreload		Нет	Допускается в IIS 7.0, 7.5, 8.0 и 8.5. Флаг, указывающий, требуется ли предварительная загрузка веб-сайта. Необязательно для действий создания и конфигурирования. Допустимые значения: 1 или True: предварительная загрузка включена 0 или False: предварительная загрузка отключена
-log		Нет	В физическом каталоге будет создан файл журнала с этим именем.

Для действий с виртуальными каталогами:

Параметр	Переменная	Обязательно	Описание
-Action		Да	Укажите выполняемое действие: CreateVirtualDirectory ConfigureVirtualDirectory DropVirtualDirectory
-vd		Да	Имя виртуального каталога.
-pd		Нет*	Полный путь к виртуальному каталогу. Обязателен для действия создания, необязателен при конфигурировании.
-sn		Нет	Имя веб-сайта. Если не указано, при создании нового приложения система будет использовать веб-сайт по умолчанию. Необязательно для действий создания и конфигурирования.
-ws		Нет	Имя веб-приложения. Если не указано, при создании нового виртуального каталога система будет использовать корневое веб-приложение. Необязательно для действий создания и конфигурирования.
-log		Нет	В физическом каталоге будет создан файл журнала с этим именем.

Диспетчер виртуальных машин Microsoft Azure

Этот инструмент позволяет управлять виртуальной машиной в Microsoft Azure. Он основан на специальном скрипте PowerShell системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-command	Н/Д	Да	Фиксированное значение ./ControlAzureVM.ps1.
-Command		Да	Укажите выполняемое действие: Start: запустить виртуальную машину Stop: остановить виртуальную машину
-ServiceName	ServiceName	Да	Имя службы Microsoft Azure, в которой существует виртуальная машина.
-Name	Имя	Да	Имя виртуальной машины Microsoft Azure.

Средство развертывания XBAP

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

Параметр	Переменная	Обязательно	Описание
-pn	Имя_проекта	Да	Имя развертываемого проекта XBAP.
-d	Installation Path	Да	Путь установки для приложения XBAP.
-ml		Нет	Полный путь к исполняемому файлу утилиты mage. Если не указан, будет использоваться утилита, представленная в инструменте в виде ресурса.
-pl		Нет	Полный путь, по которому расположен развертываемый проект XBAP. Если не указан, инструмент будет использовать расположение пакета, в котором он выполняется.
-url		Нет	Если указан, система заменяет URL-адрес файла setup.exe указанным адресом.
-cf		Нет	Если указан, будет использоваться в качестве имени сертификации при обновлении манифеста.
-pwd		Нет	Если указан, будет использоваться в качестве пароля сертификации при обновлении манифеста.
-log		Нет	В физическом каталоге будет создан файл журнала с этим именем.

Служебная программа командной строки Microsoft Test Manager (MTM)

Этот инструмент создает и запускает автоматизированные тесты, выполняемые с помощью MTM (Microsoft Test Manager). Он основан на специальном скрипте PowerShell системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-command	Н/Д	Да	Фиксированное значение ./TcmExec.ps1.
-Title	TestRunTitle	Да	Имя, которое будет использоваться при создании тестового запуска.
-PlanId	PlanId	Да	Идентификатор плана тестирования, в котором должны выполняться тесты (уникальный идентификатор, определенный в Test Manager).
-SuiteId	SuiteId	Да	Идентификатор набора, который требуется выполнить (уникальный идентификатор, определенный в Test Manager).
-ConfigId	ConfigId	Да	Идентификатор тестовой конфигурации, в которой должны выполняться тесты (уникальный идентификатор, определенный в Test Manager).
-Collection	TFSCollection	Да	URL-адрес коллекции Team Foundation Server, для которой будут выполняться автоматизированные тесты.
-TeamProject	TeamProject	Да	Имя командного проекта, в котором настроены автоматизированные тесты.
-TestEnvironment	TestEnvironment	Да	Тестовая среда, в которой должны выполняться тесты (тестовая среда связана с соответствующим контроллером тестирования).
-BuildDirectory	BuildDirectory	Нет*	Расположение автоматизированных тестов. В MTM 2010 этот параметр обязателен. В MTM 2012, 2013 этот параметр по-прежнему поддерживается, но пользователям рекомендуется использовать параметры BuildDefinition и BuildNumber.
-BuildDefinition		Нет*	Позволяет пользователю указать определение сборки, в которое включены автоматизированные тесты. Этот параметр можно использовать только с MTM 2012. Если он задан, необходимо также задать параметр BuildNumber. Если он не задан, тестовый запуск не оказывает влияния на поле "сборка", отображаемое в сведениях о тестовом запуске.
-BuildNumber		Нет*	Позволяет пользователю указать номер сборки, расположение сброса которой будет содержать автоматизированные тесты. Этот параметр можно использовать только в MTM 2012. Если он задан, необходимо также задать параметр BuildDefinition. Если он не задан, тестовый запуск не оказывает влияния на поле "сборка", отображаемое в сведениях о тестовом запуске.
-SettingsName		Нет	Позволяет пользователю указать параметры, используемые для тестового запуска. Если этот параметр не задан, будут использоваться параметры по умолчанию.
-TestRunWaitDelay		Нет	Позволяет пользователю задать задержку (в секундах) между вызовами контроллера тестирования. Это необходимо, чтобы тестовый запуск успел завершиться до начала обработки результатов теста. Если значение не задано, по умолчанию используется значение 10 с.
-InconclusiveFailsTests	Н/Д	Нет	Если установлен этот флаг, при наличии тестов с неопределенным результатом развертывание завершается сбоем. По умолчанию тест с неопределенным результатом не приводит к сбою развертывания.
-RemoveIncludeParameter	Н/Д	Нет	Когда этот флаг установлен, параметр /include не добавляется в команду создания теста. Это означает, что все тесты, состояние которых отлично от "Активный", не включаются в тестовый запуск.

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

Переменная	Метаданные значения переменной
BuildDirectory	$(PackageLocation)
BuildNumber	$(BuildNumber)
BuildDefinition	$(BuildDefinition)
TFSCollection	$(TFSUrlWithCollection)
TeamProject	$(TeamProject)

Диспетчер INI-файлов

Этот инструмент изменяет содержимое INI-файла, а также может создать новый INI-файл, если это задано. Он основан на специальном исполняемом файле системы управления выпусками. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-Action		Да	Укажите выполняемое действие: ModifySection RemoveSection CreateKeyValue ModifyKeyValue RemoveKeyValue
-INIFile	INIFileName	Да	Имя и путь (при необходимости) INI-файла.
-SectionName	SectionName	Нет	Имя раздела, на который действует команда. Если этот параметр не задан, будет рассматриваться корневой раздел (все ключи, находящиеся в начале файла до первого раздела, считаются корневыми).
-NewSectionName		Нет	Новое имя раздела. Если этот параметр не задан, будет рассматриваться корневой раздел (все ключи, находящиеся в начале файла до первого раздела, считаются корневыми). Обязательно для действия ModifySection.
-KeyName		Нет	Имя ключа, на который действует команда. Обязательно для действий CreateKeyValue, ModifyKeyValue и RemoveKeyValue.
-KeyValue		Нет	Значение, используемое для ключа. Если при использовании действия ModifyKeyValue этот параметр не указан, а параметр NewKeyName указан, система использует фактическое значение. Если этот параметр не указан и параметр NewKeyName также не указан, будет задано пустое значение.
-NewKeyName		Нет	Новое имя, которое требуется присвоить ключу. Используется только в действии ModifyKeyValue.
-CreateFileIfNotExists		Нет	Указывает инструменту, что если файл не существует, его требуется создать.

Процесс Windows

Этот инструмент можно использовать для завершения процесса Windows. У этого инструмента имеются следующие переменные конфигурации:

Параметр	Переменная	Обязательно	Описание
-command	Н/Д	Да	Фиксированное значение ./WindowsProcess.ps1.
-ProcessName		Да	Имя завершаемого процесса Windows.
-UserName		Нет	Учетная запись пользователя, под которой выполняется процесс. Если не указана, процесс будет завершен для всех пользователей.
-IsKillProcessTree		Нет	Флаг, указывающий, следует ли завершить дерево процесса. Допустимые значения: 1: завершить дерево процессов 0 или пусто: не завершать дерево процессов