Share via


Set-Contact(RTM)

 

적용 대상: Exchange Server 2007

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

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

구문

Set-Contact -Identity <ContactIdParameter> [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-WebPage <String>]

Set-Contact [-AssistantName <String>] [-City <String>] [-Company <String>] [-CountryOrRegion <CountryInfo>] [-CreateDTMFMap <$true | $false>] [-Department <String>] [-DisplayName <String>] [-DomainController <Fqdn>] [-Fax <String>] [-FirstName <String>] [-HomePhone <String>] [-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>] [-WebPage <String>]

자세한 정보

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

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

  • Exchange 받는 사람 관리자 역할

  • 해당하는 Active Directory 컨테이너에 대한 계정 운영자 역할

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

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.ContactIdParameter

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

  • GUID

  • DN(고유 이름)

  • 정식 이름

  • Name

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

AssistantName

선택

System.String

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

City

선택

System.String

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

Company

선택

System.String

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

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 매개 변수는 연락처의 집 전화 번호를 정의합니다.

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자를 초과할 수 없습니다.

참고

선택

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 매개 변수는 제한된 문자 집합만 허용되는 경우 개체에 대한 대체 설명을 표시하는 데 사용됩니다. 제한된 문자 집합은 26자에서 126자까지의 ASCII 문자로 구성됩니다. 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 맵을 만들지 여부를 지정합니다.

WebPage

선택

System.String

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

입력 형식

반환 형식

오류

오류 설명

 

 

예외

예외 설명

 

 

예제

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

  • 구/군/시 값을 Seattle로 변경합니다.

  • 회사 값을 Contoso로 변경합니다.

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