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