다음을 통해 공유

Export-Counter

  • 참조
모듈:
Microsoft.PowerShell.Diagnostics

성능 카운터 데이터를 로그 파일로 내보냅니다.

구문

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

Description

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

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

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

예제

예제 1: 카운터 데이터를 파일로 내보내기

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

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

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

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

예제 2: 카운터 파일 형식으로 파일 내보내기

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

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

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

예제 3: 원격 컴퓨터에서 카운터 데이터를 가져와서 파일에 저장

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

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

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

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

20

예제 4: 기존 데이터 다시 기록

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

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

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

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

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

매개 변수

-Circular

출력 파일이 FIFO(First in, first out) 형식의 순환 로그임을 나타냅니다. 이 매개 변수 를 포함하면 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

Path 매개 변수로 지정된 위치에 기존 파일이 있는 경우 기존 파일을 덮어쓰고 바꿉니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

내보낼 카운터 데이터를 배열로 지정합니다. 데이터 또는 cmdlet과 같은 데이터를 가져오는 명령이 포함된 변수를 Get-Counter Import-Counter 입력합니다.

형식:PerformanceCounterSampleSet[]
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-MaxSize

출력 파일의 최대 크기를 메가바이트(MB)로 지정합니다.

Circular 매개 변수를 지정한 경우 로그 파일이 지정된 최대 크기에 도달하면 최신 항목이 추가되면 가장 오래된 항목이 삭제됩니다. Circular 매개 변수를 지정하지 않으면 로그 파일이 지정된 최대 크기에 도달하면 새 데이터가 추가되지 않고 cmdlet이 종료되지 않는 오류를 생성합니다.

형식:UInt32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Path

출력 파일의 경로와 파일 이름을 지정합니다. 로컬 컴퓨터의 상대 또는 절대 경로 또는 원격 \\Computer\Share\file.blg컴퓨터에 대한 UNC(Uniform Naming Convention) 경로를 입력합니다. 이 매개 변수는 필수입니다.

파일 형식은 경로의 파일 이름 확장명 대신 FileFormat 매개 변수의 값에 따라 결정됩니다.

형식:String
별칭:PSPath
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

PerformanceCounterSampleSet

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

출력

None

참고

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

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

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

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