다음을 통해 공유


New-DynamicDistributionGroup(RTM)

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2007-10-23

New-DynamicDistributionGroup cmdlet를 사용하여 새 동적 메일 그룹을 만들 수 있습니다.

구문

New-DynamicDistributionGroup -Name <String> -IncludedRecipients <Nullable> -OrganizationalUnit <OrganizationalUnitIdParameter> [-Alias <String>] [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <String>] [-ConditionalCustomAttribute10 <String>] [-ConditionalCustomAttribute11 <String>] [-ConditionalCustomAttribute12 <String>] [-ConditionalCustomAttribute13 <String>] [-ConditionalCustomAttribute14 <String>] [-ConditionalCustomAttribute15 <String>] [-ConditionalCustomAttribute2 <String>] [-ConditionalCustomAttribute3 <String>] [-ConditionalCustomAttribute4 <String>] [-ConditionalCustomAttribute5 <String>] [-ConditionalCustomAttribute6 <String>] [-ConditionalCustomAttribute7 <String>] [-ConditionalCustomAttribute8 <String>] [-ConditionalCustomAttribute9 <String>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]

New-DynamicDistributionGroup -Name <String> -OrganizationalUnit <OrganizationalUnitIdParameter> -RecipientFilter <String> [-Alias <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientContainer <OrganizationalUnitIdParameter>] [-TemplateInstance <PSObject>]

자세한 정보

동적 메일 그룹은 Active Directory 디렉터리 서비스 메일 사용 가능 개체를 쿼리하고 결과에 따라 그룹 구성원을 작성합니다. 전자 메일 메시지를 그룹에 보낼 때마다 그룹 구성원이 새로 계산됩니다. Exchange와 함께 제공되는 쿼리 필터는 다음 매개 변수의 조합으로 제한됩니다.

  • ConditionalCompany

  • ConditionalCustomAttribute N(여기서 N은 1에서 15까지의 값)

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

또한 RecipientFilter 매개 변수를 사용하여 사용자 지정 쿼리를 만들 수 있습니다.

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

  • Exchange 받는 사람 관리자 역할

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

매개 변수

매개 변수 필수 종류 설명

IncludedRecipients

필수

System.Nullable

IncludedRecipients 매개 변수는 동적 메일 그룹을 작성하는 데 사용하는 받는 사람 유형을 필터링합니다. RecipientFilter 매개 변수가 지정된 경우 IncludedRecipients 매개 변수를 사용할 수 없습니다.

IncludedRecipients 매개 변수에 사용할 수 있는 값은 AllRecipients, MailboxUsers, Resources, MailContacts, MailGroups, Mail Users 및 None입니다.

AllRecipients는 자동으로만 사용할 수 있습니다. IncludedRecipients의 여러 값을 쉼표로 구분하는 경우 OR 부울 연산자가 적용됩니다.

Name

필수

System.String

Name 매개 변수는 동적 메일 그룹의 이름을 지정합니다. DisplayName 매개 변수를 지정하지 않으면 Name의 값이 DisplayName에도 사용됩니다.

Name 값은 64자를 초과할 수 없습니다.

NameDisplayName의 값이 다른 경우 다음을 수행합니다.

  • Name 매개 변수는 Active Directory 사용자 및 컴퓨터뿐 아니라 Exchange 관리 콘솔의 그룹 이름 필드에서도 동적 메일 그룹 이름을 지정합니다.

  • DisplayName 매개 변수는 Exchange 관리 콘솔과 Exchange GAL(전체 주소 목록)에서 동적 메일 그룹 이름을 지정합니다.

OrganizationalUnit

필수

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 매개 변수는 정식 이름 구문을 사용하여 Active Directory에서 동적 메일 그룹 이름을 만들 위치를 지정합니다.

RecipientFilter

필수

System.String

RecipientFilter 매개 변수는 동적 메일 그룹을 작성하는 데 사용하는 메일 사용 가능 받는 사람을 필터링합니다. 다음 매개 변수 중 하나라도 지정하면 RecipientFilter를 사용할 수 없습니다.

  • IncludedRecipients

  • ConditionalCompany

  • ConditionalCustomAttribute N(여기서 N은 1에서 15까지의 값)

  • ConditionalDepartment

  • ConditionalStateOrProvince

RecipientFilterOPath 구문을 사용하여 Active Directory를 쿼리하고 받는 사람을 필터링합니다.

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

Alias

선택

System.String

Alias 매개 변수는 동적 메일 그룹의 별칭을 지정합니다. Alias의 값은 동적 메일 그룹의 기본 SMTP(Simple Mail Transfer Protocol) 전자 메일 주소를 생성하는 데 사용됩니다. Alias의 값은 공백을 포함할 수 없습니다. Alias 매개 변수를 지정하지 않으면 Name 매개 변수의 값이 Alias 매개 변수의 값에 사용됩니다. 이 때 Name 매개 변수의 공백은 밑줄(_)로 변환됩니다.

ConditionalCompany

선택

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany 매개 변수는 동적 메일 그룹을 작성하는 데 사용하는 사서함 사용자 또는 메일 사용 가능 연락처를 필터링합니다.

