다음을 통해 공유

New-AddressList(RTM)

  • 아티클

 

적용 대상: Exchange Server 2007

마지막으로 수정된 항목: 2007-06-05

New-AddressList cmdlet를 사용하여 새 주소 목록을 만들고 받는 사람에게 적용할 수 있습니다.

구문

New-AddressList -Name <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>] [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-IncludedRecipients <Nullable>] [-TemplateInstance <PSObject>]

New-AddressList -Name <String> [-Container <AddressListIdParameter>] [-DisplayName <String>] [-DomainController <Fqdn>] [-RecipientFilter <String>] [-TemplateInstance <PSObject>]

자세한 정보

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

  • Exchange 조직 관리자 역할

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

매개 변수

매개 변수 필수 종류 설명

Name

필수

System.String

Name 매개 변수는 새 주소 목록에 사용할 원하는 이름을 지정합니다. 이름은 64자를 초과할 수 없고 캐리지 리턴이나 줄 바꿈(\)을 포함할 수 없습니다.

ConditionalCompany

선택

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany 매개 변수는 회사를 지정하는 필터입니다. 이 매개 변수에 대해 입력한 값과 일치하는 회사 특성을 가진 받는 사람은 모두 주소 목록에 포함됩니다. 쉼표로 분리된 목록으로 여러 값을 사용할 수 있습니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. RecipientFilter 매개 변수나 다음 필터 매개 변수 중 하나를 사용해야 합니다.

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

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 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. RecipientFilter 매개 변수나 다음 필터 매개 변수 중 하나를 사용해야 합니다.

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

ConditionalStateOrProvince

선택

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalStateOrProvince 매개 변수는 시/도를 지정하는 필터입니다. 이 매개 변수에 대해 입력한 값과 일치하는 ConditionalStateOrProvince 특성을 가진 받는 사람은 모두 주소 목록에 포함됩니다. 쉼표로 분리된 목록으로 여러 값을 사용할 수 있습니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. RecipientFilter 매개 변수나 다음 필터 매개 변수 중 하나를 사용해야 합니다.

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

Container

선택

Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter

Container 매개 변수는 새 주소 목록이 만들어질 상위 주소 목록의 ID를 지정합니다. 상위 주소 목록이 지정되지 않은 경우 해당 주소 목록은 "모든 주소 목록" 루트 아래에 만들어집니다.

DisplayName

선택

System.String

DisplayName 매개 변수는 주소 목록에 사용할 원하는 표시 이름을 지정합니다. 표시 이름을 제공하지 않으면 주소 목록의 이름이 표시 이름으로 나타납니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

IncludedRecipients

선택

System.Nullable

IncludedRecipients 매개 변수는 주소 목록에 포함할 받는 사람의 유형을 지정하는 필터입니다. 다음 유형 중에서 하나 이상 사용할 수 있습니다.

  • 없음

  • UserMail

  • Resources

  • MailGroups

  • MailContacts

  • AllRecipients

RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. RecipientFilter 매개 변수나 다음 필터 매개 변수 중 하나를 사용해야 합니다.

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

RecipientFilter

선택

System.String

RecipientFilter 매개 변수는 주소 목록에 포함할 받는 사람에 대한 필터를 지정합니다. 다음 필터 매개 변수 중 하나라도 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

  • ConditionalCompany

  • ConditionalDepartment

  • ConditionalStateOrProvince

  • IncludedRecipients

이 매개 변수나 위의 필터 매개 변수 중 하나를 사용해야 합니다.

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

TemplateInstance

선택

System.Management.Automation.PSObject

TemplateInstance 매개 변수에 기존 개체를 제공하면, 이 명령은 해당 개체의 구성을 사용하여 로컬 또는 대상 서버에서 해당 개체의 동일한 복제본을 만듭니다.

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

첫 번째 예에서는 MyAddressList라는 새 주소 목록을 만드는 방법을 보여줍니다. 주소 목록에는 사서함 사용자이면서 StateOrProvince가 Washington이나 Oregon으로 설정된 받는 사람이 포함됩니다.

두 번째 예는 ConditionalStateOrProvince 매개 변수가 Washington으로 설정된 사서함을 포함하는 MyAddressList2라는 새 주소 목록을 만드는 방법을 보여줍니다.

New-AddressList -Name MyAddressList -RecipientFilter {((RecipientType -eq 'UserMailbox') -and ((StateOrProvince -eq 'Washington') -or (StateOrProvince -eq 'Oregon')))}
New-AddressList -Name MyAddressList2 -ConditionalStateOrProvince Washington -IncludedRecipients MailboxUsers