Export-Counter
Экспортирует данные счетчика производительности в файлы журнала.
Синтаксис
Default (по умолчанию)
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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-FileFormat
Задает выходной формат выходного файла журнала.
Допустимые значения для этого параметра:
CSVTSVBLG
Значение по умолчанию — BLG.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Force
Перезаписывает и заменяет существующий файл, если он существует в расположении, указанном параметром пути.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-InputObject
Указывает в виде массива данные счетчика для экспорта. Введите переменную, содержащую данные или команду, которая получает данные, например командлет Get-Counter или Import-Counter.
Свойства параметра
| Тип: | |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-MaxSize
Указывает максимальный размер выходного файла в мегабайтах (МБ).
Если указан параметр циклического, то при достижении указанного максимального размера файл журнала старые записи удаляются при добавлении новых. Если параметр циклического не указан, то при достижении указанного максимального размера файл журнала не добавляется новых данных, а командлет создает ошибку без завершения.
Свойства параметра
| Тип: | UInt32 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Path
Указывает путь и имя файла выходного файла. Введите относительный или абсолютный путь на локальном компьютере или UNC-путь к удаленному компьютеру, например \\Computer\Share\file.blg. Этот параметр является обязательным.
Формат файла определяется значением параметра FileFormat, а не расширением имени файла в пути.
Свойства параметра
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | PSPath |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.
Входные данные
PerformanceCounterSampleSet
Вы можете передать данные счетчика производительности из Get-Counter или Import-Counter в этот командлет.
Выходные данные
None
Примечания
Генератор файлов журнала ожидает, что все входные объекты имеют одинаковый путь счетчика и что объекты упорядочивается в порядке возрастания.
Тип счетчика и путь первого входного объекта определяет свойства, записанные в файле журнала. Если другие входные объекты не имеют значения для записанного свойства, поле свойства пусто. Если объекты имеют значения свойств, которые не были записаны, дополнительные значения свойств игнорируются.
Монитор производительности может не считывать все журналы, которые Export-Counter генерируют. Например, монитор производительности требует, чтобы все объекты имели одинаковый путь и что все объекты разделены одинаковым интервалом времени.
Командлет Import-Counter не имеет параметра ComputerName. Однако если компьютер настроен для удаленного windows PowerShell Windows PowerShell, можно использовать командлет Invoke-Command для выполнения команды Import-Counter на удаленном компьютере.
