다음을 통해 공유

Group-Object

  • 참조
모듈:
Microsoft.PowerShell.Utility

지정된 속성에 대해 동일한 값을 포함하는 개체를 그룹화합니다.

구문

Group-Object
     [[-Property] <Object[]>]
     [-NoElement]
     [-AsHashTable]
     [-AsString]
     [-InputObject <PSObject>]
     [-Culture <String>]
     [-CaseSensitive]
     [<CommonParameters>]

Description

Group-Object cmdlet은 지정된 속성의 값에 따라 그룹에 개체를 표시합니다. Group-Object 각 속성 값에 대해 하나의 행이 있는 테이블과 해당 값이 있는 항목 수를 표시하는 열을 반환합니다.

둘 이상의 속성을 지정하는 경우 Group-Object 먼저 첫 번째 속성의 값으로 그룹화한 다음 각 속성 그룹 내에서 다음 속성 값으로 그룹화합니다.

예제

예제 1: 확장명별 파일 그룹화

이 예제에서는 $PSHOME 아래의 파일을 재귀적으로 가져오고 파일 이름 확장명별로 그룹화합니다. 출력은 지정된 확장에 대해 찾은 개수 파일을 기준으로 정렬하는 Sort-Object cmdlet으로 전송됩니다. 빈 이름 디렉터리를 나타냅니다.

이 예제에서는 NoElement 매개 변수를 사용하여 그룹의 멤버를 생략합니다.

$files = Get-ChildItem -Path $PSHOME -Recurse
$files | Group-Object -Property extension -NoElement | Sort-Object -Property Count -Descending

Count Name
----- ----
  365 .xml
  231 .cdxml
  197
  169 .ps1xml
  142 .txt
  114 .psd1
   63 .psm1
   49 .xsd
   36 .dll
   15 .mfl
   15 .mof
...

예제 2: 확률 및 짝수로 정수 그룹화

이 예제에서는 스크립트 블록을 Property 매개 변수의 값으로 사용하는 방법을 보여 줍니다.

이 명령은 1에서 20까지의 정수( 확률 및 짝수로 그룹화됨)를 표시합니다.

1..20 | Group-Object -Property {$_ % 2}

Count Name                      Group
----- ----                      -----
   10 1                         {1, 3, 5, 7, 9, 11, 13, 15, 17, 19}
   10 0                         {2, 4, 6, 8, 10, 12, 14, 16, 18, 20}

예제 3: EntryType별로 이벤트 로그 이벤트 그룹화

이러한 명령은 EntryType그룹화된 시스템 이벤트 로그에 1,000개의 가장 최근 항목을 표시합니다.

출력에서 Count 열은 각 그룹의 항목 수를 나타내고, 이름 열은 그룹을 정의하는 EventType 값을 나타내고, 그룹 열은 각 그룹의 개체를 나타냅니다.

Get-WinEvent -LogName System -MaxEvents 1000 | Group-Object -Property LevelDisplayName

