Командлет Export-Counter получает объекты PerformanceCounterSampleSet и экспортирует их в файлы журналов счетчиков.

Синтаксис

Export-Counter [-Path] <string> -InputObject <PerformanceCounterSampleSet[]> [-Circular <switch>] [-FileFormat <string>] [-Force <switch>] [-MaxSize <int>] [<CommonParameters>]

Описание

Командлет Export-Counter экспортирует данные счетчиков производительности (объекты PerformanceCounterSampleSet) в файлы журналов в формате двоичного журнала производительности (BLG), значений, разделенных запятыми (CSV) и значений, разделенных табуляциями (TSV). Этот командлет можно использовать для записи и перезаписи в журнал данных счетчиков производительности.

Командлет Export-Counter предназначен для экспорта данных, возвращаемых командлетами Get-Counter и Import-Counter.

Примечание. Командлет Export-Counter работает только в Windows 7, Windows Server 2008 R2 и последующих версиях Windows.

Параметры

-Circular <switch>

Указывает, что выходной файл должен быть циклическим файлом в формате "первым вошел, первым вышел" (FIFO). При использовании этого параметра требуется параметр MaxSize.

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-FileFormat <string>

Задает формат вывода выходного файла журнала. Допустимые значения: CSV, TSV и BLG. По умолчанию используется значение BLG.

Обязательно?

false

Позиция?

named

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

BLG

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Force <switch>

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

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-InputObject <PerformanceCounterSampleSet[]>

Задает экспортируемые данные счетчика. Введите переменную, содержащую данные, либо команду, получающую данные, например Get-Counter или Import-Counter.

Обязательно?

true

Позиция?

named

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

Принимать входные данные из конвейера?

true (ByValue)

Принимать подстановочные знаки?

false

-MaxSize <int>

Задает максимальный размер выходного файла.

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

Обязательно?

false

Позиция?

named

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

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

-Path <string>

Задает путь и имя выходного файла. Введите относительный или абсолютный путь на локальном компьютере или UNC-путь на удаленном компьютере, например \\Computer\Share\file.blg. Это обязательный параметр.

Примечание. Формат файла определяется значением параметра FileFormat, а не расширением имени файла в пути.

Обязательно?

true

Позиция?

2

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

Принимать входные данные из конвейера?

false

Принимать подстановочные знаки?

false

<CommonParameters>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

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

Входные данные

Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet

Данные счетчиков производительности можно передать из командлета Get-Counter или Import-Counter в командлет Export-Counter по конвейеру.

Выходные данные

Нет

Примечания

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

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

Не все журналы, созданные командлетом Export-Counter, могут быть считаны системным монитором. Например, для системного монитора требуется, чтобы все объекты имели одинаковый путь и были разделены одинаковым временным интервалом.

В командлете Import-Counter не предусмотрен параметр ComputerName. Однако, если компьютер настроен на удаленное взаимодействие в Windows PowerShell, с помощью командлета Invoke-Command можно запускать команду Import-Counter на удаленном компьютере.

Пример 1

C:\PS># Export-Counter

Описание
-----------
Эта команда экспортирует данные счетчика в файл BLG.

Команда с помощью командлета Get-Counter получает данные о загруженности процессора. Данные передается командлету Export-Counter с помощью оператора конвейера (|). Для указания выходного файла в команде Export-Counter используется параметр Path.

C:\PS> get-counter "\Processor(*)\% Processor Time" -max 50 | export-counter -path $home\counters.blg

Так как объем этих данных может быть очень большим, эта команда передает данные командлету Export-Counter по конвейеру. Если бы данные сохранялись в переменной, команда могла бы использовать непропорционально большой объем памяти.






Пример 2

C:\PS># Export-Counter

Описание
-----------
Эти команды преобразуют файл CSV в формат BLG данных счетчика. 

Первая команда использует встроенное средство преобразования Windows PowerShell для сохранения значения 1 ГБ, выраженного в байтах, в переменной $1GBinBytes. При вводе значения, сопровождаемого словом "K" (килобайт), "MB" (мегабайт) или "GB" (гигабайт), оболочка Windows PowerShell возвращает значение в байтах.

C:\PS> $1GBinBytes = 1GB


Вторая команда с помощью командлета Import-Counter импортирует данные счетчиков производительности из файла Threads.csv. В этом примере предполагается, что файл ранее был экспортирован с помощью командлета Export-Counter.

Импортированные данные передаются командлету Export-Counter с помощью оператора конвейера (|). Команда использует параметр Path для указания местоположения выходного файла. В ней используются параметры Circular и MaxSize, чтобы командлет Export-Counter создал циклический журнал размером 1 ГБ.

C:\PS> import-counter threads.csv | export-counter -path threadtest.blg -circular -maxsize $1GBinBytes






Пример 3

C:\PS># Export-Counter

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


Первая команда с помощью командлета Get-Counter собирает данные счетчика рабочего набора от удаленного компьютера Server01. Команда сохраняет данные в переменной $c.

C:\PS> $c = get-counter -computername Server01 -counter "\Process(*)\Working Set - Private" -maxSamples 20



Вторая команда с помощью оператора конвейера (|) передает данные, сохраненные в переменной $c, командлету Export-Counter, который сохраняет их в файле Workingset.blg в общей папке Perf на компьютере Server01.

C:\PS> $c | export-counter -path \\Server01\Perf\WorkingSet.blg






Пример 4

C:\PS># Export-Counter

Описание
-----------
В этом примере показано, как использовать командлеты Import-Counter и Export-Counter для повторной регистрации существующих данных в журнале.

Первая команда с помощью командлета Import-Counter импортирует данные счетчиков производительности из журнала DiskSpace.blg. Данные сохраняются в переменной $all. Этот файл содержит выборки счетчика "LogicalDisk\% Free Space", полученные от более чем 200 удаленных компьютеров.

C:\PS> $all = import-counter DiskSpace.blg


Вторая команда с помощью свойства CounterSamples объекта набора выборок, сохраненного в переменной $all, и командлета Where-Object (псевдоним "where") выбирает объекты, у которых значение свойства CookedValues меньше 15 (секунд). Результаты сохраняются в переменной $lowSpace.

C:\PS> $lowSpace = $all.countersamples | where {$_.cookedvalues -lt 15}


Третья команда с помощью оператора конвейера (|) передает данные из переменной $lowSpace в командлет Export-Counter. Параметр path указывает, что выбранные данные необходимо регистрировать в файле LowDiskSpace.blg.

C:\PS> $lowSpace | export-counter -path LowDiskSpace.blg






См. также