Export-Counter

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

Export-Counter cmdlet은 성능 카운터 데이터(PerformanceCounterSampleSet 개체)를 이진 성능 로그(.blg), 쉼표로 구분된 값(.csv) 또는 탭으로 구분된 값(.tsv) 형식의 파일로 내보냅니다. 이 cmdlet을 사용하여 성능 카운터 데이터를 기록합니다.

Export-Counter cmdlet은 Get-Counter 및 Import-Counter cmdlet에서 반환되는 데이터를 내보내도록 설계되었습니다.

이 cmdlet은 Windows 7, Windows Server 2008 R2 이상 버전의 Windows에서만 실행됩니다.

이 예제에서는 카운터 데이터를 BLG 파일로 내보냅니다.

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

이 명령은 Get-Counter cmdlet을 사용하여 프로세서 시간 데이터를 수집합니다. 파이프라인 연산자(|)를 사용하여 데이터를 Export-Counter cmdlet으로 보냅니다. Export-Counter 명령은 Path 변수를 사용하여 출력 파일을 지정합니다.

데이터 집합이 매우 클 수 있으므로 이 예제에서는 파이프라인을 통해 데이터를 Export-Counter 보냅니다. 데이터가 변수에 저장된 경우 불균형한 양의 메모리를 사용할 수 있습니다.

다음은 CSV 파일을 카운터 데이터 BLG 형식으로 변환하는 예제입니다.

Import-Counter cmdlet은 Threads.csv 파일에서 성능 카운터 데이터를 가져옵니다. 이 예제에서는 이 파일이 이전에 Export-Counter cmdlet을 사용하여 내보낸 것으로 가정합니다. 파이프라인 연산자(|)는 가져온 데이터를 Export-Counter cmdlet으로 보냅니다. 이 명령은 Path 매개 변수를 사용하여 출력 파일의 위치를 지정합니다. Circular 및 MaxSize 매개 변수를 사용하여 Export-Counter cmdlet이 1GB로 래핑되는 순환 로그를 만들도록 지시합니다. MaxSize 매개 변수는 메가바이트 단위로 표현됩니다.

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

이 예제에서는 원격 컴퓨터에서 성능 카운터 데이터를 가져와서 원격 컴퓨터의 파일에 데이터를 저장하는 방법을 보여 줍니다.

첫 번째 명령은 Get-Counter cmdlet을 사용하여 원격 컴퓨터인 Server01에서 작업 집합 카운터 데이터를 수집합니다. 이 명령은 데이터를 $C 변수에 저장합니다.

두 번째 명령은 파이프라인 연산자(|)를 사용하여 $C 데이터를 Export-Counter cmdlet으로 보내 서버01 컴퓨터의 Workingset.blg 공유에 있는 Perf 파일에 저장합니다.

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

20

이 예제에서는 Import-Counter 및 Export-Counter cmdlet을 사용하여 기존 데이터를 다시 기록하는 방법을 보여 줍니다.

첫 번째 명령은 Import-Counter cmdlet을 사용하여 DiskSpace.blg 로그에서 성능 카운터 데이터를 가져옵니다. $All 변수에 데이터를 저장합니다. 이 파일에는 엔터프라이즈의 200대 이상의 원격 컴퓨터에 있는 "LogicalDisk% 사용 가능한 공간" 카운터의 샘플이 포함되어 있습니다.

두 번째 명령은 Where-Object cmdlet을 사용하여 CookedValue 15%보다 작은 개체를 선택합니다. 이 명령은 결과를 $LowSpace 변수에 저장합니다.

세 번째 명령은 파이프라인 연산자(|)를 사용하여 $LowSpace 변수의 데이터를 Export-Counter cmdlet으로 보냅니다. 이 명령은 Path 매개 변수를 사용하여 선택한 데이터를 LowDiskSpace.blg 파일에 기록해야 함을 나타냅니다.

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

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

성능 카운터 데이터를 Get-Counter 또는 Import-Counter 이 cmdlet으로 파이프할 수 있습니다.

로그 파일 생성기는 모든 입력 개체의 카운터 경로가 동일하고 개체가 오름차순으로 정렬되어야 합니다.

첫 번째 입력 개체의 카운터 형식 및 경로는 로그 파일에 기록된 속성을 결정합니다. 다른 입력 개체에 기록된 속성에 대한 값이 없으면 속성 필드가 비어 있습니다. 개체에 기록되지 않은 속성 값이 있는 경우 추가 속성 값은 무시됩니다.

성능 모니터는 Export-Counter 생성하는 모든 로그를 읽지 못할 수 있습니다. 예를 들어 성능 모니터를 사용하려면 모든 개체의 경로가 동일하고 모든 개체가 동일한 시간 간격으로 구분되어야 합니다.

Import-Counter cmdlet에는 ComputerName 매개 변수가 없습니다. 그러나 컴퓨터가 원격 Windows PowerShell Windows PowerShell용으로 구성된 경우 Invoke-Command cmdlet을 사용하여 원격 컴퓨터에서 Import-Counter 명령을 실행할 수 있습니다.