Export-Counter cmdlet은 PerformanceCounterSampleSet 개체를 받아 카운터 로그 파일로 내보냅니다.
구문
Export-Counter [-Path] <string> -InputObject <PerformanceCounterSampleSet[]> [-Circular <switch>] [-FileFormat <string>] [-Force <switch>] [-MaxSize <int>] [<CommonParameters>]
설명
Export-Counter cmdlet은 성능 카운터 데이터(PerformanceCounterSampleSet 개체)를 바이너리 성능 로그(.blg), 쉼표로 구분된 값(.csv) 또는 탭으로 구분된 값(.tsv) 형식의 로그 파일로 내보냅니다. 이 cmdlet을 사용하여 성능 카운터 데이터를 기록 또는 다시 기록할 수 있습니다.
Export-Counter는 Get-Counter 및 Import-Counter cmdlet이 반환하는 데이터를 내보내도록 설계되었습니다.
참고: Export-Counter는 Windows 7, Windows Server 2008 R2 이상 버전에서만 실행됩니다.
매개 변수
-Circular <switch>
출력 파일이 FIFO(First In, First Out) 형식을 가진 순환 로그여야 한다는 것을 나타냅니다. 이 매개 변수를 포함할 경우 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 매개 변수가 지정되지 않은 경우 로그 파일이 기정된 최대 크기에 도달하면 새 데이터가 추가되고 cmdlet에서 종료되지 않는 오류를 생성합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Path <string>
출력 파일의 경로와 파일 이름을 지정합니다. 로컬 컴퓨터의 상대 또는 절대 경로나 원격 컴퓨터의 UNC(Uniform Naming Convention) 경로를 입력합니다(예: \\Computer\Share\file.blg). 이 매개 변수는 필수 사항입니다.
참고: 파일 형식은 경로의 파일 이름 확장명이 아니라 FileFormat 매개 변수 값에 의해 결정됩니다.
필수 여부 |
true |
위치 |
2 |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
Microsoft.PowerShell.Commands.GetCounter.PerformanceCounterSampleSet 성능 카운터 데이터를 Get-Counter 또는 Import-Counter에서 Export-Counter로 파이프할 수 있습니다. |
출력 |
없음 |
참고
로그 파일 생성기에서는 모든 입력 개체의 카운터 경로가 동일하며 개체가 오름차순으로 정렬되어 있어야 합니다.
첫 번째 입력 개체의 카운터 유형 및 경로가 로그 파일에 기록되는 속성을 결정합니다. 다른 입력 개체에 기록된 속성 값이 없으면 속성 필드는 비게 됩니다. 해당 개체에 기록되지 않은 속성 값이 있으면 추가 속성 값은 무시됩니다.
Export-Counter가 생성하는 로그 중 일부를 성능 모니터에서 읽지 못할 수 있습니다. 예를 들어 성능 모니터에서는 모든 개체의 경로가 동일하며 모든 개체가 동일한 시간 간격으로 분리되어야 합니다.
Import-Counter cmdlet에 ComputerName 매개 변수가 없습니다. 그러나 Windows PowerShell 원격을 사용하도록 컴퓨터가 구성된 경우 Invoke-Command cmdlet을 사용하여 원격 컴퓨터에서 Import-Counter 명령을 실행할 수 있습니다.
예 1
C:\PS># Export-Counter 설명 ----------- 이 명령은 카운터 데이터를 .blg 파일로 내보냅니다. 이 명령은 Get-Counter cmdlet을 사용하여 프로세서 시간 데이터를 수집한 다음 파이프라인 연산자(|)를 사용하여 데이터를 Export-Counter cmdlet으로 보냅니다. 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 변환 기능을 사용하여 1GB(기가바이트) 값을 $1GBinBytes 변수에 바이트로 저장합니다. 값 뒤에 K(킬로바이트), MB(메가바이트) 또는 GB를 입력하면 Windows PowerShell은 값을 바이트로 반환합니다. C:\PS> $1GBinBytes = 1GB 두 번째 명령은 Import-Counter cmdlet을 사용하여 Threads.csv 파일에서 성능 카운터 데이터를 가져옵니다. 이 예에서는 이 파일이 이전에 Export-Counter cmdlet을 사용하여 내보내 졌다고 간주합니다. 파이프라인 연산자(|)는 가져온 데이터를 Export-Counter cmdlet으로 보냅니다. 이 명령은 Path 매개 변수를 사용하여 출력 파일의 위치를 지정하고 Circular 및 MaxSize 매개 변수를 사용하여 1GB에서 래핑되는 순환 로그를 만들도록 Export-Counter에 지시합니다. C:\PS> import-counter threads.csv | export-counter -path threadtest.blg -circular -maxsize $1GBinBytes
예 3
C:\PS># Export-Counter 설명 ----------- 이 예에서는 원격 컴퓨터에서 성능 카운터 데이터를 가져와 원격 컴퓨터의 파일에 저장하는 방법을 보여 줍니다. 첫 번째 명령은 Get-Counter cmdlet을 사용하여 원격 컴퓨터인 Server01에서 작업 집합 카운터 데이터를 수집한 다음 $c 변수에 저장합니다. C:\PS> $c = get-counter -computername Server01 -counter "\Process(*)\Working Set - Private" -maxSamples 20 두 번째 명령은 파이프라인 연산자(|)를 사용하여 $c의 데이터를 Export-Counter cmdlet으로 보냅니다. 그러면 이 cmdlet이 Server01 컴퓨터의 Perf 공유에 있는 Workingset.blg 파일에 데이터를 저장합니다. C:\PS> $c | export-counter -path \\Server01\Perf\WorkingSet.blg
예 4
C:\PS># Export-Counter 설명 ----------- 이 예에서는 Import-Counter 및 Export-Counter cmdlet을 사용하여 기존 데이터를 다시 기록하는 방법을 보여 줍니다. 첫 번째 명령은 Import-Counter cmdlet을 사용하여 DiskSpace.blg 로그에서 성능 카운터 데이터를 가져와 $all 변수에 저장합니다. 이 파일에는 기업 내에서 200개가 넘는 원격 컴퓨터에 있는 "LogicalDisk\% Free Space" 카운터의 샘플이 포함되어 있습니다. C:\PS> $all = import-counter DiskSpace.blg 두 번째 명령은 $all에 있는 샘플 집합 개체의 CounterSamples 속성 및 Where-Object cmdlet(별칭 = "where")을 사용하여 CookedValue가 15(%) 미만인 개체를 선택한 다음 결과를 $lowSpace 변수에 저장합니다. C:\PS> $lowSpace = $all.countersamples | where {$_.cookedvalues -lt 15} 세 번째 명령은 파이프라인 연산자(|)를 사용하여 $lowSpace 변수의 데이터를 Export-Counter cmdlet으로 보냅니다. 이 명령은 경로 변수를 사용하여 선택된 데이터가 LowDiskSpace.blg 파일에 기록되도록 지정합니다. C:\PS> $lowSpace | export-counter -path LowDiskSpace.blg
참고 항목