SendFaxMS.exe является утилитой командной строки и предназначена для автоматического создания факса и его дальнейшего отслеживания, при использовании службы факсов Windows и приложения Факсы и сканирование Windows. Может быть использована в различных сценариях, например в bat-файлах или в пользовательских приложениях. Помогает автоматизировать процесс отправки факсов.

Вы можете найти SendFaxMS.exe в папке установки Fax Voip T.38 Модем. Это приложение использует библиотеки Fax Voip T.38 Модем, и поэтому должно находиться в папке, где установлен Fax Voip T.38 Модем. Не следует перемещать SendFaxMS.exe в другую папку.

Для конструирования командной строки и тестирования SendFaxMS.exe, откройте Панель управления Fax Voip T.38 Модем, в дереве нажмите Факс, а затем нажмите SendFaxMS.exe (MS Fax), см. главу Настройка и запуск SendFaxMS.exe (Microsoft Fax) из панели управления Fax Voip T.38 Модем настоящего справочного руководства.

Пример использования в bat-файле можно найти в следующем файле:

*{CommonAppDataFolder}\FaxVoip Modem\SendFaxMS\Sample\SendFaxMS_test.bat

использование (графический режим): SendFaxMS.exe [параметры]

использование (режим консоли): SendFaxMS_c.exe [параметры]

Получатели факса:

Чтобы отправить факс одному получателю, используйте параметры /FaxNumber и /RecipientName. Для отправки факса нескольким получателям, используйте параметр /RecipientList.

/FaxNumber=value

Номер факса получателя.

/RecipientName=value

Имя получателя. Отображается на титульной странице.

/RecipientList=value

Полный путь к текстовому файлу, в котором содержится список получателей факса. Каждая строка соответствует одному получателю. Можно задать не только номер факса, но и имя получателя, например, 74957721234<Иван Петров>.

Отправляемые документы:

Для отправки единственного документа, используйте параметр /FileName. Чтобы отправить несколько документов, используйте параметр /FileList. Чтобы отправить факс, состоящий только из титульной страницы, пропустите эти параметры и укажите '/CoverPage=true'.

/FileName=value

Полный путь к документу, который будет отправлен в качестве факса.

/FileList=value

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

/DocumentName=value

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

Параметры титульной страницы:

/CoverPage=value

Переопределяет параметр 'Прикреплять титульную страницу к факсу', см. главу Титульные страницы (SendFaxMS.exe) - Microsoft Fax.

/CoverPage=true

Прикрепить титульную страницу к факсу. Обязательный параметр при отправке факса, состоящего только из титульной страницы.

/CoverPage=false

Не прикреплять титульную страницу к факсу.

/CoverInfo=value

Полный путь к пользовательскому ini-файлу с информацией для титульной страницы. Переопределяет значения по умолчанию, см. главы Титульные страницы (SendFaxMS.exe) - Microsoft Fax и Сведения об отправителе (SendFaxMS.exe) - Microsoft Fax.

Структура ini-файла следующая:

[Template]

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

UseServerCoverPage=

1 - стандартный шаблон; 0 - пользовательский шаблон

CoverPageName=

Имя титульной страницы (confident, fyi, generic, urgent) или путь к файлу шаблона.

[Sender]

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

SdrName=

Имя отправителя.

SdrFaxNumber=

Номер факса отправителя.

SdrEmail=

Адрес электронной почты отправителя. Может быть переопределен с помощью параметра /SdrEmail. Этот адрес может быть обработан функцией Почта-на-факс - Microsoft Fax (уведомления о доставке на адрес электронной почты отправителя).

SdrCompany=

Название организации отправителя. Передается в верхней части каждой страницы факса. Можно переопределить с помощью параметра /FaxHeader.

SdrDepartment=

Имя отдела отправителя.

SdrTitle=

Должность отправителя.

SdrOfficeLocation=

Номер офиса (комнаты) отправителя.

SdrHomePhone=

Номер домашнего телефона отправителя.

SdrOfficePhone=

Номер рабочего телефона отправителя.

SdrAddress=

Адрес отправителя. Для переноса строк используйте символ '\n'.

SdrBillingCode=

Код биллинга, связанный с отправителем.

SdrTsid=

Идентификатор передающей станции (TSID) для устройства отправителя. Передается в верхней части каждой страницы факса. Может быть переопределен с помощью параметра /FaxStationID.

[Content]

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

CoverPageSubject=

Тема факса.

CoverPageNote=

Примечание к титульной странице. Для переноса строк используйте символ '\n'.

Параметры факса (переопределения):

/FaxStationID=value

Идентификатор передающей станции (TSID) для устройства отправителя. Передается в верхней части каждой страницы факса. Переопределяет TSID, указанный в 'Сведениях об отправителе', включая штатные настройки службы факсов Windows.

/FaxHeader=value

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

/SdrEmail=value

Адрес электронной почты отправителя. Переопределяет адрес эл. почты, указанный в 'Сведениях об отправителе', включая штатные настройки службы факсов Windows. Этот адрес может быть обработан функцией Почта-на-факс - Microsoft Fax (уведомления о доставке на адрес электронной почты отправителя).

Важность и время отправки факса:

/Priority=value

Приоритет, используемый при отправке факса.

/Priority=Low

Низкий приоритет.

/Priority=Normal

Обычный приоритет (по умолчанию).

/Priority=High

Высокий приоритет.

/Discount

Отправить факс во время действия льготного тарифа.

/Schedule=value

Отправить факс не раньше указанной даты и времени. Формат даты и времени должен соответствовать настройкам вашей операционной системы, например 25.04.2022 22:15:30 Если этот параметр не используется либо дата/время не могут быть распознаны, будут использованы текущие значения даты и времени.