ConditionalCompany 매개 변수의 여러 값이 쉼표로 구분된 경우에는 OR 부울 연산자가 적용됩니다.

ConditionalCustomAttribute1

선택

System.String

ConditionalCustomAttribute1 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute10

선택

System.String

ConditionalCustomAttribute10 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute11

선택

System.String

ConditionalCustomAttribute11 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute12

선택

System.String

ConditionalCustomAttribute12 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute13

선택

System.String

ConditionalCustomAttribute13 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute14

선택

System.String

ConditionalCustomAttribute14 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute15

선택

System.String

ConditionalCustomAttribute15 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute2

선택

System.String

ConditionalCustomAttribute2 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute3

선택

System.String

ConditionalCustomAttribute3 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute4

선택

System.String

ConditionalCustomAttribute4 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute5

선택

System.String

ConditionalCustomAttribute5 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute6

선택

System.String

ConditionalCustomAttribute6 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute7

선택

System.String

ConditionalCustomAttribute7 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute8

선택

System.String

ConditionalCustomAttribute8 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalCustomAttribute9

선택

System.String

ConditionalCustomAttribute9 매개 변수는 사용자 지정 특성을 지정합니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다.

ConditionalDepartment

선택

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalDepartment 매개 변수는 동적 메일 그룹을 작성하는 데 사용하는 사서함 사용자 또는 메일 사용 가능 연락처를 필터링합니다. RecipientFilter 매개 변수를 지정하면 ConditionalDepartment를 사용할 수 없습니다.

ConditionalDepartment의 여러 값을 쉼표로 구분하는 경우 OR 부울 연산자가 적용됩니다.

ConditionalStateOrProvince

선택

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalStateOrProvince 매개 변수는 동적 메일 그룹을 작성하는 데 사용하는 사서함 사용자 또는 메일 사용 가능 연락처를 필터링합니다. RecipientFilter 매개 변수를 지정하면 ConditionalStateOrProvince를 사용할 수 없습니다.

ConditionalStateOrProvince의 여러 값을 쉼표로 구분하는 경우 OR 부울 연산자가 적용됩니다.

DisplayName

선택

System.String

DisplayName 매개 변수는 Exchange 관리 콘솔 및 Exchange GAL(전체 주소 목록)에서 동적 메일 그룹의 이름을 지정합니다. DisplayName 매개 변수를 지정하지 않으면 Name 매개 변수의 값이 DisplayName에 사용됩니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

이 구성 변경을 Active Directory에 기록하는 도메인 컨트롤러의 FQDN(정규화된 도메인 이름)을 지정하려면 DomainController 매개 변수를 포함시킵니다.

RecipientContainer

선택

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

RecipientContainer 매개 변수는 Active Directory에서의 위치에 따라 동적 메일 그룹을 작성하는 데 사용하는 받는 사람을 필터링합니다. RecipientContainer 매개 변수의 값은 OU(조직 구성 단위) 또는 도메인의 정식 이름일 수 있습니다. RecipientContainer의 값을 지정하지 않으면 Active Directory에서 동적 메일 그룹의 위치가 기본 검색 필터가 됩니다. 이 위치는 OrganizationalUnit 매개 변수를 사용하여 지정합니다.

TemplateInstance

선택

System.Management.Automation.PSObject

TemplateInstance 매개 변수에 기존 개체를 지정하면 해당 개체의 구성을 사용하여 개체의 복사본을 만듭니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

  

 

예제

다음은 New-DynamicDistributionGroup 명령을 사용하는 방법을 보여주는 코드 예입니다.

첫 번째 예에서는 Contoso.com 도메인의 사용자 컨테이너에 Marketing Group이라는 새 동적 메일 그룹을 만듭니다. Marketing Group 동적 메일 그룹에는 Contoso.com 도메인의 어디에서나 찾을 수 있고 "Marketing" 또는 "Sales"를 포함하는 부서 필드가 있는 모든 사서함 사용자 또는 메일 사용 가능 연락처가 포함되어 있습니다.

두 번째 예에서는 RecipientFilter 매개 변수를 사용하여 Contoso.com 도메인의 사용자 컨테이너에 Pacific Northwest라는 동적 메일 그룹을 만듭니다. Pacific Northwest 동적 메일 그룹에는 Contoso.com 도메인의 어디에서나 찾을 수 있고 "Washington" 또는 "Oregon"을 포함하는 시/도 필드가 있는 모든 사서함 사용자가 포함되어 있습니다.

New-DynamicDistributionGroup -Name "Marketing Group" -Alias "Marketing_Group" -IncludedRecipients "MailboxUsers,MailContacts" -OrganizationalUnit "Contoso.com/Users" -ConditionalDepartment "Marketing","Sales" -RecipientContainer "Contoso.com"
New-DynamicDistributionGroup -Name "Pacific Northwest" -Alias "Pacific_Northwest" -OrganizationalUnit "Contoso.com/Users" -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington' -or StateOrProvince -eq 'Oregon')))} -RecipientContainer "Contoso.com"