Командлет 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
См. также