Get-UnifiedGroup

모듈:

Exchange PowerShell

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

Get-UnifiedGroup cmdlet을 사용하여 클라우드 기반 organization에서 Microsoft 365 그룹 봅니다. Microsoft 365 그룹의 구성원, 소유자 및 구독자를 보려면 Get-UnifiedGroupLinks cmdlet을 사용합니다.

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

구문

Identity (기본값)

Get-UnifiedGroup
    [[-Identity] <UnifiedGroupIdParameter>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

AnrSet

Get-UnifiedGroup
    [-Anr <String>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-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

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

AnrSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Filter

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

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

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

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

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Identity

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

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

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

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

주의: Identity 매개 변수에 대한 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. ID 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.

매개 변수 속성

형식:	UnifiedGroupIdParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

Identity

Position:	1
필수:	False
파이프라인의 값:	True
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames 스위치는 AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames 속성에서 AcceptMessagesOnlyFromSendersOrMembers 받는 사람의 SMTP 주소 및 표시 이름을 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 cmdlet 결과에서 사람이 읽을 수 있는 식별자를 복원하기 위해 도입되었습니다. 이 스위치를 사용하지 않으면 AcceptMessagesOnlyFromSendersOrMembers 받는 사람이 GUID로 표시되고 AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames 속성이 비어 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IncludeAllProperties

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

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

이 스위치를 사용하지 않으면 일부 속성(예: CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl 및 PhotoUrl)의 값이 공백으로 표시될 수 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

IncludeBypassModerationFromSendersOrMembersWithDisplayNames 스위치는 BypassModerationFromSendersOrMembersWithDisplayNames 속성에서 BypassModerationFromSendersOrMembers 수신자의 SMTP 주소 및 표시 이름을 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 cmdlet 결과에서 사람이 읽을 수 있는 식별자를 복원하기 위해 도입되었습니다. 이 스위치를 사용하지 않으면 BypassModerationFromSendersOrMembers 받는 사람이 GUID로 표시되고 BypassModerationFromSendersOrMembersWithDisplayNames 속성이 비어 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IncludeGrantSendOnBehalfToWithDisplayNames

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

IncludeGrantSendOnBehalfToWithDisplayNames 스위치는 GrantSendOnBehalfToWithDisplayNames 속성에서 GrantSendOnBehalfTo 받는 사람의 SMTP 주소 및 표시 이름을 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 cmdlet 결과에서 사람이 읽을 수 있는 식별자를 복원하기 위해 도입되었습니다. 이 스위치를 사용하지 않으면 GrantSendOnBehalfTo 받는 사람이 GUID로 표시되고 GrantSendOnBehalfToWithDisplayNames 속성이 비어 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IncludeModeratedByWithDisplayNames

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

IncludeModeratedByWithDisplayNames 스위치는 ModeratedByWithDisplayNames 속성에서 ModeratedBy 수신자의 SMTP 주소 및 표시 이름을 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 cmdlet 결과에서 사람이 읽을 수 있는 식별자를 복원하기 위해 도입되었습니다. 이 스위치를 사용하지 않으면 ModeratedBy 받는 사람이 GUID로 표시되고 ModeratedByWithDisplayNames 속성이 비어 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

IncludeRejectMessagesFromSendersOrMembersWithDisplayNames 스위치는 RejectMessagesFromSendersOrMembersWithDisplayNames 속성에서 RejectMessagesFromSendersOrMembers 받는 사람의 SMTP 주소와 표시 이름을 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치는 cmdlet 결과에서 사람이 읽을 수 있는 식별자를 복원하기 위해 도입되었습니다. 이 스위치를 사용하지 않으면 ModeratedBy 받는 사람이 GUID로 표시되고 RejectMessagesFromSendersOrMembersWithDisplayNames 속성이 비어 있습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IncludeSoftDeletedGroups

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

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

일시 삭제된 Microsoft 365 그룹은 아직 복구할 수 있는 삭제된 그룹입니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ResultSize

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

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

매개 변수 속성

형식:	Unlimited
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-SortBy

적용 가능: Exchange Online, 온-프레미스 사서함용 기본 제공 보안 추가 기능

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

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

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

• 이름
• DisplayName
• 별칭

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable과 같은 일반 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.