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) 地址 别名
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。
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 参数的拼音发音。 此参数值的最大长度为 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	注意： 此参数仅在 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