Count Name          Group
----- ----          -----
  153 Error         {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diagnostics.�
  722 Information   {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diagnostics.�
  125 Warning       {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diagnostics.�

예제 4: 우선 순위 클래스별 프로세스 그룹화

이 예제에서는 NoElement 매개 변수의 효과를 보여 줍니다. 이러한 명령은 우선 순위 클래스별로 컴퓨터의 프로세스를 그룹화합니다.

첫 번째 명령은 Get-Process cmdlet을 사용하여 컴퓨터에서 프로세스를 가져옵니다. 파이프라인 연산자 | 사용하여 결과를 Group-Object보냅니다. 이 경우 개체를 프로세스의 PriorityClass 속성 값으로 그룹화합니다.

두 번째 명령은 NoElement 매개 변수를 사용하여 출력에서 그룹의 멤버를 제거한다는 점을 제외하고 첫 번째 명령과 동일합니다. 결과는 개수 및 속성 값 이름만 있는 테이블입니다.

결과는 다음 샘플 출력에 표시됩니다.

Get-Process | Group-Object -Property PriorityClass

Count Name         Group
----- ----         -----
   55 Normal       {System.Diagnostics.Process (AdtAgent), System.Diagnosti...
    1              {System.Diagnostics.Process (Idle)}
    3 High         {System.Diagnostics.Process (Newproc), System.Diagnostic...
    2 BelowNormal  {System.Diagnostics.Process (winperf),

Get-Process | Group-Object -Property PriorityClass -NoElement

Count Name
----- ----
   55 Normal
    1
    3 High
    2 BelowNormal

예제 5: 이름으로 프로세스 그룹화

다음 예제에서는 로컬 컴퓨터에서 실행 중인 프로세스의 여러 인스턴스에 Group-Object 사용합니다.

Get-Process | Group-Object -Property Name -NoElement | Where {$_.count -gt 1}

Count Name
----- ----
2     csrss
5     svchost
2     winlogon
2     wmiprvse

예제 8: 해시 테이블의 개체 그룹화

이 예제에서는 AsHashTable 및 AsString 매개 변수를 사용하여 해시 테이블의 그룹, 즉 키-값 쌍의 컬렉션으로 반환합니다.

결과 해시 테이블에서 각 속성 값은 키이고 그룹 요소는 값입니다. 각 키는 해시 테이블 개체의 속성이므로 점 표기법을 사용하여 값을 표시할 수 있습니다.

첫 번째 명령은 세션에서 Get 및 Set cmdlet을 가져오고 동사별로 그룹화하고, 그룹을 해시 테이블로 반환하고, 해시 테이블을 $A 변수에 저장합니다.

두 번째 명령은 $A해시 테이블을 표시합니다. 키-값 쌍에는 Get cmdlet과 Set cmdlet에 대한 두 개의 키-값 쌍이 있습니다.

세 번째 명령은 점 표기법을 사용하여 $Aget 키의 값을 표시합니다. 값은 CmdletInfo 개체입니다. AsString 매개 변수는 그룹의 개체를 문자열로 변환하지 않습니다.

$A = Get-Command get-*, set-* -CommandType cmdlet | Group-Object -Property verb -AsHashTable -AsString
$A

Name    Value
----    -----
Get     {Get-PSCallStack, Get-PSBreakpoint, Get-PSDrive, Get-PSSession...}
Set     {Set-Service, Set-StrictMode, Set-PSDebug, Set-PSSessionConfiguration...}

$A.get

CommandType     Name                 Definition
-----------     ----                 ----------
Cmdlet          Get-PSCallStack      Get-PSCallStack [-Verbose] [-Debug] [-ErrorAction <ActionPrefer...
Cmdlet          Get-PSBreakpoint     Get-PSBreakpoint [[-Id] <Int32[]>] [-Verbose] [-Debug] [-ErrorA...
Cmdlet          Get-PSDrive          Get-PSDrive [[-Name] <String[]>] [-Scope <String>] [-PSProvider...
...

매개 변수

-AsHashTable

이 cmdlet은 그룹을 해시 테이블로 반환한다는 것을 나타냅니다. 해시 테이블의 키는 개체가 그룹화되는 속성 값입니다. 해시 테이블의 값은 해당 속성 값이 있는 개체입니다.

그 자체로 AsHashTable 매개 변수는 각 키가 그룹화된 개체의 인스턴스인 각 해시 테이블을 반환합니다. AsString 매개 변수와 함께 사용할 경우 해시 테이블의 키는 문자열입니다.

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

-AsString

이 cmdlet은 해시 테이블 키를 문자열로 변환한다는 것을 나타냅니다. 기본적으로 해시 테이블 키는 그룹화된 개체의 인스턴스입니다. 이 매개 변수는 AsHashTable 매개 변수와 함께 사용할 때만 유효합니다.

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

-CaseSensitive

이 cmdlet은 그룹화의 대/소문자를 구분합니다. 이 매개 변수가 없으면 그룹에 있는 개체의 속성 값에 다른 사례가 있을 수 있습니다.

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

-Culture

문자열을 비교할 때 사용할 문화권을 지정합니다.

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

-InputObject

그룹화할 개체를 지정합니다. 개체가 포함된 변수를 입력하거나 개체를 가져오는 명령이나 식을 입력합니다.

InputObject 매개 변수를 사용하여 Group-Object개체 컬렉션을 제출하면 Group-Object 컬렉션을 나타내는 하나의 개체를 받습니다. 결과적으로 해당 개체를 멤버로 사용하여 단일 그룹을 만듭니다.

컬렉션의 개체를 그룹화하려면 개체를 Group-Object파이프합니다.

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

-NoElement

이 cmdlet은 결과에서 그룹의 멤버를 생략한다는 것을 나타냅니다.

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

-Property

그룹화에 대한 속성을 지정합니다. 개체는 지정된 속성의 값에 따라 그룹으로 정렬됩니다.

Property 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성을 만들려면 문자열 또는 스크립트 블록 값을 지정하는 Expression 키를 사용하여 해시 테이블을 만듭니다.

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

입력

PSObject

모든 개체를 Group-Object파이프할 수 있습니다.

출력

Microsoft.PowerShell.Commands.GroupInfo or System.Collections.Hashtable

AsHashTable 매개 변수를 사용하면 Group-Object 해시 테이블을 반환합니다. 그렇지 않으면 GroupInfo 개체를 반환합니다.

참고

  • 서식 cmdlet의 GroupBy 매개 변수(예: Format-Table 및 Format-List)를 사용하여 개체를 그룹화할 수도 있습니다. 각 속성 값에 대해 행이 있는 단일 테이블을 만드는 Group-Object달리 GroupBy 매개 변수는 속성 값이 있는 각 항목에 대해 행이 있는 각 속성 값에 대한 테이블을 만듭니다.

    Group-Object 그룹화되는 개체가 동일한 Microsoft .NET Framework 형식일 필요는 없습니다. 다른 .NET Framework 형식의 개체를 그룹화할 때 Group-Object 다음 규칙을 사용합니다.

    • 동일한 속성 이름 및 형식입니다. 개체에 지정된 이름의 속성이 있고 속성 값이 동일한 .NET Framework 형식인 경우 속성 값은 동일한 형식의 개체에 사용되는 것과 동일한 규칙을 사용하여 그룹화됩니다.

    • 동일한 속성 이름, 다른 형식. 개체에 지정된 이름의 속성이 있지만 속성 값이 다른 개체에 다른 .NET Framework 형식을 갖는 경우 Group-Object 속성 그룹의 첫 번째 항목에 대한 .NET Framework 형식을 .NET Framework 형식으로 사용합니다. 개체에 다른 형식의 속성이 있으면 속성 값이 해당 그룹의 형식으로 변환됩니다. 형식 변환에 실패하면 개체가 그룹에 포함되지 않습니다.

    • 누락된 속성입니다. 지정된 속성이 없는 개체는 그룹화할 수 없는 것으로 간주됩니다. 그룹화할 수 없는 개체는 AutomationNull.Value그룹의 최종 GroupInfo 개체 출력에 나타납니다.