Set-AddressList(RTM)
적용 대상: Exchange Server 2007
마지막으로 수정된 항목: 2007-10-23
Set-AddressList cmdlet를 사용하여 기존 주소 목록을 수정할 수 있습니다.
구문
Set-AddressList -Identity <AddressListIdParameter> [-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>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Name <String>] [-RecipientFilter <String>]
Set-AddressList [-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>] [-ForceUpgrade <SwitchParameter>] [-IncludedRecipients <Nullable>] [-Instance <AddressList>] [-Name <String>] [-RecipientFilter <String>]
자세한 정보
Set-AddressList cmdlet를 실행하려면 사용하는 계정이 다음을 위임받아야 합니다.
- Exchange 조직 관리자 역할
사용 권한, 역할 위임 및 Microsoft Exchange Server 2007 관리에 필요한 권한에 대한 자세한 내용은 사용 권한 고려 사항을 참조하십시오.
Exchange 관리 콘솔을 사용하여 Exchange Server 2003이나 Exchange 2000 Server에서 만들어진 주소 목록을 관리하려면 다음 작업을 수행해야 합니다.
ForceUpgrade 매개 변수를 사용하는 주소 목록의 버전 특성을 업데이트합니다.
RecipientFilter 매개 변수나 다음 필터 매개 변수 중 하나를 사용하는 받는 사람 필터를 변경합니다.
ConditionalCompany
ConditionalDepartment
ConditionalStateOrProvince
IncludedRecipients
매개 변수
| 매개 변수 | 필수 | 종류 | 설명 |
|---|---|---|---|
Identity |
필수 |
Microsoft.Exchange.Configuration.Tasks.AddressListIdParameter |
특정 주소 목록을 나타내는 GUID, 고유 이름 또는 주소 목록 이름을 지정하려면 Identity 매개 변수를 사용합니다. Path\AddressListName 형식을 사용하여 경로도 포함할 수 있습니다. 매개 변수 레이블 Identity를 생략하고 주소 목록 이름 또는 GUID만 지정할 수도 있습니다. |
ConditionalCompany |
선택 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalCompany 매개 변수는 회사를 지정하는 필터입니다. 이 매개 변수에 대해 입력한 값과 일치하는 회사 특성을 가진 받는 사람은 모두 수정되는 주소 목록에 포함됩니다. 쉼표로 분리된 목록으로 여러 값을 사용할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute1 |
선택 |
System.String |
ConditionalCustomAttribute1 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute10 |
선택 |
System.String |
ConditionalCustomAttribute10 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute11 |
선택 |
System.String |
ConditionalCustomAttribute11 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute12 |
선택 |
System.String |
ConditionalCustomAttribute12 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute13 |
선택 |
System.String |
ConditionalCustomAttribute13 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute14 |
선택 |
System.String |
ConditionalCustomAttribute14 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute15 |
선택 |
System.String |
ConditionalCustomAttribute15 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute2 |
선택 |
System.String |
ConditionalCustomAttribute2 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute3 |
선택 |
System.String |
ConditionalCustomAttribute3 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute4 |
선택 |
System.String |
ConditionalCustomAttribute4 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute5 |
선택 |
System.String |
ConditionalCustomAttribute5 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute6 |
선택 |
System.String |
ConditionalCustomAttribute6 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute7 |
선택 |
System.String |
ConditionalCustomAttribute7 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute8 |
선택 |
System.String |
ConditionalCustomAttribute8 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalCustomAttribute9 |
선택 |
System.String |
ConditionalCustomAttribute9 매개 변수는 사용자 지정 특성을 지정합니다. 사용자 지정 특성을 통해 주소 목록을 정렬하거나 그룹화하는 데 사용되는 정보를 주소 목록에 추가할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalDepartment |
선택 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalDepartment 매개 변수는 부서를 지정하는 필터입니다. 이 매개 변수에 대해 입력한 값과 일치하는 부서 특성을 가진 받는 사람은 모두 주소 목록에 포함됩니다. 쉼표로 분리된 목록으로 여러 값을 사용할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
ConditionalStateOrProvince |
선택 |
Microsoft.Exchange.Data.MultiValuedProperty |
ConditionalStateOrProvince 매개 변수는 시/도를 지정하는 필터입니다. 이 매개 변수에 대해 입력한 값과 일치하는 ConditionalStateOrProvince 특성을 가진 받는 사람은 모두 주소 목록에 포함됩니다. 쉼표로 분리된 목록으로 여러 값을 사용할 수 있습니다. Conditional 매개 변수를 사용하는 경우에는 IncludedRecipients 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
DisplayName |
선택 |
System.String |
DisplayName 매개 변수는 주소 목록에 사용할 원하는 표시 이름을 지정합니다. |
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에서 만든 주소 목록을 업그레이드하면 표시됩니다. Exchange 관리 콘솔을 통해 Exchange 2003 또는 Exchange 2000 주소 목록을 관리하려면 개체의 버전을 업데이트하고 RecipientFilter 또는 IncludedRecipients 매개 변수를 사용하여 받는 사람 필터를 변경해야 합니다. |
IncludedRecipients |
선택 |
System.Nullable |
IncludedRecipients 매개 변수는 GAL(전체 주소 목록)을 작성하는 데 사용되는 받는 사람 유형을 필터링합니다. IncludedRecipients 매개 변수에 사용할 수 있는 값은 AllRecipients, MailboxUsers, Resources, Contacts 및 MailGroups입니다. AllRecipients 값은 단독으로만 사용할 수 있습니다. IncludedRecipients 매개 변수의 여러 값이 쉼표로 구분된 경우에는 OR 부울 연산자가 적용됩니다. Conditional 매개 변수를 사용하는 경우에는 이 매개 변수를 사용해야 합니다. RecipientFilter 매개 변수를 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다. |
Instance |
선택 |
Microsoft.Exchange.Data.Directory.Management.AddressList |
Instance는 명령줄을 사용하는 관리자는 거의 사용하지 않는 매개 변수입니다. 개발자가 참고할 수 있도록 매개 변수 표에 포함되어 있는 것입니다. |
Name |
선택 |
System.String |
Name 매개 변수는 주소 목록에 사용할 새 이름을 지정합니다. 이름은 64자를 초과할 수 없고 캐리지 리턴이나 줄 바꿈(\)을 포함할 수 없습니다. |
RecipientFilter |
선택 |
System.String |
RecipientFilter 매개 변수는 주소 목록에 포함할 받는 사람에 대한 필터를 지정합니다. 다음 필터 매개 변수 중 하나라도 사용하는 경우에는 이 매개 변수를 사용할 수 없습니다.
필터링할 수 있는 속성에 대한 자세한 내용은 -RecipientFilter 매개 변수의 필터링할 수 있는 속성을 참조하십시오. |
입력 형식
반환 형식
오류
| 오류 | 설명 |
|---|---|
|
|
예외
| 예외 | 설명 |
|---|---|
|
|
예제
첫 번째 예는 기존 주소 목록의 이름을 수정하는 방법을 보여줍니다.
두 번째 예는 MyAddressList2라는 기존 주소 목록에 포함될 받는 사람의 유형과 부서를 수정하는 방법을 보여줍니다. MyAddressList2는 Exchange 2003의 주소 목록이므로 이 명령으로 이 주소 목록도 업그레이드됩니다.
Set-AddressList -Identity "All Users\Sales\building4" -Name building9
Set-Addresslist -Identity c3fffd8e-026b-41b9-88c4-8c21697ac8ac -IncludedRecipients UserMailbox -ConditionalDepartment Sales -ForceUpgrade:$true
Format-List로 파이프된 Get-AddressList 명령을 사용하여 기존 주소 목록의 경로 및 이름 또는 GUID, 고유 이름을 가져옵니다. 또는 Get-AddressList를 사용하여 특정 기존 주소 목록을 가져온 다음 Set-AddressList로 직접 출력을 파이프합니다.