Синтаксис модификаторов

[-s имя_компьютера] [-config имя_файла] [-b М/д/гггг ч:мм:сс[AM | PM]] [-e М/д/гггг ч:мм:сс[AM | PM]] [-m [start] [stop]] [-[-]r] [-o {путь | DSN!журнал_счетчиков}] [-f {bin | bincirc | csv | tsv |SQL}] [-[-]a] [-[-]v [{nnnnn | ммддччмм}]] [-[-] rc [имя_файла]] [-[-] max {значение}] [-[-]cnf [[[чч:]]мм:]сс] [-c {путь [путь ...] | -cf имя_файла}] [-si [[чч:]мм:]сс] [-ln имя_сеанса] [-ets] [-[-] rt] [-p {GUID | поставщик [(флаги [,флаги...]}] уровень | -pf имя_файла}] [-[-] ul] [-bs значение] [-ft [[чч:]мм:]сс] [-nb мин макс] [-fd имя_сеанса] [-[-]u пароль_пользователя] [-rf [[чч:]мм:]сс] [-y] [-mode {режим_трассировки [режим трассировки ...]}]

Параметры

-s имя_компьютера

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

-config имя_файла

Задает путь к файлу, содержащему Параметры командной строки.

-b М/д/гггг ч:мм:сс[AM | PM]

Указывает время (в 24-часовом формате) начала записи выборки данных. Можно задать время в 12-часовом формате, добавив в командную строку параметр AM или PM. По умолчанию используются текущие день и время, если не заданы другие данные. Чтобы немедленно начать выборку, воспользуйтесь возможностью запуска вручную.

-e М/д/гггг ч:мм:сс[AM | PM]

Указывает время (в 24-часовом формате) завершения записи выборки данных. Можно задать время в 12-часовом формате, добавив в командную строку параметр AM или PM. По умолчанию используются текущие день и время, если не заданы другие данные. Используйте остановку вручную, а затем параметр повтора, чтобы установить значение времени завершения меньше значения текущего времени, иначе будет выдано сообщение об ошибке.

-m start stop

Определяет, что выборки будут запускаться и останавливаться вручную в командной строке с помощью параметров start и stop. Невозможно вместе использовать Параметры -m start и -bили -m stop и -e или -rf в одном запросе.

-r

Производит повторную запись выборки данных каждый день в течение интервала времени, задаваемом параметрами -b и -rf или параметрами –b и –e. Эта команда действительна только для интервалов, время начала и окончания которых приходится на один и тот же день, месяц и год.

--r

Выключает параметр повторения записи.

-o {путь | DSN!журнал_счетчиков}

Указывает путь к файлу, в котором записываются данные счетчиков производительности или данные трассировки, или местоположение базы и набора данных SQL. Чтобы база данных SQL использовала формат «DNS!журнал_счетчиков», введите в командной строке ключ -f. По умолчанию в качестве имени файла журнала используется имя выборки с расширением .blg для счетчиков производительности или .etl для данных трассировки.

-f {bin | bincirc | csv | tsv | SQL}

Указывает формат файла, используемый для сбора данных счетчиков производительности и данных трассировки. Для журнала может быть выбран один из следующих форматов: двоичный, циклический двоичный, текст с разделителями-запятыми и текст с разделителями-знаками табуляции, а также формат базы данных SQL. С параметром «DNS!;журнал_счетчиков» следует использовать в командной строке ключ -o. Для форматов базы данных SQL должно быть заранее определено имя источника данных (DSN), а пользователь должен иметь право записи в эту базу данных. Набор данных журнал_счетчиков создается в базе данных и определяется DSN. По умолчанию используется двоичный формат.

-a

Этот параметр используется для записи в конец файла.

--a

Выключает режим записи в конец и возвращает систему к режиму перезаписи.

-v {nnnnn | ммддччмм}

Добавляет данные контроля версий в конец выходного файла и пути. Используйте для контроля версий числовой формат nnnnn или формат даты ммддччмм, включающий месяц, день, час (в 24-часовой нотации) и минуты.

--v

Выключает параметр добавления данных контроля версий.

-rc имя_файла

