Share via

Get-DistributionGroup

  • 아티클

 

적용 대상: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

마지막으로 수정된 항목: 2010-04-27

Get-DistributionGroup cmdlet를 사용하여 기존 메일 그룹을 쿼리할 수 있습니다.

구문

Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

Get-DistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-IgnoreDefaultScope <SwitchParameter>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]

자세한 정보

메일 그룹을 사용하여 전자 메일 메일 그룹 및 보안 그룹을 만들어 공유 리소스에 대한 권한을 할당할 수 있습니다. 메일 그룹은 Exchange와 같은 전자 메일 응용 프로그램에서 사용자 그룹에 전자 메일 메시지를 보내는 경우에만 사용할 수 있습니다. Get-DistributionGroup cmdlet를 사용하면 기존 메일 그룹을 쿼리할 수 있습니다.

Get-DistributionGroup cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.

  • Exchange 보기 권한만 있는 관리자 역할

사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.

매개 변수

매개 변수 필수 종류 설명

ANR

선택

System.String

ANR 매개 변수는 모호한 이름 확인(ANR)을 통해 인수가 확인됨을 나타냅니다.

Credential

선택

System.Management.Automation.PSCredential

Credential 매개 변수는 Active Directory 디렉터리 서비스를 읽는 데 사용되는 계정의 도메인과 사용자 이름을 나타냅니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

Active Directory에서 데이터를 검색하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 명령에 DomainController 매개 변수를 포함시킵니다.

Filter

선택

System.String

Filter 매개 변수는 받는 사람을 필터링하는 데 사용되는 OPath 필터를 나타냅니다.

필터링할 수 있는 속성에 대한 자세한 내용은 -Filter 매개 변수의 필터링할 수 있는 속성을 참조하십시오.

Identity

선택

Microsoft.Exchange.Configuration.Tasks.DistributionGroupIdParameter

메일 그룹의 Identity 매개 변수는 다음 형식 중 하나를 사용합니다.

  • GUID

  • DN(고유 이름)

  • LegacyExchangeDN

  • 도메인\계정 이름

  • 별칭

IgnoreDefaultScope

선택

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 매개 변수는 명령이 Exchange 관리 셸에 대한 기본 받는 사람 범위 설정을 무시하고 해당 범위로 전체 포리스트를 사용하도록 지시합니다. 이렇게 하면 명령은 현재 기본 범위에 있지 않은 Active Directory 개체에 액세스할 수 있습니다. IgnoreDefaultScope 매개 변수를 사용하면 다음과 같은 제한이 적용됩니다.

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

  • Identity 매개 변수의 DN만 사용할 수 있습니다. 별칭이나 GUID 등 다른 ID 형태는 사용할 수 없습니다.

  • OrganizationalUnit 및 Identity 매개 변수를 함께 사용할 수 없습니다.

  • Credential 매개 변수를 사용할 수 없습니다.

ManagedBy

선택

Microsoft.Exchange.Configuration.Tasks.GeneralRecipientIdParameter

ManagedBy 매개 변수는 그룹을 관리하는 사용자 또는 연락처의 고유 이름을 나타냅니다.

OrganizationalUnit

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 매개 변수는 특정 OU(조직 구성 단위) 컨테이너로 결과를 제한합니다.

ReadFromDomainController

선택

System.Management.Automation.SwitchParameter

ReadFromDomainController 매개 변수는 사용자 도메인의 도메인 컨트롤러에서 사용자 정보를 읽도록 지정합니다. 포리스트의 모든 받는 사람을 포함하도록 받는 사람 범위를 설정했으며 이 매개 변수를 사용하지 않을 경우 오래된 정보를 가진 글로벌 카탈로그에서 사용자 정보를 읽을 가능성이 있습니다. 이 매개 변수를 사용할 경우 정보를 얻기 위해 여러 읽기가 필요할 수 있습니다.

참고

기본적으로 받는 사람 범위는 Exchange 서버를 호스팅하는 도메인에 설정됩니다.

RecipientTypeDetails

선택

Microsoft.Exchange.Data.Directory.Recipient.RecipientTypeDetails[]

RecipientTypeDetails 매개 변수는 반환되는 받는 사람의 유형을 지정합니다. Microsoft Exchange Server 2007의 받는 사람 유형은 받는 사람 유형 및 하위 유형으로 분리됩니다. 각 받는 사람 유형은 모든 하위 유형에 대한 모든 일반 속성을 포함합니다. 예를 들어 UserMailbox 유형은 연관된 사서함이 있는 Active Directory의 사용자 계정을 나타냅니다. 여러 사서함 유형이 있기 때문에 RecipientTypeDetails 매개 변수로 각 사서함 유형이 식별됩니다. 예를 들어 대화방 사서함에는 ConferenceRoomMailbox로 설정된 RecipientTypeDetails가 있으며, 사용자 사서함에는 UserMailbox로 설정된 RecipientTypeDetails가 있습니다.

이 명령의 경우 사용할 수 있는 받는 사람 유형 정보는 다음과 같습니다.

  • MailNonUniversalGroup

  • MailUniversalDistributionGroup

  • MailUniversalSecurityGroup

ResultSize

선택

Microsoft.Exchange.Data.Unlimited

ResultSize 매개 변수는 반환될 받는 사람 개체의 최대 수를 나타냅니다.

SortBy

선택

System.String

SortBy 특성은 결과를 정렬하는 데 사용됩니다.

입력 형식

반환 형식

오류

오류 설명

  

예외

예외 설명

  

예제

다음은 Get-DistributionGroup 명령의 코드 예입니다. 이 예제에서 Get-DistributionGroup 명령은 Distribution Group1 그룹을 검색하고 개체를 Format-List 명령에 파이프라인하여 메일 그룹에 대한 정보를 표시합니다.

Get-DistributionGroup -Identity "Distribution Group1" | Format-List