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 매개 변수는 연락처 개체에 대해 다음 값 중에서 선택하여 사용할 수 있습니다.
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"