Set-GlobalAddressList

 

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

마지막으로 수정된 항목: 2009-05-12

Set-GlobalAddressList cmdlet를 사용하여 GAL(전체 주소 목록)의 Active Directory 디렉터리 서비스에서 특성을 수정합니다.

구문

Set-GlobalAddressList -Identity <GlobalAddressListIdParameter> [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

Set-GlobalAddressList [-ConditionalCompany <MultiValuedProperty>] [-ConditionalCustomAttribute1 <MultiValuedProperty>] [-ConditionalCustomAttribute10 <MultiValuedProperty>] [-ConditionalCustomAttribute11 <MultiValuedProperty>] [-ConditionalCustomAttribute12 <MultiValuedProperty>] [-ConditionalCustomAttribute13 <MultiValuedProperty>] [-ConditionalCustomAttribute14 <MultiValuedProperty>] [-ConditionalCustomAttribute15 <MultiValuedProperty>] [-ConditionalCustomAttribute2 <MultiValuedProperty>] [-ConditionalCustomAttribute3 <MultiValuedProperty>] [-ConditionalCustomAttribute4 <MultiValuedProperty>] [-ConditionalCustomAttribute5 <MultiValuedProperty>] [-ConditionalCustomAttribute6 <MultiValuedProperty>] [-ConditionalCustomAttribute7 <MultiValuedProperty>] [-ConditionalCustomAttribute8 <MultiValuedProperty>] [-ConditionalCustomAttribute9 <MultiValuedProperty>] [-ConditionalDepartment <MultiValuedProperty>] [-ConditionalStateOrProvince <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <GlobalAddressList>] [-Name <String>] [-RecipientFilter <String>] [-UseRusServer <String>] [-WhatIf [<SwitchParameter>]]

자세한 설명

Set-GlobalAddressList cmdlet는 GAL에 대한 속성을 수정합니다.

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

  • Exchange 조직 관리자 역할

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

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.GlobalAddressListIdParameter

특정 GAL(전체 주소 목록)을 나타내는 GUID, 고유 이름 또는 GAL 이름을 지정하려면 Identity 매개 변수를 사용합니다. Path\GlobalAddressListName 형식을 사용하여 경로도 포함할 수 있습니다.

매개 변수 레이블 Identity를 생략하고 GAL 이름 또는 GUID만 지정할 수도 있습니다.

ConditionalCompany

선택

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalCompany 매개 변수는 회사를 지정하는 데 사용됩니다. 쉼표로 분리된 목록으로 여러 값을 사용할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute1

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute10

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute11

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute12

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute13

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute14

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute15

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute2

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute3

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute4

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute5

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute6

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute7

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute8

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalCustomAttribute9

선택

Microsoft.Exchange.Data.MultiValuedProperty

사용자 지정 특성을 지정하는 매개 변수입니다. 이러한 특성을 사용하여 추가 정보를 저장할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalDepartment

선택

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalDepartment 매개 변수는 부서를 지정하는 데 사용됩니다. 이 매개 변수에 대해 입력한 값과 일치하는 부서 특성을 가진 모든 GAL이 포함됩니다. 쉼표로 분리된 목록으로 여러 값을 사용할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

ConditionalStateOrProvince

선택

Microsoft.Exchange.Data.MultiValuedProperty

ConditionalStateOrProvince 매개 변수는 전체 주소 목록의 시/도를 설정합니다. 이 매개 변수는 여러 개의 값을 쉼표로 분리된 목록으로 받습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

Confirm

선택

System.Management.Automation.SwitchParameter

Confirm 매개 변수는 명령에서 처리 작업을 일시 중지하도록 하고 처리 작업을 계속하기 전 수행할 작업을 사용자가 확인하도록 합니다. Confirm 매개 변수에는 값을 지정할 필요가 없습니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

ForceUpgrade

선택

System.Management.Automation.SwitchParameter

ForceUpgrade 매개 변수는 확인 메시지 "개체의 변경 내용을 저장하려면 개체를 현재 Exchange 버전으로 업그레이드해야 합니다. 업그레이드 후에는 이전 버전의 Exchange System Manager에서 이 개체를 관리할 수 없습니다. 계속해서 개체를 업그레이드하고 저장하시겠습니까?"를 표시하지 않습니다. 이 확인 메시지는 Microsoft Exchange Server 2003이나 Exchange 2000 Server에서 만든 GAL을 업그레이드하면 표시됩니다. Exchange 관리 콘솔을 사용하여 Exchange 2003이나 Exchange 2000 GAL을 관리하려면 개체의 버전을 업데이트하고 RecipientFilter 또는 IncludedRecipients 매개 변수를 사용하여 받는 사람 필터를 변경해야 합니다.

IncludedRecipients

선택

System.Nullable

IncludedRecipients 매개 변수는 GAL을 작성하는 데 사용되는 받는 사람 유형을 필터링합니다. IncludedRecipients 매개 변수에 사용할 수 있는 값은 AllRecipients, MailboxUsers, Resources, Contacts 및 MailGroups입니다.

AllRecipients 값은 단독으로만 사용할 수 있습니다. IncludedRecipients 매개 변수의 여러 값이 쉼표로 구분된 경우에는 OR 부울 연산자가 적용됩니다.

Conditional 매개 변수를 사용하는 경우에는 이 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

Instance

선택

Microsoft.Exchange.Data.Directory.Management.GlobalAddressList

Instance 매개 변수를 사용하면 처리할 명령에 전체 개체를 전달할 수 있습니다. 이 매개 변수는 주로 전체 개체를 명령에 전달해야 하는 스크립트에서 사용됩니다.

Name

선택

System.String

Name 매개 변수는 전체 주소 목록의 새 이름을 지정합니다.

RecipientFilter

선택

System.String

RecipientFilter 매개 변수는 GAL에 포함시킬 받는 사람 필터를 지정합니다. 다음 필터 매개 변수 중 하나라도 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.

  • ConditionalCompany

  • ConditionalDepartment

  • IncludedRecipients

  • ConditionalStateorProvince

이 매개 변수나 앞에 나열된 필터 매개 변수 중 하나를 사용해야 합니다.

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

UseRusServer

선택

System.String

note참고:
이 매개 변수는 Exchange 2007 SP2에서만 사용할 수 있습니다.

UseRusServer 매개 변수는 주소 목록 서비스를 실행 중인 지정된 사서함 서버를 사용하여 사서함 및 Active Directory 사용자 특성을 가져와 설정하도록 명령에 지시합니다.

주소 목록 서비스는 Exchange 시스템 수행자 서비스의 구성 요소로, Active Directory에서 Exchange 관련 특성 값을 만들어 유지 관리합니다. 주소 목록 서비스를 통해 주소 목록 구성원 및 전자 메일 주소 같은 특정 정보를 사용하여 도메인의 받는 사람 개체를 업데이트할 수 있습니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

WhatIf 매개 변수는 명령 실행 시 개체에 대해 수행하게 되는 작업을 시뮬레이트하도록 지시합니다. WhatIf 매개 변수를 사용하면 사용자는 변경 내용을 실제로 적용하지 않고 어떠한 사항이 변경되는지 확인할 수 있습니다. WhatIf 매개 변수에는 값을 지정할 필요가 없습니다.

입력 형식

반환 형식

오류

오류 설명

 

예외

예외 설명

 

예제

이 예에서는 Set-GlobalAddressList 명령을 사용하여 GUID가 96d0c505-eba8-4103-ad4f-577a1bf4ad7b인 GAL에 새 이름, GALwithNewName을 지정합니다.

Set-GlobalAddressList 96d0c505-eba8-4103-ad4f-577a1bf4ad7b -Name GALwithNewName