Get-UnifiedGroup

참조

모듈:: ExchangePowerShell

적용 대상:: Exchange Online, Exchange Online Protection

이 cmdlet은 클라우드 기반 서비스에서만 사용할 수 있습니다.

Get-UnifiedGroup cmdlet을 사용하여 클라우드 기반 조직의 Microsoft 365 그룹 확인합니다. Microsoft 365 그룹 대한 멤버, 소유자 및 구독자를 보려면 Get-UnifiedGroupLinks cmdlet을 사용합니다.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

Syntax

Get-UnifiedGroup
   [[-Identity] <UnifiedGroupIdParameter>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Get-UnifiedGroup
   [-Anr <String>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Description

Microsoft 365 그룹 Microsoft 365개 서비스에서 사용할 수 있는 그룹 개체입니다.

이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.

예제

예 1

Get-UnifiedGroup

이 예제에서는 모든 Microsoft 365 그룹 요약 목록을 반환합니다.

예 2

Get-UnifiedGroup | Format-List DisplayName,EmailAddresses,Notes,ManagedBy,AccessType

이 예제에서는 모든 Microsoft 365 그룹 대한 다음 정보를 반환합니다.

DN(고유 이름)
전자 메일 주소
설명
소유자
개인 정보

예 3

Get-UnifiedGroup -Identity "Marketing Department" | Format-List

이 예제에서는 마케팅 부서라는 Microsoft 365 그룹에 대한 자세한 정보를 반환합니다.

예 4

Get-UnifiedGroup | Where-Object {-Not $_.ManagedBy}

이 예제에서는 소유자가 없는 Microsoft 365 그룹 반환합니다.

예 5

Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"}

이 예제에서는 Microsoft 팀을 만들 때 생성되는 Microsoft 365 그룹 반환합니다.

매개 변수

-Anr

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Filter

Filter 매개 변수는 OPATH 구문을 사용하여 지정된 속성 및 값으로 결과를 필터링합니다. 검색 조건은 구문을 "Property -ComparisonOperator 'Value'"사용합니다.

전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예 $true: , $false또는 $null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다.
속성은 필터링 가능한 속성입니다. Exchange 서버 및 Exchange Online 필터링 가능한 속성에 대한 자세한 내용은 Filter 매개 변수에 대한 필터링 가능한 속성을 참조하세요.
ComparisonOperator는 OPATH 비교 연산자입니다(예 -eq : 같음 및 -like 문자열 비교의 경우). 비교 연산자에 대한 자세한 내용은 about_Comparison_Operators 참조하세요.
값은 검색할 속성 값입니다. 텍스트 값과 변수를 작은따옴표('Value' 또는 '$Variable')로 묶습니다. 변수 값에 작은따옴표가 포함된 경우 변수를 올바르게 확장하려면 작은따옴표를 식별(이스케이프)해야 합니다. 예를 들어 대신 를 '$User'사용합니다 '$($User -Replace "'","''")'. 정수 또는 시스템 값을 따옴표로 묶지 마세요(예: , , $true$false또는 $null 를 대신 사용500).

논리 연산자 -and 및 -or를 사용하여 여러 검색 조건을 함께 연결할 수 있습니다. 예를 들어 "Criteria1 -and Criteria2" 또는 "(Criteria1 -and Criteria2) -or Criteria3"입니다.

Exchange의 OPATH 필터에 대한 자세한 내용은 추가 OPATH 구문 정보를 참조하세요.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-Identity

Identity 매개 변수는 보려는 Microsoft 365 그룹을 지정합니다. Microsoft 365 그룹을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예시:

이름
별칭
DN(고유 이름)
DN(고유 이름)
정식 DN
GUID

참고: DisplayName 값을 사용하여 Microsoft 365 그룹을 식별할 수 있지만 결과가 고유하지는 않습니다. 단수적이고 고유한 결과를 반환해야 하는 경우 Microsoft 365 그룹에 대해 고유 식별자를 사용합니다.

Type:	UnifiedGroupIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IncludeAllProperties

IncludeAllProperties 스위치는 결과에 모든 속성의 값을 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하지 않으면 일부 속성(예: CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl 및 PhotoUrl)의 값이 비어 있을 수 있습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IncludeSoftDeletedGroups

IncludeSoftDeletedGroups 스위치는 결과에 일시 삭제된 Microsoft 365 그룹 포함할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

일시 삭제된 Microsoft 365 그룹 여전히 복구할 수 있는 삭제된 그룹입니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-ResultSize

ResultSize 매개 변수는 반환할 최대 결과 수를 지정합니다. 쿼리와 일치하는 모든 요청을 반환하려면 이 매개 변수의 값으로 unlimited를 사용합니다. 기본값은 1,000입니다.

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-SortBy

SortBy 매개 변수는 결과의 정렬 기준으로 사용할 속성을 지정합니다. 한 번에 하나의 속성에 대해 정렬이 수행됩니다. 결과는 오름차순으로 정렬됩니다.

기본 보기에 정렬하는 속성이 포함되지 않은 경우 명령을 로 | Format-Table -Auto Property1,Property2,...PropertyX추가할 수 있습니다. 보려는 모든 속성이 포함된 새 뷰를 만듭니다. 속성 이름에 와일드카드(*)를 사용할 수 있습니다.

다음과 같은 속성으로 정렬할 수 있습니다.

이름
DisplayName
별칭

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

다음을 통해 공유