Get-DistributionGroup(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2008-02-27
Get-DistributionGroup cmdlet를 사용하여 기존 메일 그룹을 쿼리할 수 있습니다.
구문
Get-DistributionGroup [-Identity <DistributionGroupIdParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DistributionGroup [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-ManagedBy <GeneralRecipientIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ReadFromDomainController <SwitchParameter>] [-RecipientTypeDetails <RecipientTypeDetails[]>] [-ResultSize <Unlimited>] [-SortBy <String>]
Get-DistributionGroup [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-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 매개 변수는 다음 형식 중 하나를 사용합니다.
|
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가 있습니다. 이 명령의 경우 사용할 수 있는 받는 사람 유형 정보는 다음과 같습니다.
|
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