Параметры TIFF (применяются только при прямой конвертации в факс):

/AutoRotate=value

Переопределяет значение по умолчанию заданное в Параметрах конвертации в факс.

/AutoRotate=true

Применить алгоритм автоматического выбора ориентации.

/AutoRotate=false

Не использовать автоматический выбор ориентации.

/A4Page=value

Переопределяет значение по умолчанию заданное в Параметрах конвертации в факс.

/A4Page=true

Установить ширину и высоту страницы в формате A4.

/A4Page=false

Не контролировать высоту страницы.

/HALFTONE=value

Переопределяет значение по умолчанию заданное в Параметрах конвертации в факс.

/HALFTONE=true

Использовать полутона при конвертации в факс.

/HALFTONE=false

Не использовать полутона при конвертации.

Параметры конвертации (принудительные режимы):

/ForceDirectConvert

Создавать факс с использованием Прямой Конвертации. Настройки заданные в Параметрах конвертации в факс игнорируются. Может применяться только со следующими типами файлов: pdf, tif(tiff), sff, qfx, bmp, jpg(jpeg), gif, png, ico, wmf(emf).

/ForcePrint

Создавать факс путем печати на принтер факсов. Настройки заданные в Параметрах конвертации в факс игнорируются. При неудаче, утилита попытается создать факс с использованием функции Прямой Конвертации.

Уведомление на e-mail (оригинал):

Оригинальные уведомления о доставке - функционал службы факсов Windows, доступный только в ОС Windows Server. При отправке почты SSL не поддерживается.

/EmailReceiptMS=value

Переопределяет значение по умолчанию заданное в Параметрах уведомлений о доставке на е-mail - оригинал (SendFaxMS.exe) - Microsoft Fax.

/EmailReceiptMS=true

Отправить уведомление о доставке по эл. почте.

/EmailReceiptMS=false

Не отправлять уведомление о доставке по эл. почте.

/ReceiptAddressMS=value

Адрес электронной почты, на который служба факсов должна отправить уведомление о доставке факса. Переопределяет адрес эл. почты по умолчанию, заданный в Параметрах уведомлений о доставке на е-mail - оригинал (SendFaxMS.exe) - Microsoft Fax.

/GroupReceiptMS=value

Переопределяет значение по умолчанию заданное в Параметрах уведомлений о доставке на е-mail - оригинал (SendFaxMS.exe) - Microsoft Fax.

/GroupReceiptMS=true

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

/GroupReceiptMS=false

Отправлять индивидуальные уведомления для каждого получателя факса.

/ReceiptAttachFaxMS=value

Переопределяет значение по умолчанию заданное в Параметрах уведомлений о доставке на е-mail - оригинал (SendFaxMS.exe) - Microsoft Fax.

/ReceiptAttachFaxMS=true

Вложить копию отправленного факса.

/ReceiptAttachFaxMS=false

Не вкладывать копию отправленного факса.

Параметры отслеживания факса:

/Track

Отслеживание отправки факса. Этот параметр игнорируется при отправке факса нескольким получателям.

/JobID=value

Не создавать новый факс. Только отслеживать ранее созданный факс. Необходимо указать действительный идентификатор отслеживаемого факса (код задания). При использовании этого параметра все вышеперечисленные параметры игнорируются.

Параметры консоли:

Для работы в режиме консоли запускайте приложение SendFaxMS_c.exe.

/DoNotCloseConsole

Не закрывать консоль после выполнения. Будет отображено сообщение 'Для продолжения нажмите любую клавишу . . .'

/Console

Используя этот параметр, можно запустить приложение SendFaxMS.exe (версия с графическим интерфейсом) в режиме консоли. Обратите внимание, что вызывающее приложение не ожидает завершения работы консоли в этом случае. Вместо этого запускайте приложение SendFaxMS_c.exe.

Журналы и отладка:

/DebugLog

Включить журнал отладки, содержащий подробную информацию о работе SendFaxMS.exe.

Путь к файлу журнала: *{CommonAppDataFolder}\FaxVoip Modem\log\SendFaxMS_Debug.txt

/Log

Включить простой журнал, содержащий краткую информацию о работе SendFaxMS.exe.

Путь к файлу журнала: *{CommonAppDataFolder}\FaxVoip Modem\log\SendFaxMS_Log.txt

Примеры:

 SendFaxMS.exe /FaxNumber=13607451257 /RecipientName=Andre Hedges /CoverPage=true

/CoverInfo=C:\ProgramData\FaxVoip Modem\SendFaxMS\Sample\coverpage_test.ini /Track /DebugLog /Log

 SendFaxMS_c.exe /FaxNumber=14251234567 /RecipientName=Bob Linkermann /CoverPage=true

/FileName=C:\ProgramData\FaxVoip Modem\SendFaxMS\Sample\testPDF.pdf

/Priority=High /ForceDirectConvert /Track /DoNotCloseConsole /DebugLog /Log

  SendFaxMS_c.exe /RecipientList=C:\ProgramData\FaxVoip Modem\SendFaxMS\Sample\Recipients_test.txt

/FileList=C:\ProgramData\FaxVoip Modem\SendFaxMS\Sample\FileList_test.txt

/FaxStationID=1(425)987-6543 /FaxHeader=This is my company /DoNotCloseConsole /DebugLog /Log

Примечания

• *{CommonAppDataFolder} - системная папка содержащая данные приложений, общая для всех пользователей компьютера. Путь к этой папке обычно C:\ProgramData.