Консоль ProxyInspector/MailDetective

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

Внимание!
Вся информация, приведенная ниже, верна как для ProxyInspector, так и для MailDetective. Единственное отличие состоит в том, что в MailDetective исполняемый файл консоли имеет имя MDConsole.exe, а в ProxyInspector - PIConsole.exe.

Автоматизация процесса импорта лог файлов

Для автоматизации процесса импорта лог файлов служат команды -atgen, -import. С помощью команды -import выполняется собственно импорт лог файлов. С помощью команды -atgen вы можете создать .bat файл для создания заданий на импорт во встроенном планировщике NT/2K/XP(можно также использовать любые другие планировщики, например WinGate). После выполнения команды:

PIConsole.exe -atgen

в каталоге ProxyInspector будет создан файл schedule.bat приблизительно такого вида:

at 08:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import
at 10:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import
at 12:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import
at 14:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import
at 16:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import
at 18:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import
at 20:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import
at 22:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import
at 00:00 /every:M,T,W,Th,F,S,Su "C:\PROGRAM FILES\PROXYINSPECTOR FOR WINGATE\piconsole.exe" -import

откорректировав его согласно своим требованиям и запустив вы создатите задания на импорт во встроенном планировщике Windows NT/2K/XP.

По умолчанию, в момент установки ProxyInspector, производится создание файла schedule.bat путем запуска PIConsole.exe -atgen.

Для импорта нужно использовать команду PIConsole.exe -import.

Создание отчетов

С помощью консоли ProxyInspector вы можете автоматизировать создание и рассылку отчетов. Созданный отчет может быть сохранен в указанный файл либо отправлен по электронной почте. Опция создания отчетов в консоли доступна только в зарегистрированной версии программы. Для использования из консоли отчет необходимо сохранить как шаблон в Мастере создания отчетов. Формат команды создания отчета с сохранением в файл:

PIConsole.exe -report "имя_шаблона_отчета" /saveto="имя_файла" [/no_rewrite] [/group="group_name"]

Внимание! Если файл уже существует он будет перезаписан. Чтобы избежать этого используйте ключ /no_rewrite.

Формат команды для создания и отправки по почте:

PIConsole.exe -report "имя_шаблона_отчета" /mailto="адресат" [/subject="тема_письма"] [/group="group_name"]

можно указать несколько адресов, разделив их символом ';'.

Дополнительные ключи при создании/отправке отчетов:
/excel - отчет будет создан как книга MS Excel, Excel должен быть установлен на машине с ProxyInspector
/mht - отчет будет создан в формате MHT
/nocss - при сохранении/отправке в формате HTML(по умолчанию если не указан ключ /excel) включает создание отчета без использования CSS
/group="group_name" - создать отчет для каждого из членов указанной группы, заданный шаблон отчета должен быть шаблоном отчета для одного пользователя(любого). Данная опция отсутствует в ProxyInspector for WinProxy и семействе продуктов MailDetective.

Управление базой данных

При удалении записей в базе данных с помощью команды База | Удалить записи, фактически записи только помечаются как удаленные. Что может привести к нерациональному использованию дискового пространства. Чтобы действительно произвести удаление используйте PIConsole.exe -packdb. Данная команда может быть использована только при работе с локальной БД, если вы работате с SQL сервером, то вам необходимо воспользоваться встроенными средствами сервера.

Исправление ошибок в локальной БД:
PIConsole.exe -repair_pdx

Симптомами являются ошибки "Key violation", "Blob has been modified" возникающие при поптыке импорта или создания отчета.

ProxyInspector for ISA Server Enterprise edition

Для синхронизации с Active Directory из консоли нужно использовать ключ -adsync , возможные параметры:
/users - синхронизировать свойства пользователей
/groups - синхронизировать список групп
/groups /repl - синхронизировать список групп в режиме замены

ключи /users и /groups можно использовать одновременно.

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

Пример:
PIConsole.exe -adsync /users /groups /repl


Протоколы работы консоли

При кажом запуске консоли в каталоге <Documents and Settings>\All Users\Application Data\ADVSoft\Program name\logs создается файл протокола(название вида consoleddmmyyhhmmss.log) в который записываются все информационные сообщения и сообщения об ошибках.

Иногда бывает необходимо отключить вывод сообщений на экран, в этом случае необходимо указать ключ -silent. Файл протокола будет создан также и при запуске с ключом -silent. Файлы протоколов хранятся 7 дней после чего автоматически удаляются.