Поделиться через

Export-Counter

  • Ссылка
Модуль:
Microsoft.PowerShell.Diagnostics

Экспортирует данные счетчика производительности в файлы журнала.

Синтаксис

Export-Counter
      [-Path] <String>
      [-FileFormat <String>]
      [-MaxSize <UInt32>]
      -InputObject <PerformanceCounterSampleSet[]>
      [-Force]
      [-Circular]
      [<CommonParameters>]

Описание

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

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

Этот командлет работает только в Windows 7, Windows Server 2008 R2 и более поздних версиях Windows.

Примеры

ПРИМЕР 1. Экспорт данных счетчика в файл

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

Get-Counter "\Processor(*)\% Processor Time" | Export-Counter -Path $HOME\Counters.blg

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

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

Пример 2. Экспорт файла в формат файла счетчика

В этом примере CSV-файл преобразуется в формат BLG счетчиков.

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

$1GBInMB = 1024 # 1GB = 1024MB
Import-Counter Threads.csv | Export-Counter -Path ThreadTest.blg -Circular -MaxSize $1GBInMB

Пример 3. Получение данных счетчика с удаленного компьютера и сохранение данных в файл

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

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

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

$C = Get-Counter -ComputerName Server01 -Counter "\Process(*)\Working Set - Private" -MaxSamples $C | Export-Counter -Path \\Server01\Perf\WorkingSet.blg

20

Пример 4. Повторное ведение журнала существующих данных

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

Первая команда использует командлет Import-Counter для импорта данных счетчика производительности из журнала DiskSpace.blg. Он сохраняет данные в переменной $All. Этот файл содержит примеры счетчика "Логическийdisk% свободное место" на более чем 200 удаленных компьютерах в организации.

Вторая команда использует командлет Where-Object для выбора объектов с CookedValue менее 15 (процент). Команда сохраняет результаты в переменной $LowSpace.

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

$All = Import-Counter DiskSpace.blg
$LowSpace = $All | Where-Object {$_.CounterSamples.CookedValue -lt 15}
$LowSpace | Export-Counter -Path LowDiskSpace.blg

Параметры

-Circular

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FileFormat

Задает выходной формат выходного файла журнала.

Допустимые значения для этого параметра:

  • CSV
  • TSV
  • BLG

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Force

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

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

Тип:PerformanceCounterSampleSet[]
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-MaxSize

Указывает максимальный размер выходного файла в мегабайтах (МБ).

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

Тип:UInt32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Path

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

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

Тип:String
Aliases:PSPath
Position:1
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

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

PerformanceCounterSampleSet

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

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

None

Примечания

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

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

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

Командлет Import-Counter не имеет параметра ComputerName. Однако если компьютер настроен для удаленного windows PowerShell Windows PowerShell, можно использовать командлет Invoke-Command для выполнения команды Import-Counter на удаленном компьютере.