Запускает эту команду после после того, как файл был закрыт при достижении его конца или во время выборки. Чтобы закрывать файлы во время выборки, используйте ключ -rfсовместно с ключом -cnf. Использование ключа -stop отключит этот режим. Команды всегда выполняются в активном режиме.

--rc

Выключает режим закрытия файлов во время выборки.

-max значение

Указывает максимальный размер файла журнала в мегабайтах. Если размер журнала превышает максимальный, накопление данных прекращается. Для базы данных SQL максимальный размер представляет максимальное число записей.

--max

Выключает ограничение на размер журнала. Этот параметр используется по умолчанию.

-cnf [[чч:]мм:]сс

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

--cnf

Выключает параметр создания нового файла журнала.

-c {путь [путь...] | -cf имя_файла}

Указывает путь к журналу для счетчика производительности или путь и имя файла журнала, в котором содержится список этих счетчиков. Чтобы задать несколько путей счетчиков, используйте пробел для разделения командной строки или параметр -cf, чтобы ввести список путей счетчиков из входного файла (по одному в строке).

Общий формат для путей счетчиков выглядит следующим образом: [\\компьютер]\объект[родительский_объект/экземпляр#индекс]\счетчик], где:

Компоненты «родительский_объект», «экземпляр», «индекс» и «счетчик» могут содержать допустимое имя или подстановочный знак. Компоненты «компьютер», «родительский_объект», «экземпляр» и «индекс» не являются необходимыми для всех счетчиков.

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

\логический_диск(*/*#*)\*

Для объекта процесс не требуется задавать индекс экземпляра. Таким образом, можно использовать следующий формат.

\процесс(*)\идентификатор_процесса

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

• \\компьютер\объект(родительский_объект/экземпляр#индекс)\счетчик
• \\компьютер\объект(родительский_объект/экземпляр)\счетчик
• \\компьютер\объект(экземпляр#индекс)\счетчик
• \\компьютер\объект(экземпляр)\счетчик
• \\компьютер\объект\счетчик
• \объект(родительский_объект/экземпляр#индекс)\счетчик
• \объект(родительский_объект/экземпляр)\счетчик
• \объект(экземпляр#индекс)\счетчик
• \объект(экземпляр)\счетчик
• \объект\счетчик

Если подстановочный знак используется в имени родительского объекта, будут возвращены все экземпляры указанного объекта, соответствующие заданным полям «экземпляр» и «счетчик».

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

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

Частичное совпадение пути счетчика (например «pro*») не поддерживается.

-si [[чч:]мм:]сс

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

-ln имя_сеанса

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

-ets

Создает и запускает сеанс трассировки событий с помощью параметров, определенных в командной строке. Имеется возможность использовать этот дополнительный параметр вместе с действиями create trace, update, query и delete.

-rt

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

--rt

Выключает параметр работы в режиме реального времени.

-p {GUID | поставщик [(флаги[,флаги ...])] уровень] | -pf {имя_файла}

Указывает поставщиков (выборщиков данных трассировки), которых можно использовать для накопления данных трассировки. Используйте поставщиков запросов logman, чтобы найти параметр pname (поставщики с именем) в списке зарегистрированных поставщиков. Чтобы перечислить нескольких поставщиков, используйте ключ -pf. Ключ -pf определяет входной файл, содержащий имена поставщиков. Имена поставщиков заключаются в кавычки ("") или в коды GUID в фигурных скобках, маски флагов и целые числа (уровень разрешения). Флаги используются или в шестнадцатеричном (OXFFFF) формате или в формате (флаг, флаг).

-ul

Указывает, что сеанс трассировки событий выполняется в пользовательском режиме. При использовании ключа -ul только один поставщик может быть включен для сеанса трассировки событий.

--ul

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

-bs значение

Указывает размер буфера (в килобайтах) для выборок данных трассировки.

-ft [[чч:]мм:]сс

Указывает интервал таймера сброса (в минутах и секундах) для выборок данных трассировки.

-nb мин макс

Указывает минимальное и максимальное число буферов для выборки данных трассировки. Минимальное значение по умолчанию равно числу процессоров системы плюс два. Максимальное значение по умолчанию равно 25.

-fd имя_сеанса

Сбрасывает все активные буферы существующего сеанса трассировки событий на диск. Используйте эту команду вместе с ключом -ln.

-u пароль_пользователя

Указывает имя учетной записи и пароль, которые используются запросом на выборку данных на локальном и удаленных компьютерах. Чтобы начать сбор данных по запросам на выборку данных, откройте оснастку «Оповещения и журналы производительности» для удаленного компьютера. Можно использовать символ * в качестве пароля в командной строке, чтобы было предложено ввести пароль.

--u

Восстанавливает имя учетной записи в службе «Оповещения и журналы производительности».

-rf [[чч:]мм:]сс

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

-y

Перезаписывает Параметры имени выборки, а затем применяет новые Параметры без запроса конечного пользователя.

-mode {режим_трассировки [режим_трассировки ...]}

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

/?

Отображает справку в командной строке.

Примечания

• Ниже перечислены допустимые Параметры для действий командной строки create, update, start, stop, delete и query.

-s имя_удаленного_компьютера

-[-]u домен/пароль_пользователя

• Ниже перечислены допустимые Параметры для действий create и update и общие ключи для аргументов счетчик и трассировка.

-y

-b М/д/гггг ч:мм:сс [AM|PM]

-e М/д/гггг ч:мм:сс [AM|PM]

-rf чч:мм:сс

-m start stop

-f bin|bincirc

-[-]r

-o путь

-[-]a

-[-]v nnnnn|ммддччмм

-[-]rc команда путь

-[-]max n

-[-]cnf чч:мм:сс

• Для аргумента счетчики существует всего два общих параметра:

-f bin|bincirc|csv|tsv|SQL

-o путь | DSN!журнал_счетчиков

• Для действия create счетчик существует всего два общих параметра:

-c путь_счетчика | -cf входной_файл

-si [[чч:]мм:]сс

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

• Ниже перечислены Параметры выборки данных трассировки для действия update.

- max n

- o путь

-ft мм:сс

-fd

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

• Для аргумента счетчики существует всего два допустимых параметра:

-f bin|bincirc|csv|tsv|SQL

-o путь | DSN!журнал_счетчиков

• Для действия create счетчик существует всего две допустимых команды:

путь_счетчика | -cf входной_файл

-si чч:мм:сс

• Ниже перечислены допустимые команды для действия create трассировка.

-ln имя_сеанса

-[-]rt

-p Guid | поставщик (флаги[,флаги ...]) уровень | -pf имя_файла

-[-]ul

-bs n

-ft мм:сс

-nb мин макс

-fd имя_сеанса

-ets

• Использование параметра -config

Содержимое файла настроек, используемого с параметром -config, должно иметь следующий формат:

[параметр_команды]

значение

где параметр_команды — параметр командной строки, а значение — его значение. Например:

[create]

counter logx

[-s]

mysystem

[-u]

mypassword

• Использование параметра -mode

Этот параметр следует использовать только опытным пользователям.

• Управление системным монитором

Можно использовать команду Logman для управления системами Windows 2000 и Windows XP.

• Дополнительные сведения о включении команды Logman в сценарии инструментария управления Windows см. ссылку Scripting Logs and Monitoring на веб-узле Microsoft WindowsResource Kits.(http://www.microsoft.com/)

Примеры

Форматы данных в следующих примерах используются только с местным временем США.

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

Logman create counter daily_perf_log -b 7/27/2000 13:00:00 -e 7/27/2000 15:00:00 -r -v mmddhhmm -c "\Processor(_Total)\% Processor Time" "\Memory\Available bytes" -si 00:15 -o "c:\perflogs\daily_log"

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

Logman create counter daily_perf_log -b 7/27/2000 13:00:00 -e 7/27/2000 15:00:00 -r -o "c:\perflogs\daily_log" -v mmddhhmm -c "\Processor(_Total)\% Processor Time" "\Memory\Available bytes" -si 00:15

Чтобы создавать ежедневные запросы на выборку данных с помощью файла config, а не файла командной строки, введите следующее.