Set-User

 

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

마지막으로 수정된 항목: 2011-01-12

Set-User cmdlet를 사용하여 Active Directory 디렉터리 서비스의 사용자 특성을 수정합니다.

구문

set-User -Identity <UserIdParameter> [-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>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

set-User [-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 <User>] [-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>] [-ResetPasswordOnNextLogon <$true | $false>] [-SamAccountName <String>] [-SimpleDisplayName <String>] [-StateOrProvince <String>] [-StreetAddress <String>] [-TelephoneAssistant <String>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-UseRusServer <String>] [-WebPage <String>] [-WhatIf [<SwitchParameter>]] [-WindowsEmailAddress <SmtpAddress>]

자세한 정보

Set-User cmdlet는 Active Directory의 기존 사용자 특성을 수정합니다.

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

  • Exchange 받는 사람 관리자 역할

  • 적용 가능한 Active Directory 컨테이너에 대한 계정 운영자 역할

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

매개 변수

매개 변수 필수 종류 설명

Identity

필수

Microsoft.Exchange.Configuration.Tasks.UserIdParameter

Identity 매개 변수에 다음 값 중 하나를 입력합니다.

  • GUID

  • DN(고유 이름)

  • 도메인\계정

  • UPN(사용자 이름)

  • 레거시 Exchange DN

  • SMTP(Simple Mail Transfer Protocol) 주소

  • 별칭

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 매개 변수는 사용자의 표시 이름을 정의합니다.

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.User

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

LastName

선택

System.String

LastName 매개 변수는 사용자의 성을 정의합니다.

Manager

선택

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

Manager 매개 변수는 사용자의 관리자를 정의합니다.

MobilePhone

선택

System.String

MobilePhone 매개 변수는 사용자의 기본 휴대폰 번호를 정의합니다.

Name

선택

System.String

Name 매개 변수는 사용자의 일반 이름을 정의합니다.

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 매개 변수의 Phonetic 발음을 지정합니다.

이 매개 변수 값은 최대 255자까지 지정할 수 있습니다. PhoneticDisplayName 매개 변수 및 음성 인식에 대한 자세한 내용은 자동 음성 인식 디렉터리 조회 이해를 참조하십시오.

PostalCode

선택

System.String

PostalCode 매개 변수는 사용자의 우편 번호를 정의합니다.

PostOfficeBox

선택

Microsoft.Exchange.Data.MultiValuedProperty

PostOfficeBox 매개 변수는 사용자의 사서함 번호를 정의합니다.

ResetPasswordOnNextLogon

선택

System.Boolean

ResetPasswordOnNextLogon 매개 변수는 다음에 사용자가 로그온할 때 Password 매개 변수에 지정된 암호를 다시 설정해야 하는지 여부를 지정합니다. 기본값은 $true입니다.

SamAccountName

선택

System.String

SamAccountName 매개 변수는 Microsoft Windows NT 4.0, Windows 98, Windows 95, LAN Manager와 같은 이전 버전의 운영 체제에서 실행되는 클라이언트와 서버를 지원하는 데 사용되는 로그온 이름을 정의합니다. 이 특성은 20 자 이내여야 합니다.

SimpleDisplayName

선택

System.String

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

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

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 맵을 만들지 여부를 지정합니다.

UserPrincipalName

선택

System.String

UserPrincipalName 매개 변수는 사용자의 UPN(사용자 이름)을 정의합니다.

UseRusServer

선택

System.String

note참고:
이 매개 변수는 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 매개 변수는 받는 사람의 전자 메일 주소를 지정합니다.

입력 형식

반환 형식

오류

오류 설명

  

 

예외

예외 설명

  

 

설명

다음은 Set-User 명령을 사용하여 Ted Bremer라는 사용자의 표시 이름을 지정하는 예입니다.

코드

Set-User -Identity Contoso\Ted -DisplayName "Ted Bremer" 

설명

다음 예에서는 Set-User 명령을 사용하여 -manager 값을 제거합니다. 이렇게 하려면 다음과 같이 $null을 지정해야 합니다.

코드

Set-User -Identity Contoso\Ted -manager $null