다음을 통해 공유

Group-Object

  • 참조
모듈:
Microsoft.PowerShell.Utility

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

구문

Group-Object
     [-NoElement]
     [-AsHashTable]
     [-AsString]
     [-InputObject <PSObject>]
     [[-Property] <Object[]>]
     [-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 0                         {2, 4, 6, 8...}
   10 1                         {1, 3, 5, 7...}

예제 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.Diag...}
  722 Information   {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diag...}
  125 Warning       {System.Diagnostics.Eventing.Reader.EventLogRecord, System.Diag...}

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

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

첫 번째 명령은 Get-Process cmdlet을 사용하여 컴퓨터의 프로세스를 가져와서 개체를 파이프라인 아래로 보냅니다. Group-Object개체를 프로세스의 PriorityClass 속성 값으로 그룹화합니다.

두 번째 예제에서는 NoElement 매개 변수를 사용하여 출력에서 그룹의 멤버를 제거합니다. 결과는 Count 및 Name 속성 값만 있는 테이블입니다.

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

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 사용하여 로컬 컴퓨터에서 실행되는 프로세스의 여러 인스턴스를 그룹화합니다. Where-Object 둘 이상의 인스턴스가 있는 프로세스를 표시합니다.

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

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

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

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

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

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

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

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

$A = Get-Command Get-*, Set-* -CommandType cmdlet |
     Group-Object -Property Verb -AsHashTable -AsString
$A

Name     Value
----     -----
Get      {Get-Acl, Get-Alias, Get-AppLockerFileInformation, Get-AppLockerPolicy...}
Set      {Set-Acl, Set-Alias, Set-AppBackgroundTaskResourcePolicy, Set-AppLockerPolicy...}

$A.Get

CommandType     Name                              Version    Source
-----------     ----                              -------    ------
Cmdlet          Get-Acl                           3.0.0.0    Microsoft.PowerShell.Security
Cmdlet          Get-Alias                         3.1.0.0    Microsoft.PowerShell.Utility
Cmdlet          Get-AppLockerFileInformation      2.0.0.0    AppLocker
Cmdlet          Get-AppLockerPolicy               2.0.0.0    AppLocker
...

예제 10: 계산된 속성을 사용하여 키 값으로 해시 테이블 그룹화

이 예제에서는 해시 테이블 개체를 해당 키 값으로 그룹화할 수 있는 방법을 보여줍니다. Property 매개 변수에 하나 이상의 scriptblock을 지정할 수 있습니다. 이러한 scriptblock의 식은 명명된 속성의 값과 같은 입력을 그룹화하는 데 사용됩니다.

@(
    @{ name = 'a' ; weight = 7 }
    @{ name = 'b' ; weight = 1 }
    @{ name = 'c' ; weight = 3 }
    @{ name = 'd' ; weight = 7 }
) | Group-Object -Property { $_.weight } -NoElement

Count Name
----- ----
    2 7
    1 1
    1 3

매개 변수

-AsHashTable

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

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

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

-AsString

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

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

-CaseSensitive

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

형식:SwitchParameter
Position:Named
Default value:False
필수: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:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Property

그룹화에 대한 속성을 지정합니다. 개체는 지정된 속성의 값에 따라 명명된 그룹으로 정렬됩니다. 속성이 지정되지 않은 경우 개체는 해당 값 또는 해당 값의 ToString() 표현으로 그룹화됩니다. 출력은 그룹 개체를 만든 순서대로 표시됩니다.

Property 매개 변수의 값은 새 계산 속성일 수 있습니다. 계산된 속성은 스크립트 블록 또는 해시 테이블일 수 있습니다. 유효한 키-값 쌍은 다음과 같습니다.

  • 식 - <string> 또는 <script block>

자세한 내용은 about_Calculated_Properties참조하세요.

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

입력

PSObject

모든 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

GroupInfo

기본적으로 이 cmdlet은 GroupInfo 개체를 반환합니다.

Hashtable

AsHashTable 매개 변수를 사용하는 경우 이 cmdlet은 Hashtable 개체를 반환합니다.

참고

Windows PowerShell에는 Group-Object다음과 같은 별칭이 포함되어 있습니다.

  • group

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

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

  • 동일한 속성 이름 및 형식입니다.

    개체에 지정된 이름의 속성이 있고 속성 값의 .NET 형식이 같으면 속성 값은 동일한 형식의 개체에 사용되는 것과 동일한 규칙으로 그룹화됩니다.

  • 동일한 속성 이름, 다른 형식.

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

  • 누락된 속성입니다.

    지정된 속성이 없는 개체는 그룹화할 수 없습니다. 그룹화되지 않은 개체는 AutomationNull.Value그룹의 최종 GroupInfo 개체 출력에 나타납니다.

출력 그룹은 그룹을 만든 순서대로 표시됩니다. 각 그룹에 속하는 항목은 정렬되지 않습니다. 수신된 순서대로 나열됩니다.