客户端访问 Cmdlet


Get-CASMailbox

适用于: Exchange Server 2010 SP2

上一次修改主题: 2011-05-04

使用 Get-CASMailbox cmdlet 可以返回安装了客户端访问服务器角色的计算机上 Microsoft Exchange Server 2010 邮箱的完整属性列表。

语法


Get-CASMailbox [-Identity <MailboxIdParameter>] [-ActiveSyncDebugLogging <SwitchParameter>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-GetImapProtocolLog <SwitchParameter>] [-GetPopProtocolLog <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ProtocolSettings <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SendLogsTo <MultiValuedProperty>] [-SortBy <String>]

Get-CASMailbox [-ActiveSyncDebugLogging <SwitchParameter>] [-Anr <String>] [-Credential <PSCredential>] [-DomainController <Fqdn>] [-Filter <String>] [-GetImapProtocolLog <SwitchParameter>] [-GetPopProtocolLog <SwitchParameter>] [-IgnoreDefaultScope <SwitchParameter>] [-Organization <OrganizationIdParameter>] [-OrganizationalUnit <OrganizationalUnitIdParameter>] [-ProtocolSettings <SwitchParameter>] [-ReadFromDomainController <SwitchParameter>] [-ResultSize <Unlimited>] [-SendLogsTo <MultiValuedProperty>] [-SortBy <String>]
详细说明

可以返回各种 CASMailbox 属性。返回的属性类型包括 Microsoft Office Outlook Web App、Exchange ActiveSync、POP3 和 IMAP4。

默认情况下,将返回 Exchange 组织中所有邮箱的所有属性。可以使用 Exchange 命令行管理程序中的功能来筛选这些结果。

Get-CASMailbox cmdlet 只能在安装了邮箱服务器角色的 Exchange 计算机上运行。

您必须先获得权限,然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数,但如果这些参数未包含在分配给您的权限中,则您无法访问这些参数。 若要查看所需的权限,请参阅客户端访问权限主题中的“客户端访问用户设置”条目。

参数

参数 必需 类型 描述

ActiveSyncDebugLogging

可选

System.Management.Automation.SwitchParameter

ActiveSyncDebugLogging 参数指定是否为邮箱的 Microsoft Exchange ActiveSync 启用日志记录。

Anr

可选

System.String

Anr 参数指定字符串,用于执行模糊名称解析 (ANR) 搜索。 可以指定部分字符串,并搜索其属性与该字符串匹配的对象。 搜索的默认属性是:

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias

Credential

可选

System.Management.Automation.PSCredential

Credential 参数指定用于读取 Active Directory 的帐户。

此参数需要创建并传递凭据对象。 此凭据对象是使用 Get-Credential cmdlet 创建的。 有关详细信息,请参阅 Get-Credential

DomainController

可选

Microsoft.Exchange.Data.Fqdn

DomainController 参数指定从 Active Directory 中检索数据的域控制器的完全限定域名 (FQDN)。

Filter

可选

System.String

Filter 参数指示用于筛选收件人的 OPath 筛选器。

有关可筛选属性的详细信息,请参阅 -Filter 参数的可筛选属性

GetImapProtocolLog

可选

System.Management.Automation.SwitchParameter

GetImapProtocolLog 参数指定是否检索 IMAP 协议日志。

GetPopProtocolLog

可选

System.Management.Automation.SwitchParameter

GetPopProtocolLog 参数指定是否检索 POP 协议日志。

Identity

可选

Microsoft.Exchange.Configuration.Tasks.MailboxIdParameter

Identity 参数指定邮箱 ID。可以使用下列值:

  • GUID
  • 可分辨名称 (DN)
  • 用户主体名称 (UPN)
  • SMTP 地址
  • 别名

IgnoreDefaultScope

可选

System.Management.Automation.SwitchParameter

IgnoreDefaultScope 参数指示命令忽略 Exchange 命令行管理程序会话的默认收件人范围设置,并将整个林用作范围。 这将允许该命令访问当前未在默认范围内的 Active Directory 对象。 一旦使用 IgnoreDefaultScope 参数,便会受到以下限制:

  • 不能使用 DomainController 参数。该命令将自动使用相应的全局编录服务器。
  • 仅可以对 Identity 参数使用 DN。不接受其他形式的标识,如别名或 GUID。
  • 不能同时使用 OrganizationalUnitIdentity 参数。
  • 不能使用 Credential 参数。

Organization

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationIdParameter

此参数可用于多租户部署。 它不可用于本地部署。 有关多租户部署的详细信息,请参阅多租户支持

Organization 参数指定您将在其中执行此操作的组织。 此参数不接受通配符,并且您必须使用组织的确切名称。

OrganizationalUnit

可选

Microsoft.Exchange.Configuration.Tasks.OrganizationalUnitIdParameter

OrganizationalUnit 参数限制对特定容器的搜索。

ProtocolSettings

可选

System.Management.Automation.SwitchParameter

ProtocolSetting 参数返回邮箱的 POP3、IMAP4 和 SMTP 服务器名称。

ReadFromDomainController

可选

System.Management.Automation.SwitchParameter

ReadFromDomainController 参数指定从用户所在域的域控制器中读取用户信息。如果将收件人作用域设置为包括林中的所有收件人,但不使用此参数,则有可能从包含过期信息的全局编录服务器中读取用户信息。如果使用此参数,则可能需要多次读取才能检索该信息。

Bb124754.note(zh-CN,EXCHG.141).gif注意:
默认情况下,收件人作用域设置为承载运行 Exchange 的服务器的域。

ResultSize

可选

Microsoft.Exchange.Data.Unlimited

ResultSize 参数指定要返回的最大结果数。默认值为 1000。

SendLogsTo

可选

Microsoft.Exchange.Data.MultiValuedProperty

SendLogsTo 参数指定接收日志文件的地址。

SortBy

可选

System.String

SortBy 参数指定用来对结果进行排序的属性。结果将按升序进行排序。

输入类型

若要查看此 cmdlet 接受的输入类型,请参阅 Cmdlet 输入和输出类型。 如果 cmdlet 的输入类型字段为空,则 cmdlet 不接受输入数据。

返回类型

若要查看此 cmdlet 接受的返回类型(也称为输出类型),请参阅 Cmdlet 输入和输出类型。 如果输出类型字段为空,则 cmdlet 不返回数据。

错误

错误 描述

 

 

异常

异常 描述

 

 

示例

示例 1

本示例将返回 Contoso 域中用户 Jeff Hay 的所有客户端访问服务器邮箱的详细信息。

Get-CASMailbox -Identity jeffhay@contoso.com
示例 2

本示例将返回 Contoso 域中用户 Tony Smith 的所有客户端访问服务器邮箱的详细信息。

Get-CASMailbox -Identity contoso\tonysmith
示例 3

本示例返回 Fourthcoffee 域中用户 Tony Smith 的所有客户端访问服务器邮箱的详细信息。

Get-CASMailbox -Identity fourthcoffee\tonysmith 
Page view tracker