Set-Contact

아티클
09/30/2014

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

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

Set-Contact cmdlet를 사용하여 기존 연락처 설정을 수정할 수 있습니다.

구문

Set-Contact -Identity <ContactIdParameter> [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

Set-Contact [-AllowUMCallsFromNonUsers <None | SearchEnabled>] [-AssistantName <String>] [-City <String>] [-Company <String>] [-Confirm [<SwitchParameter>]] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-IgnoreDefaultScope <SwitchParameter>] [-Initials <String>] [-Instance <Contact>] [-LastName <String>] [-Manager <UserContactIdParameter>] [-MobilePhone <String>] [-Name <String>] [-Notes <String>] [-Office <String>] [-OtherFax <MultiValuedProperty>] [-OtherHomePhone <MultiValuedProperty>] [-OtherTelephone <MultiValuedProperty>] [-Pager <String>] [-Phone <String>] [-PhoneticDisplayName <String>] [-PostalCode <String>] [-PostOfficeBox <MultiValuedProperty>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

자세한 정보

Set-Contact cmdlet를 사용하여 Active Directory 사용자 및 컴퓨터에 나타나는 연락처 개체의 설정을 수정할 수 있습니다. 해당 연락처에서 메일이 사용 가능하도록 설정된 경우 Set-MailContact cmdlet를 사용하여 Set-Contact cmdlet 사용으로는 수정할 수 없었던 연락처의 전자 메일 설정을 수정할 수 있습니다.

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

Exchange 받는 사람 관리자 역할
적용 가능한 Active Directory 컨테이너에 대한 계정 운영자 역할

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

매개 변수

Identity

필수

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

Identity 매개 변수는 수정하려는 개체를 지정합니다. Identity 매개 변수는 연락처 개체에 대해 다음 값 중에서 선택하여 사용할 수 있습니다.

GUID
DN(고유 이름)
정식 이름
이름

Instance 매개 변수가 지정된 경우에는 Identity 매개 변수를 사용할 수 없습니다.

AllowUMCallsFromNonUsers

선택

Microsoft.Exchange.Data.Directory.Recipient.AllowUMCallsFromNonUsersFlags

이 매개 변수는 디렉터리 검색에서 연락처를 제외할지 여부를 지정합니다.

AssistantName

선택

System.String

AssistantName 매개 변수는 연락처의 비서 이름을 정의합니다.

City

선택

System.String

City 매개 변수는 연락처의 구/군/시를 정의합니다.

Company

선택

System.String

Company 매개 변수는 연락처의 회사를 정의합니다.

Confirm

선택

System.Management.Automation.SwitchParameter

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

CountryOrRegion

선택

Microsoft.Exchange.Data.Directory.CountryInfo

CountryOrRegion 매개 변수는 연락처의 국가나 지역을 정의합니다.

CreateDTMFMap

선택

System.Boolean

이 매개 변수는 연락처에 대해 DTMF(복합 주파수 부호) 맵을 만들도록 지정합니다.

Department

선택

System.String

Department 매개 변수는 연락처의 부서를 정의합니다.

DisplayName

선택

System.String

DisplayName 매개 변수를 사용하여 Exchange 관리 콘솔과 Exchange GAL(전체 주소 목록)에서 연락처 이름을 지정할 수 있습니다. DisplayName은 메일이 사용 가능하도록 설정된 개체에 대해서만 사용됩니다.

DomainController

선택

Microsoft.Exchange.Data.Fqdn

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

Fax

선택

System.String

Fax 매개 변수는 연락처의 팩스 번호를 정의합니다.

FirstName

선택

System.String

FirstName 매개 변수는 연락처의 이름을 정의합니다.

HomePhone

선택

System.String

HomePhone 매개 변수는 연락처의 집 전화 번호를 정의합니다.

IgnoreDefaultScope

선택

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 매개 변수는 명령이 Exchange 관리 셸에 대한 기본 받는 사람 범위 설정을 무시하고 해당 범위로 전체 포리스트를 사용하도록 지시합니다. 이렇게 하면 명령은 현재 기본 범위에 있지 않은 Active Directory 개체에 액세스할 수 있습니다. IgnoreDefaultScope 매개 변수를 사용하면 다음과 같은 제한이 적용됩니다.

DomainController 매개 변수를 사용할 수 없습니다. 해당 명령은 적합한 글로벌 카탈로그 서버를 자동으로 사용합니다.
Identity 매개 변수의 DN만 사용할 수 있습니다. 별칭이나 GUID 등 다른 ID 형태는 사용할 수 없습니다.

Initials

선택

System.String

Initials 매개 변수는 연락처 이름에 대한 이니셜을 정의합니다.

Instance

선택

Microsoft.Exchange.Data.Directory.Management.Contact

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

Identity 매개 변수가 지정된 경우에는 Instance 매개 변수를 사용할 수 없습니다.

LastName

선택

System.String

LastName 매개 변수는 연락처의 성을 정의합니다.

Manager

선택

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

Manager 매개 변수는 연락처의 관리자를 정의합니다.

MobilePhone

선택

System.String

MobilePhone 매개 변수는 연락처의 기본 휴대폰 번호를 정의합니다.

Name

선택

System.String

Name 매개 변수는 Active Directory 사용자 및 컴퓨터와, 그룹에서 메일 사용이 가능한 경우 Exchange 관리 콘솔의 그룹 이름 필드에 연락처의 이름을 지정합니다.

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

Notes

선택

System.String

Notes 매개 변수는 연락처에 대한 추가 정보를 정의합니다.

Office

선택

System.String

Office 매개 변수는 연락처의 실제 사무실 이름이나 번호를 정의합니다.

OtherFax

선택

Microsoft.Exchange.Data.MultiValuedProperty

OtherFax 매개 변수는 연락처의 대체 팩스 번호를 정의합니다.

OtherHomePhone

선택

Microsoft.Exchange.Data.MultiValuedProperty

OtherHomePhone 매개 변수는 연락처의 대체 집 전화 번호를 정의합니다.

OtherTelephone

선택

Microsoft.Exchange.Data.MultiValuedProperty

OtherTelephone 매개 변수는 연락처의 대체 사무실 전화 번호를 정의합니다.

Pager

선택

System.String

Pager 매개 변수는 연락처의 호출기 번호를 정의합니다.

Phone

선택

System.String

Phone 매개 변수는 연락처의 사무실 전화 번호를 정의합니다.

PhoneticDisplayName

선택

System.String

PhoneticDisplayName 매개 변수는 DisplayName 매개 변수의 음성 발음을 정의합니다.

이 매개 변수 값의 최대 길이는 255자입니다. PhoneticDisplayName 매개 변수 및 음성 인식에 대한 자세한 내용은 자동 음성 인식 디렉터리 조회 이해를 참조하십시오.

PostalCode

선택

System.String

PostalCode 매개 변수는 연락처의 우편 번호를 정의합니다.

PostOfficeBox

선택

Microsoft.Exchange.Data.MultiValuedProperty

PostOfficeBox 매개 변수는 연락처의 사서함 번호를 정의합니다.

SimpleDisplayName

선택

System.String

SimpleDisplayName 매개 변수는 제한된 문자 집합만 허용되는 경우 개체에 대한 대체 설명을 표시하는 데 사용됩니다. 이와 같이 제한된 문자 집합은 다음 문자로 구성됩니다.

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789\"()+,-./:?

SimpleDisplayName은 메일이 사용 가능하도록 설정된 개체에 대해서만 사용됩니다.

StateOrProvince

선택

System.String

StateOrProvince 매개 변수는 연락처의 시/도를 정의합니다.

StreetAddress

선택

System.String

StreetAddress 매개 변수는 연락처의 실제 주소를 정의합니다.

TelephoneAssistant

선택

System.String

TelephoneAssistant 매개 변수는 연락처의 비서 전화 번호를 정의합니다.

Title

선택

System.String

Title 매개 변수는 연락처의 직함을 정의합니다.

UMDialPlan

선택

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

이 매개 변수는 다이얼 플랜의 디렉터리 개체 ID를 지정합니다.

UMDtmfMap

선택

Microsoft.Exchange.Data.MultiValuedProperty

이 매개 변수는 UM 사용 가능 연락처에 대해 사용자 정의 DTMF 맵을 만들지 여부를 지정합니다.

UseRusServer

선택

System.String

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

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

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

WebPage

선택

System.String

WebPage 매개 변수는 연락처의 웹 페이지를 정의합니다.

WhatIf

선택

System.Management.Automation.SwitchParameter

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

WindowsEmailAddress

선택

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress 매개 변수는 Active Directory에 저장되는 연락처의 전자 메일 주소를 지정합니다.

입력 형식

반환 형식

오류

오류	설명

예외

예외	설명

예제

다음 코드 예에서는 Set-Contact 명령을 사용하여 contoso.com이라는 Active Directory 도메인의 사용자 컨테이너에서 Ted Bremer라는 기존 연락처를 다음과 같이 변경하는 방법을 보여줍니다.

구/군/시 값을 Seattle로 변경합니다.
회사 값을 Contoso로 변경합니다.

Set-Contact -Identity "contoso.com/Users/Ted Bremer" -City "Seattle" -Company "Contoso"

Set-Contact

구문

자세한 정보

매개 변수

입력 형식

반환 형식

오류

예외

예제

추가 리소스