Set-User (RTM)

 

适用于: Exchange Server 2007

上一次修改主题: 2007-06-05

使用 Set-User cmdlet 可以修改 Active Directory 目录服务中的用户属性。

语法

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

set-User [-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 <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>] [-Title <String>] [-UMDialPlan <UMDialPlanIdParameter>] [-UMDtmfMap <MultiValuedProperty>] [-UserPrincipalName <String>] [-WebPage <String>] [-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) 地址

  • 别名

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 参数定义用户的显示名称。

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

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。

LastName

可选

System.String

LastName 参数定义用户的姓。

Manager

可选

Microsoft.Exchange.Configuration.Tasks.UserContactIdParameter

Manager 参数定义用户的主管。

MobilePhone

可选

System.String

MobilePhone 参数定义用户的主要移动电话号码。

Name

可选

System.String

Name 参数定义用户的公用名。

便笺

可选

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 参数定义用户的信箱号码。

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 参数显示对象的备用说明。这组有限的字符包括从 26 到 126 的 ASCII 字符(包含 26 和 126)。

StateOrProvince

可选

System.String

StateOrProvince 参数定义用户所在的省或自治区。

StreetAddress

可选

System.String

StreetAddress 参数定义用户的实际地址。

Title

可选

System.String

Title 参数定义用户的职务。

UMDialPlan

可选

Microsoft.Exchange.Configuration.Tasks.UMDialPlanIdParameter

此参数指定拨号计划的目录对象 ID。

UMDtmfMap

可选

Microsoft.Exchange.Data.MultiValuedProperty

此参数指定是否需要为启用 UM 的用户创建用户定义的 DTMF 映射。

UserPrincipalName

可选

System.String

UserPrincipalName 参数定义用户的用户主要名称 (UPN)。

WebPage

可选

System.String

WebPage 参数定义用户的网页。

WindowsEmailAddress

可选

Microsoft.Exchange.Data.SmtpAddress

WindowsEmailAddress 参数指定收件人的电子邮件地址。

输入类型

返回类型

错误

错误 说明

  

 

异常

异常 说明

  

 

示例

在下面的示例中,使用 Set-User 命令来设置用户 Ted Bremer 的显示名称。

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