Set-User
此 cmdlet 可在本地 Exchange 和基于云的服务中使用。 一些参数和设置可能只适用于某个特定的环境。
使用 Set-User cmdlet 修改用户属性。 可以使用此 cmdlet 修改具有用户帐户的所有对象， (例如用户邮箱、邮件用户和用户帐户) 。
有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。
语法
Set-User
[-Identity] <UserIdParameter>
[-AllowUMCallsFromNonUsers <AllowUMCallsFromNonUsersFlags>]
[-Arbitration]
[-AssistantName <String>]
[-AuthenticationPolicy <String>]
[-BlockCloudCache <Boolean>]
[-CanHaveCloudCache <Boolean>]
[-CertificateSubject <MultiValuedProperty>]
[-City <String>]
[-ClearDataEncryptionPolicy]
[-Company <String>]
[-Confirm]
[-CountryOrRegion <CountryInfo>]
[-CreateDTMFMap <Boolean>]
[-Department <String>]
[-DesiredWorkloads <MailboxWorkloadFlags>]
[-DisplayName <String>]
[-DomainController <Fqdn>]
[-Fax <String>]
[-FirstName <String>]
[-Force]
[-GeoCoordinates <GeoCoordinates>]
[-HomePhone <String>]
[-IgnoreDefaultScope]
[-Initials <String>]
[-LastName <String>]
[-LinkedCredential <PSCredential>]
[-LinkedDomainController <String>]
[-LinkedMasterAccount <UserIdParameter>]
[-MailboxRegion <String>]
[-MailboxRegionSuffix <MailboxRegionSuffixValue>]
[-Manager <UserContactIdParameter>]
[-MobilePhone <String>]
[-Name <String>]
[-Notes <String>]
[-Office <String>]
[-OtherFax <MultiValuedProperty>]
[-OtherHomePhone <MultiValuedProperty>]
[-OtherTelephone <MultiValuedProperty>]
[-Pager <String>]
[-PermanentlyClearPreviousMailboxInfo]
[-Phone <String>]
[-PhoneticDisplayName <String>]
[-PostalCode <String>]
[-PostOfficeBox <MultiValuedProperty>]
[-PublicFolder]
[-RemotePowerShellEnabled <Boolean>]
[-RemoveMailboxProvisioningConstraint]
[-ResetPasswordOnNextLogon <Boolean>]
[-SamAccountName <String>]
[-SeniorityIndex <Int32>]
[-SimpleDisplayName <String>]
[-SkipDualWrite]
[-StateOrProvince <String>]
[-StreetAddress <String>]
[-StsRefreshTokensValidFrom <DateTime>]
[-TelephoneAssistant <String>]
[-Title <String>]
[-UMCallingLineIds <MultiValuedProperty>]
[-UMDtmfMap <MultiValuedProperty>]
[-UserPrincipalName <String>]
[-VIP <Boolean>]
[-WebPage <String>]
[-WhatIf]
[-WindowsEmailAddress <SmtpAddress>]
[<CommonParameters>]说明
Set-User cmdlet 不包含邮箱或邮件用户与邮件相关的属性。 若要修改用户的邮件相关属性，需要基于对象类型使用相应的 cmdlet (例如，Set-Mailbox或 Set-MailUser) 。
您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-User -Identity Contoso\Jill -DisplayName "Jill Frank"本示例设置用户 Jill Frank 的显示名称。
示例 2
Set-User -Identity Kweku@fabrikam.com -LinkedMasterAccount $null此示例通过将 LinkedMasterAccount 参数设置为 $null，取消链接 Kweku@fabrikam.com 邮箱并将其转换为用户邮箱。
对链接邮箱执行此过程会删除对邮箱的所有权限，例如“发送方式”、“完全访问权限”、“文件夹”和“日历委派”。
参数
-AllowUMCallsFromNonUsers
此参数只在本地 Exchange 中可用。
AllowUMCallsFromNonUsers 参数指定是否从统一消息目录搜索中排除用户。
| Type: | AllowUMCallsFromNonUsersFlags |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Arbitration
此参数只在本地 Exchange 中可用。
修改仲裁邮箱需要仲裁开关。 不必为此开关指定值。
仲裁邮箱是用于存储不同类型的系统数据和管理邮件审批工作流的系统邮箱。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AssistantName
AssistantName 参数指定用户助理的姓名。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-AuthenticationPolicy
AuthenticationPolicy 参数指定要应用于用户的身份验证策略。 可以使用任何能够唯一标识该策略的值。 例如：
- 名称
- 可分辨名称 (DN)
- GUID
若要删除用户的策略分配，请使用 值$null。
使用 New-AuthenticationPolicy cmdlet 创建身份验证策略，以阻止或选择性地允许 Exchange 2019 CU2 或更高版本中的基本身份验证或 (，) 其他旧式身份验证方法。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2019, Exchange Online, Exchange Online Protection |
-BlockCloudCache
此参数仅在基于云的服务中可用。
{{ Fill BlockCloudCache Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-CanHaveCloudCache
此参数仅在基于云的服务中可用。
{{ Fill CanHaveCloudCache Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-CertificateSubject
此参数只在本地 Exchange 中可用。
CertificateSubject 参数指定用户数字证书的主题字段的值。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-City
City 参数指定用户所在的城市。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-ClearDataEncryptionPolicy
此参数仅在基于云的服务中可用。
{{ Fill ClearDataEncryptionPolicy Description }}
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Company
Company 参数指定用户所在的公司。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Confirm
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet (例如，Remove-* cmdlet) 具有内置的暂停，该暂停会强制你在继续操作之前确认命令。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：
-Confirm:$false。 - 大多数其他 cmdlet (例如，New-* 和 Set-* cmdlet) 没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-CountryOrRegion
CountryOrRegion 参数指定用户所在的国家/地区。 有效值是有效的 ISO 3166-1 双字母国家/地区代码 (例如，澳大利亚的 AU) 或国家/地区 (的相应友好名称，这可能不同于官方的 ISO 3166 维护机构短名称) 。
国家/地区代码列表中提供了双字母国家/ 地区代码的参考。
友好名称由 Get-User cmdlet 在 CountryOrRegion 属性值中返回，但可以在筛选器操作中使用友好名称或双字母国家/地区代码。
| Type: | CountryInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-CreateDTMFMap
此参数只在本地 Exchange 中可用。
CreateDTMFMap 参数指定是否为收件人创建双音多频 (DTMF) 映射。 这允许在统一消息 (UM) 环境中使用电话键盘来标识收件人。 有效值包含:
- $true：为收件人创建 DTMF 映射。 此值为默认值。
- $true：为收件人创建 DTMF 映射。此为默认值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Department
Department 参数指定用户所在的部门。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DesiredWorkloads
此参数仅在基于云的服务中可用。
{{ Fill DesiredWorkloads Description }}
| Type: | Microsoft.Exchange.Data.MailboxWorkloadFlags |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-DisplayName
DisplayName 参数指定用户的显示名称。 显示名称在 Exchange 管理中心和 Active Directory 中可见。 长度不得超过 256 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainController
此参数只在本地 Exchange 中可用。
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Fax
Fax 参数指定用户的传真号码。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-FirstName
FirstName 参数指定用户的名字。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Force
此参数仅在基于云的服务中可用。
强制开关隐藏警告或确认消息。 不必为此开关指定值。
您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-GeoCoordinates
GeoCoordinates 参数指定用户的纬度、经度和 (位置（可选) 高度坐标）。 此参数的有效值使用以下格式之一：
- 纬度和经度：例如，“47.644125;-122.122411”
- 纬度、经度和高度：例如“47.644125;-122.122411;161.432”
注意：如果句点分隔符不起作用，请改用逗号。
| Type: | GeoCoordinates |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-HomePhone
HomePhone 参数指定用户的家庭电话号码。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Identity
Identity 参数指定要修改的用户。 可以使用任何能够唯一标识该用户的值。 例如：
- 名称
- 用户主体名称 (UPN)
- 可分辨名称 (DN)
- 可分辨名称 (DN)
- GUID
- UserPrincipalName
| Type: | UserIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-IgnoreDefaultScope
此参数只在本地 Exchange 中可用。
IgnoreDefaultScope 开关指示命令忽略 Exchange PowerShell 会话的默认收件人范围设置，并将整个林用作范围。 不必为此开关指定值。
此开关使命令能够访问当前在默认范围中不可用的 Active Directory 对象，但也引入了以下限制：
- 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
- 无法使用 DomainController 参数。 此命令自动使用相应的全局编录服务器。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Initials
Initials 参数指定用户姓名的中间名首字母。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-LastName
LastName 参数指定用户的姓氏。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-LinkedCredential
此参数只在本地 Exchange 中可用。
LinkedCredential 参数指定用于访问 LinkedDomainController 参数指定的域控制器的用户名和密码。
此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示，请使用值 (Get-Credential)。 或者，在运行此命令之前，请将凭据存储在变量（例如，$cred = Get-Credential）中，然后将变量名称 ($cred) 用作此参数。 有关详细信息，请参阅 Get-Credential。
只能将 LinkedCredential 参数和链接用户一起使用。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LinkedDomainController
此参数只在本地 Exchange 中可用。
LinkedDomainController 参数指定用户帐户所处林中的域控制器（如果此用户是链接用户）。 用户帐户所在林中的域控制器用于获取由 LinkedMasterAccount 参数指定的帐户的安全信息。
仅当连接链接用户时，才需要此参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-LinkedMasterAccount
此参数只在本地 Exchange 中可用。
LinkedMasterAccount 参数指定用户帐户所处林中的主帐户（如果此用户是链接用户）。 主帐户是用户链接到的帐户。 主帐户授予对用户的访问权限。 可以使用下列值之一：
- GUID
- Dn
- 域\帐户
- UPN
- LegacyExchangeDN
- SmtpAddress
- 别名
- $null
如果您将此参数的值设置为 $null，则会取消帐户的链接并将链接的邮箱转换为非链接用户邮箱。 邮箱不会保留以前对其设置的权限（如代理发送、完全访问、文件夹和日历委派）。
仅当连接链接用户时，才需要此参数。
| Type: | UserIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-MailboxRegion
此参数仅在基于云的服务中可用。
{{ Fill MailboxRegion Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MailboxRegionSuffix
此参数仅在基于云的服务中可用。
{{ Fill MailboxRegionSuffix Description }}
| Type: | MailboxRegionSuffixValue |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Manager
Manager 参数指定用户的经理。
| Type: | UserContactIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MobilePhone
MobilePhone 参数指定用户的主要移动电话号码。
注意：在 Exchange Online 中，不能使用此参数。 请改用 Microsoft Graph PowerShell 中的 Update-MgUser cmdlet 上的 MobilePhone 参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Name
Name 参数指定用户的唯一名称。 最大长度为 64 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Notes
Notes 参数指定对象的其他信息。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Office
Office 参数指定用户的实际办公室名称或号码。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherFax
OtherFax 参数指定用户的备用传真号码。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherHomePhone
OtherHomePhone 参数指定用户的备用家庭电话号码。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OtherTelephone
OtherTelephone 参数指定用户的备用电话号码。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Pager
Pager 参数指定用户的寻呼机号码。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PermanentlyClearPreviousMailboxInfo
此参数在本地 Exchange 中不可用或不起作用。 它仅在 Exchange Online 中可用。
PermanentlyClearPreviousMailboxInfo 开关指定是否清除用户Exchange Online邮箱属性。 不必为此开关指定值。
在本地 Exchange 和 Microsoft 365 之间的邮箱移动和重新许可方案中，可能需要清除这些属性。 有关详细信息，请参阅 永久清除以前的邮箱信息。
警告：此开关会永久删除现有云邮箱及其关联的存档，阻止你重新连接到邮箱，并阻止你从邮箱中恢复内容。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Phone
Phone 参数指定用户的办公电话号码。
注意：在 Exchange Online 中，不能使用此参数。 请改用 Microsoft Graph PowerShell 中的 Update-MgUser cmdlet 上的 BusinessPhones 参数。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PhoneticDisplayName
PhoneticDisplayName 参数指定在统一消息 (UM) 环境中进行文本到语音转换时使用的用户名的备用拼写。 通常在用户名的发音和拼写不匹配时使用此参数。 长度不得超过 256 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PostalCode
PostalCode 参数指定用户的邮政编码。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PostOfficeBox
PostOfficeBox 参数指定用户的邮政信箱号码。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PublicFolder
需要 PublicFolder 开关才能修改公用文件夹邮箱。 不必为此开关指定值。
公用文件夹邮箱是专门用于存储公用文件夹的层次结构和内容的邮箱。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-RemotePowerShellEnabled
RemotePowerShellEnabled 参数指定用户是否可以使用远程 PowerShell。 需要远程 PowerShell 访问权限才能打开 Exchange 命令行管理程序或 Exchange 管理中心 (EAC) ，即使尝试打开 Exchange 命令行管理程序或本地邮箱服务器上的 EAC 也是如此。 有效值包含:
- $true：用户有权访问远程 PowerShell。
- $false：用户无权访问远程 PowerShell。
默认值取决于分配给用户的管理角色。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-RemoveMailboxProvisioningConstraint
此参数仅在基于云的服务中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ResetPasswordOnNextLogon
ResetPasswordOnNextLogon 参数指定用户下次登录时是否必须更改其密码。 有效值包含:
- $true：要求用户在下次登录时更改其密码。
- $false：用户下次登录时无需更改其密码。 此值为默认值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SamAccountName
此参数只在本地 Exchange 中可用。
SamAccountName 参数（亦称为 Windows 2000 以前版本的用户帐户或组名称）指定与旧版 Microsoft Windows 客户端和服务器操作系统兼容的对象标识符。 该值可以包含字母、数字、空格、句点 (.) ，以及以下字符：！、#、$、%^、 &、-、_、{、}和 ~。 不得以句点字符结尾。 虽然允许使用 Unicode 字符，但重音符号可能会产生冲突（例如，o 和 ö 匹配）。 长度不得超过 20 个字符。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SeniorityIndex
SeniorityIndex 参数指定此用户在分层通讯簿中的显示顺序。 在通讯簿中，值为 2 的用户显示在值为 1 的用户的前面。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SimpleDisplayName
当仅允许一组有限的字符时，SimpleDisplayName 参数用于显示对象的替代说明。 有效字符为：
- 如果只允许使用一组有限的字符，则 SimpleDisplayName 参数用于显示对象的备用说明。有效字符包括：
- a – z
- A - Z
- 空格
" ' ( ) + , - . / : ?
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-SkipDualWrite
此参数只在本地 Exchange 中可用。
保留此参数以供 Microsoft 内部使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2016, Exchange Server 2019 |
-StateOrProvince
StateOrProvince 参数指定用户所在的省或自治区。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-StreetAddress
StreetAddress 参数指定用户的实际地址。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-StsRefreshTokensValidFrom
此参数仅在基于云的服务中可用。
StsRefreshTokensValidFrom 指定用户的 STS 刷新令牌从其生效的日期时间。
请使用短日期格式，该格式在运行命令的计算机上的“区域选项”设置中定义。 例如，如果将计算机配置为使用短日期格式 mm/dd/yyyy，请输入 09/01/2018 来指定 2018 年 9 月 1 日。 可以只输入日期，也可以输入当天的日期和时间。 如果输入当天的日期和时间，请将该值括在引号 (") 中，例如，"09/01/2018 5:00 PM"。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-TelephoneAssistant
此参数只在本地 Exchange 中可用。
TelephoneAssistant 参数指定用户助理的电话号码。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Title
Title 参数指定用户的职务。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-UMCallingLineIds
此参数只在本地 Exchange 中可用。
UMCallingLineIds 参数指定可映射到已启用统一消息 (UM) 的用户的电话号码或分机。 可以为每个用户指定多个逗号分隔的电话号码。 此参数接受长度小于 128 个字符的数字，可以在数字之前包含可选的加号 (+)。 每个已启用 UM 的用户必须具有唯一的 UMCallingLineIds 参数值。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UMDtmfMap
此参数只在本地 Exchange 中可用。
UMDtmfMap 参数指定双音多频 (DTMF) 收件人的映射值。 这允许在统一消息 (UM) 环境中使用电话键盘来标识收件人。 通常，会自动创建和更新这些 DTMF 值，但可以使用此参数手动进行更改。 此参数使用以下语法：
emailAddress:<integers>lastNameFirstName:<integers>firstNameLastName:<integers>
若要输入覆盖所有现有条目的值，请使用以下语法： emailAddress:<integers>,lastNameFirstName:<integers>,firstNameLastName:<integers>。
如果使用此语法并省略任何 DTMF 映射值，则这些值将从接收方中删除。 例如，如果仅 emailAddress:<integers>指定 ，则将删除所有现有的 lastNameFirstName 和 firstNameLastName 值。
若要在不影响其他现有条目的情况下添加或删除值，请使用以下语法： @{Add="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"; Remove="emailAddress:<integers>","lastNameFirstName:<integers>","firstNameLastName:<integers>"}。
如果使用此语法，则无需指定所有 DTMF 映射值，并且可以指定多个 DTMF 映射值。 例如，可以使用 @{Add="emailAddress:<integers1>","emailAddress:<integers2>} 为 emailAddress 添加两个新值，而不会影响现有的 lastNameFirstName 和 firstNameLastName 值。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UserPrincipalName
此参数只在本地 Exchange 中可用。
UserPrincipalName 参数指定用户帐户的登录名。 UPN 使用电子邮件地址格式： username@domain。 通常，域值是用户帐户所在的域。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-VIP
此参数仅在基于云的服务中可用。
VIP 参数指定用户是否为优先级帐户。 有效值包含:
- $true：用户是优先级帐户。
- $false：用户不是优先级帐户。
有关优先级帐户的详细信息，请参阅 管理和监视优先级帐户。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-WebPage
WebPage 参数指定用户的网页。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf 开关在此 cmdlet 上不起作用。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-WindowsEmailAddress
WindowsEmailAddress 参数指定此收件人的 Windows 电子邮件地址。 这是存在于所有环境（包括没有 Exchange 的环境）中的常见 Active Directory 属性。 对收件人使用 WindowsEmailAddress 参数会产生以下结果之一：
- 在收件人受电子邮件地址策略约束 (EmailAddressPolicyEnabled 属性设置为收件人) 值 True 的环境中，WindowsEmailAddress 参数对 WindowsEmailAddress 属性或主电子邮件地址值没有影响。
- 在收件人不受电子邮件地址策略约束的环境中， (EmailAddressPolicyEnabled 属性设置为收件人) 的值 False，WindowsEmailAddress 参数会将 WindowsEmailAddress 属性和主电子邮件地址更新为相同的值。
WindowsEmailAddress 属性对于电子邮件属性中的 Active Directory 用户和计算机中的收件人可见。 属性公用名为“E-mail-Addresses”，Ldap-Display-Name 为“邮件”。 如果在 Active Directory 中修改此属性，则收件人主电子邮件地址不会更新为相同的值。
| Type: | SmtpAddress |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
输入
Input types
若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。
输出
Output types
若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。