Get-DistributionGroup

구문

AnrSet

Get-DistributionGroup
    [-Anr <String>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeManagedByWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-RecipientTypeDetails <RecipientTypeDetails[]>]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Identity

Get-DistributionGroup
    [[-Identity] <DistributionGroupIdParameter>]
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeManagedByWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-RecipientTypeDetails <RecipientTypeDetails[]>]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

ManagedBySet

Get-DistributionGroup
    [-Credential <PSCredential>]
    [-DomainController <Fqdn>]
    [-Filter <String>]
    [-IgnoreDefaultScope]
    [-IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAcceptMessagesOnlyFromWithDisplayNames]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeManagedByWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-ManagedBy <GeneralRecipientIdParameter>]
    [-OrganizationalUnit <OrganizationalUnitIdParameter>]
    [-ReadFromDomainController]
    [-RecipientTypeDetails <RecipientTypeDetails[]>]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Description

예제

예 1

Get-DistributionGroup

예 2

Get-DistributionGroup -Identity "Marketing Reports" | Format-List

예 3

Get-DistributionGroup -Anr marketing | Format-Table Name, ManagedBy -Auto

매개 변수

-Anr

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

Anr 매개 변수는 ANR(모호한 이름 확인) 검색을 수행할 문자열을 지정합니다. 부분 문자열을 지정하고 해당 문자열과 일치하는 특성의 개체를 검색할 수 있습니다. 검색되는 기본 특성은 다음과 같습니다.

• CommonName(CN)
• DisplayName
• FirstName
• LastName
• 별칭

매개 변수 속성

매개 변수 집합

-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을 참조하세요.

매개 변수 속성

매개 변수 집합

-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

매개 변수 속성

매개 변수 집합

-Filter

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

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

• 전체 OPATH 필터를 큰따옴표 " "로 묶습니다. 필터에 시스템 값(예 $true: , $false또는 $null)이 포함된 경우 대신 작은따옴표 ' 를 사용합니다. 이 매개 변수는 문자열(시스템 블록이 아님)이지만 중괄호 { }를 사용할 수도 있지만 필터에 변수가 없는 경우에만 사용할 수 있습니다.
• 속성은 필터링 가능한 속성입니다. 필터링 가능한 속성에 대한 자세한 내용은 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 구문 정보를 참조하세요.

매개 변수 속성

매개 변수 집합

-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 값이 포함되어 있지 않은지 확인합니다.

매개 변수 속성

매개 변수 집합

-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 매개 변수는 사용할 수 없습니다. 명령은 자동으로 적절한 글로벌 카탈로그 서버를 사용합니다.

매개 변수 속성

매개 변수 집합

-IncludeAcceptMessagesOnlyFromDLMembersWithDisplayNames

적용 가능: Exchange Online

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

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

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

매개 변수 속성

매개 변수 집합

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

적용 가능: Exchange Online

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

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

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

매개 변수 속성

매개 변수 집합

-IncludeAcceptMessagesOnlyFromWithDisplayNames

적용 가능: Exchange Online

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

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

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

매개 변수 속성

매개 변수 집합

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

적용 가능: Exchange Online

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

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

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

매개 변수 속성

매개 변수 집합

-IncludeGrantSendOnBehalfToWithDisplayNames

적용 가능: Exchange Online

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

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

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

매개 변수 속성

매개 변수 집합

-IncludeManagedByWithDisplayNames

적용 가능: Exchange Online

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

IncludeManagedByWithDisplayNames 스위치는 ManagedByWithDisplayNames 속성에서 SMTP 주소를 반환하고 그룹 소유자의 이름을 표시할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

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

매개 변수 속성

매개 변수 집합

-IncludeModeratedByWithDisplayNames

적용 가능: Exchange Online

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

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

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

매개 변수 속성

매개 변수 집합

-ManagedBy

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

ManagedBy 매개 변수는 그룹의 소유자별로 결과를 필터링합니다. 소유자를 고유하게 식별하는 어떤 값도 사용 할 수 있습니다. 예를 들면 다음과 같습니다.

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

매개 변수 속성

매개 변수 집합

-OrganizationalUnit

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

OrganizationalUnit 매개 변수는 Active Directory의 개체 위치에 따라 결과를 필터링합니다. 지정된 위치에 있는 개체만 반환됩니다. 이 매개 변수에 대한 유효한 입력은 Get-OrganizationalUnit cmdlet에서 반환되는 OU(조직 구성 단위) 또는 도메인입니다. OU 또는 도메인을 고유하게 식별하는 모든 값을 사용할 수 있습니다. 예를 들면 다음과 같습니다.

• 이름
• 이름
• DN(고유 이름)
• GUID

매개 변수 속성

매개 변수 집합

-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 서버를 호스트하는 도메인으로 설정됩니다.

매개 변수 속성

매개 변수 집합

-RecipientTypeDetails

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

RecipientTypeDetails 매개 변수는 지정된 배포 그룹 하위 형식으로 결과를 필터링합니다. 유효한 값은 다음과 같습니다.

• MailNonUniversalGroup
• MailUniversalDistributionGroup
• MailUniversalSecurityGroup
• RoomList

쉼표로 구분하여 여러 값을 지정할 수 있습니다.

매개 변수 속성

매개 변수 집합

-ResultSize

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

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

매개 변수 속성

매개 변수 집합

-SortBy

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

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

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

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

• 이름
• DisplayName
• 별칭
• 구/군/시
• FirstName
• LastName
• Office
• ServerLegacyDN

매개 변수 속성

매개 변수 집합

CommonParameters

입력

Input types

출력

Output types