다음을 통해 공유

Get-DistributionGroupMember

모듈:
Exchange PowerShell

cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수 및 설정은 한 환경 또는 다른 환경에만 사용할 수 있습니다.

Get-DistributionGroupMember cmdlet을 사용하여 메일 그룹 및 메일 사용 가능 보안 그룹의 구성원을 볼 수 있습니다.

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

구문

Default (기본값) 

Get-DistributionGroupMember
    [-Identity] <DistributionGroupMemberIdParameter>
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-IgnoreDefaultScope]
    [-IncludeSoftDeletedObjects]
    [-ReadFromDomainController]
    [-ResultSize <Unlimited>]
    [<CommonParameters>]

Description

organization 여러 Active Directory 도메인이 있는 경우 전체 포리스트를 보려면 Get-DistributionGroupMember cmdlet을 실행하기 전에 ViewEntireForest 매개 변수가 $true 설정된 Set-ADServerSettings cmdlet을 실행해야 할 수 있습니다. 자세한 내용은 예 2을 참조하십시오.

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

예제

예 1

Get-DistributionGroupMember -Identity "Marketing USA"

이 예에서는 메일 그룹 Marketing USA의 기존 메일 그룹 구성원을 반환합니다.

예 2

Set-ADServerSettings -ViewEntireForest $true

Get-DistributionGroupMember -Identity "Marketing Worldwide"

다음은 Set-ADServerSettings cmdlet을 실행하여 검색의 scope 전체 포리스트로 설정한 다음, Get-DistributionGroupMember cmdlet이 마케팅 Worldwide 메일 그룹의 메일 그룹 구성원에 대한 전체 포리스트를 검색하는 예제입니다.

예 3

$Groups = Get-UnifiedGroup -ResultSize Unlimited

$Groups | ForEach-Object {
$group = $_
Get-UnifiedGroupLinks -Identity $group.Name -LinkType Members -ResultSize Unlimited | ForEach-Object {
      New-Object -TypeName PSObject -Property @{
       Group = $group.DisplayName
       Member = $_.Name
       EmailAddress = $_.PrimarySMTPAddress
       RecipientType= $_.RecipientType
}}} | Export-CSV "$env:USERPROFILE\Desktop\Office365GroupMembers.csv" -NoTypeInformation -Encoding UTF8

클라우드 기반 서비스에서 이 예제에서는 모든 Microsoft 365 그룹 및 멤버를 포함하는 Office365GroupMembers.csv 라는 CSV(쉼표로 구분된 값) 파일을 현재 사용자의 Desktop에 다운로드합니다.

매개 변수

-Credential

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

자격 증명 매개 변수는 이 명령을 실행하는 데 사용되는 사용자 이름과 암호를 지정합니다. 일반적으로는 필요한 권한이 있는 여러 자격 증명을 제공해야 하는 경우나 스크립트를 사용하는 경우 이 매개 변수를 사용합니다.

이 매개 변수의 값에는 Get-Credential cmdlet이 있어야 합니다. 이 명령을 일시 중지 하고 자격 증명을 입력 하라는 메시지가 표시 되면 (Get-Credential)값을 사용 합니다. 또는이 명령을 실행 하기 전에 자격 증명을 변수에 저장 (예: $cred = Get-Credential) 한 다음이 매개 변수에 대 한 변수 이름 ($cred)을 사용 합니다. 자세한 내용은 Get-Credential을 참조하세요.

매개 변수 속성

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

매개 변수 집합

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

-DomainController

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com

매개 변수 속성

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

매개 변수 집합

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

-Identity

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

Identity 매개 변수는 메일 그룹 또는 메일 사용이 가능한 보안 그룹을 지정합니다. 그룹을 고유하게 식별하는 어떤 값도 사용 가능합니다. 예시:

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

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

매개 변수 속성

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

매개 변수 집합

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

-IgnoreDefaultScope

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

IgnoreDefaultScope 스위치는 명령에 Exchange PowerShell 세션에 대한 기본 수신자 scope 설정을 무시하고 전체 포리스트를 scope 사용하도록 지시합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

이 스위치를 사용하면 명령이 기본 scope 현재 사용할 수 없는 Active Directory 개체에 액세스할 수 있지만 다음과 같은 제한 사항도 도입됩니다.

  • DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.
  • DomainController 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.

매개 변수 속성

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

매개 변수 집합

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

-IncludeSoftDeletedObjects

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

이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.

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

일시 삭제된 그룹 구성원은 복구 가능한 Microsoft 365 그룹 또는 사서함에서 삭제됩니다.

매개 변수 속성

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

매개 변수 집합

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

-ReadFromDomainController

적용 가능: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.

ReadFromDomainController 스위치는 사용자 도메인의 도메인 컨트롤러에서 정보를 읽도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

명령: Set-AdServerSettings -ViewEntireForest $true 포리스트에 모든 개체를 포함하려면 ReadFromDomainController 스위치가 필요합니다. 그렇지 않으면 명령은 오래된 정보가 포함된 글로벌 카탈로그를 사용할 수 있습니다. 또한 ReadFromDomainController 스위치를 사용하여 명령의 여러 반복을 실행하여 정보를 가져와야 할 수도 있습니다.

기본적으로 수신자 scope Exchange 서버를 호스트하는 도메인으로 설정됩니다.

매개 변수 속성

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

매개 변수 집합

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

-ResultSize

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

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

매개 변수 속성

형식:Unlimited
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를 참조하세요.

입력

Input types

이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.

출력

Output types

이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.