通过

Connect-Mailbox

模块:
ExchangePowerShell
适用于:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Connect-Mailbox cmdlet 将断开连接的邮箱连接到没有邮箱的现有用户帐户。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Equipment]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       -LinkedDomainController <Fqdn>
       -LinkedMasterAccount <UserIdParameter>
       [-LinkedCredential <PSCredential>]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Room]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-Shared]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-User <UserIdParameter>]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-ValidateOnly]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-WhatIf]
       [<CommonParameters>]
Connect-Mailbox
       [-Identity] <StoreMailboxIdParameter>
       [-Database] <DatabaseIdParameter>
       [-User <UserIdParameter>]
       [-AddressBookPolicy <AddressBookMailboxPolicyIdParameter>]
       [-AllowLegacyDNMismatch]
       [-Archive]
       [-ActiveSyncMailboxPolicy <MailboxPolicyIdParameter>]
       [-Alias <String>]
       [-Confirm]
       [-DomainController <Fqdn>]
       [-Force]
       [-ManagedFolderMailboxPolicy <MailboxPolicyIdParameter>]
       [-ManagedFolderMailboxPolicyAllowed]
       [-RetentionPolicy <MailboxPolicyIdParameter>]
       [-WhatIf]
       [<CommonParameters>]

说明

如果将邮箱链接到现有用户帐户，该用户帐户将具有对该邮箱及邮箱中所有邮件的完全访问权限。

如果使用 User 参数指定用户帐户，请确保指定正确的帐户。 如果不使用 User 参数，建议您使用 ValidateOnly 开关确认邮箱尝试连接的用户帐户。

没有 Disconnect-Mailbox cmdlet。 您可以使用 Disable-Mailbox 或 Remove-Mailbox cmdlet 快速地将邮箱与用户帐户断开连接。

使用 Disable-Mailbox cmdlet 执行以下操作：

  • 将邮箱与用户帐户断开连接。
  • 在邮箱被永久删除之前将其保留在禁用状态，受已删除的邮箱保留期限制。
  • 保留用户帐户，但从帐户中删除 Exchange 属性。

使用 Remove-Mailbox cmdlet 执行以下操作：

  • 将邮箱与用户帐户断开连接。
  • 在邮箱被永久删除之前将其保留在禁用状态，受已删除的邮箱保留期限制（除非您使用 Permanent 或 StoreMailboxIdentity 参数，这两个参数会立即将邮箱从数据库中删除）。
  • 删除用户帐户。

您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Connect-Mailbox -Database "Mailbox Database" -Identity "John Evans"

本示例连接 John Evans 的断开连接的邮箱。 该示例未指定邮箱连接到的用户，因此该命令会尝试查找唯一匹配的用户对象。

示例 2

Connect-Mailbox -Identity "John Evans" -Database "MBXDB02" -LinkedDomainController FabrikamDC01 -LinkedMasterAccount john@fabrikam.com

本示例将连接链接的邮箱。

示例 3

Connect-Mailbox -Identity "CAR001" -Database "MBXResourceDB" -Equipment -User "CAR001"

本示例将连接设备邮箱。

示例 4

Connect-Mailbox -Identity "ConfRm212" -Database "MBXResourceDB" -Room -User "Conference Room 212"

本示例将连接会议室邮箱。

参数

-ActiveSyncMailboxPolicy

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

ActiveSyncMailboxPolicy 参数指定应用于邮箱的移动设备邮箱策略。 可以使用任何能够唯一标识该策略的值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • GUID

如果不使用此参数，则使用默认移动设备邮箱策略。

类型:MailboxPolicyIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AddressBookPolicy

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

AddressBookPolicy 参数指定应用于邮箱的通讯簿策略。 可以使用任何能够唯一标识通讯簿策略的值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • GUID

有关通讯簿策略的详细信息，请参阅 Exchange Server 中的通讯簿策略。

类型:AddressBookMailboxPolicyIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Alias

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Alias 参数指定 Exchange 别名 (也称为收件人的邮件昵称) 。 此值将收件人标识为已启用邮件的对象，且不得与同一个收件人的多个电子邮件地址混淆（也称为代理地址）。 收件人只能有一个 Alias 值。 最大长度为 64 个字符。

别名值可以包含字母、数字和以下字符：

  • ！、#、%*、+、-、/、=、？、^、_和 ~。
  • $、&、'、'、{、}和 |需要 (转义，例如 -Alias what`'snew) 或用单引号括起来的整个值 (例如 -Alias 'what'snew') 。 Microsoft Entra Connect 同步的别名值中不支持 & 字符。
  • 句点 (.) 必须用其他有效字符括起来， (例如 help.desk) 。
  • Unicode 字符 U+00A1 到 U+00FF。

在不指定电子邮件地址的情况下创建收件人时，指定的别名值将用于生成主电子邮件地址 (alias@domain) 。 支持的 Unicode 字符会映射到最适合的 US-ASCII 文本字符。 例如，U+00F6 (ö) 在主电子邮件地址更改为 oe 。

如果在创建收件人时不使用 Alias 参数，则别名属性值将使用其他必需参数的值：

  • 用户帐户 (收件人，例如，用户邮箱和邮件用户) ：使用 MicrosoftOnlineServicesID 或 UserPrincipalName 参数的左侧。 例如， helpdesk@contoso.onmicrosoft.com 结果为 Alias 属性值 helpdesk。
  • 没有用户帐户的收件人 (例如会议室邮箱、邮件联系人和通讯组) ：使用 Name 参数的值。 删除空格并将不受支持的字符转换为问号 (？) 。

如果修改现有收件人的别名值，则仅在收件人受电子邮件地址策略约束的环境中自动更新主电子邮件地址， (收件人) 的 EmailAddressPolicyEnabled 属性为 True。

Alias 参数永远不会生成或更新邮件联系人或邮件用户的主电子邮件地址。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AllowLegacyDNMismatch

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

保留此参数以供 Microsoft 内部使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Archive

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Archive 开关指定是否连接关联的存档邮箱。 不必为此开关指定值。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Confirm

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Database

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Database 参数指定包含要连接的邮箱的 Exchange 数据库。 可以使用任何能够唯一标识此数据库的值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • GUID

将此参数与 Identity 参数一起使用以指定您想要连接的邮箱。

类型:DatabaseIdParameter
Position:2
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-DomainController

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

类型:Fqdn
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Equipment

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

连接设备邮箱需要设备开关。 不必为此开关指定值。

设备邮箱是未与特定位置关联的资源邮箱， (例如，车辆或计算机) 。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Force

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

强制开关隐藏警告或确认消息。 不必为此开关指定值。

您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Identity

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Identity 参数指定您想要连接到用户帐户的邮箱。 此参数不指定 Active Directory 对象。 可以使用下列值来标识邮箱：

  • 显示名称
  • GUID
  • LegacyExchangeDN

将此参数与 Database 参数一起使用以指定您想要连接的邮箱。

类型:StoreMailboxIdParameter
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-LinkedCredential

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

LinkedCredential 参数指定用于访问由 LinkedDomainController 参数指定的域控制器的凭据。 即使连接了链接邮箱，此参数也是可选的。

此参数的值需要 Get-Credential cmdlet。 要暂停此命令并接收凭据提示，请使用值 (Get-Credential)。 或者，在运行此命令之前，请将凭据存储在变量（例如，$cred = Get-Credential）中，然后将变量名称 ($cred) 用作此参数。 有关详细信息，请参阅 Get-Credential。

类型:PSCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-LinkedDomainController

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

LinkedDomainController 参数指定用户帐户所处林中的域控制器（如果此邮箱是链接邮箱）。 用户帐户所处林中的域控制器用于获取 LinkedMasterAccount 参数指定的帐户的安全信息。 对于要作为此参数的值的域控制器，请使用其完全限定的域名 (FQDN)。

仅当连接链接邮箱时，才需要此参数。

类型:Fqdn
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-LinkedMasterAccount

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

LinkedMasterAccount 参数指定用户帐户所处林中的主帐户（如果此邮箱是链接邮箱）。 主帐户是邮箱链接到的帐户。 主帐户授予对邮箱的访问权限。 只有在创建链接邮箱时，此参数才是必需的。 您可以使用任何值唯一标识主帐户。 例如：

  • 名称
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • GUID

仅当连接链接邮箱时，才需要此参数。

类型:UserIdParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ManagedFolderMailboxPolicy

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

保留此参数以供 Microsoft 内部使用。

类型:MailboxPolicyIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ManagedFolderMailboxPolicyAllowed

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

保留此参数以供 Microsoft 内部使用。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RetentionPolicy

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

RetentionPolicy 参数指定应用于邮箱的保留策略。 可以使用任何能够唯一标识该策略的值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • GUID

保留策略包含应用到邮箱文件夹和邮件项目的标记，用于确定项目应予保留的时间期限。

类型:MailboxPolicyIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Room

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

连接会议室邮箱需要会议室开关。 不必为此开关指定值。

会议室邮箱是与特定位置关联的资源邮箱， (例如会议室) 。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Shared

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

连接共享邮箱需要共享开关。 不必为此开关指定值。

共享邮箱是其中多个用户可以登录以访问邮箱内容的邮箱。 此邮箱不与任何可登录的用户关联。 它与禁用的用户帐户关联。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-User

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

User 参数指定要将邮箱连接到的 Active Directory 中的用户对象。

为了获得最佳结果，我们建议使用以下值：

  • UPN：例如， user@contoso.com (用户仅) 。
  • Domain\SamAccountName：例如 contoso\user。

否则，可以使用唯一标识用户的任何值。 例如：

  • 名称
  • 可分辨名称 (DN)
  • 可分辨名称 (DN)
  • GUID

如果未使用此参数，命令将使用邮箱的 LegacyExchangeDN 和 DisplayName 属性值来查找具有相同值的用户帐户。 如果未找到唯一的匹配项，将无法连接该邮箱。

类型:UserIdParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ValidateOnly

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

ValidateOnly 开关指示此 cmdlet 评估执行相应操作所必须满足的条件和要求，然后报告相应操作是否成功。 不必为此开关指定值。

使用此开关时，不会进行更改。

类型:SwitchParameter
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-WhatIf

适用：Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。