Get-EXOCasMailbox

此 cmdlet 仅在 Exchange Online PowerShell V2 模块中可用。 有关详细信息,请参阅关于 Exchange Online PowerShell V2 模块

使用 Get-EXOCasMailbox cmdlet 可以查看在邮箱上配置的客户端访问设置。

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

语法

Get-EXOCasMailbox
   [[-Identity] <String>]
   [-ActiveSyncDebugLogging]
   [-ExternalDirectoryObjectId <Guid>]
   [-Filter <String>]
   [-GetImapProtocolLog]
   [-GetPopProtocolLog]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <String>]
   [-PrimarySmtpAddress <String>]
   [-Properties <String[]>]
   [-PropertySets <PropertySet[]>]
   [-ProtocolSettings]
   [-ReadIsOptimizedForAccessibility]
   [-ResultSize <Unlimited>]
   [-SendLogsTo <String[]>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]
Get-EXOCasMailbox
   [-Anr <String>]
   [-ActiveSyncDebugLogging]
   [-Filter <String>]
   [-GetImapProtocolLog]
   [-GetPopProtocolLog]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <String>]
   [-Properties <String[]>]
   [-PropertySets <PropertySet[]>]
   [-ProtocolSettings]
   [-ReadIsOptimizedForAccessibility]
   [-ResultSize <Unlimited>]
   [-SendLogsTo <String[]>]
   [<CommonParameters>]

说明

此 cmdlet 返回一个或多个邮箱的多种客户端访问设置。 这些设置包括 Outlook 网页版、Exchange ActiveSync POP3 和 IMAP4 的选项。

示例

示例 1

Get-EXOCASMailbox -Identity "JeffHay@contoso.com"

此示例返回 Identity 为 Jeffhay@contoso.com 的用户的以下客户端访问Jeffhay@contoso.com:

  • ActiveSyncEnabled
  • EwsEnabled
  • OWAEnabled
  • PopEnabled
  • ImapEnabled
  • MAPIEnabled
  • ECPEnabled

参数

-ActiveSyncDebugLogging

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-Anr

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

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

此参数不能与 ExternalDirectoryObjectId、Identity、PrimarySmtpAddress 或 UserPrincipalName 参数一同使用。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ExternalDirectoryObjectId

ExternalDirectoryObjectId 参数标识 Azure Active Directory 中的 ObjectId 要查看的邮箱。

此参数不能与 Anr、Identity、PrimarySmtpAddress 或 UserPrincipalName 参数一同使用。

Type:Guid
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online
-Filter

Filter 参数使用 OPath 语法按指定的属性和值筛选结果。 搜索条件使用语法 "Property -ComparisonOperator 'Value'"

  • 使用双引号""将整个 OPath 筛选器括起来。 如果筛选器包含系统值 (例如 ,,,或) ,请改为使用单 $true $false $null 引号' ' 。 尽管此参数是字符串 (系统块) ,但您也可以使用大括号 { },但只有在筛选器不包含变量时。
  • 属性是可筛选属性。 有关可筛选属性的信息,请参阅 Filter 参数的 Get-EXOCasMailbox 属性集和 Filterable 属性
  • ComparisonOperator 是 OPath 比较运算符 (例如,用于等号和 -eq -like 字符串比较) 。 有关比较运算符的信息 ,请参阅about_Comparison_Operators。
  • 值是要搜索的属性值。 将文本值和变量括在单引号 ('Value''$Variable') 。 如果变量值包含单引号,则需要 (单引号) 转义以正确展开变量。 例如,而不是 '$User' ,使用 '$($User -Replace "'","''")' 。 请勿将整数或系统值 (例如 500 $true $false ,、、或 $null) 。

可以使用逻辑运算符和 将多个搜索条件链接在一 -and-or 。 例如, "Criteria1 -and Criteria2""(Criteria1 -and Criteria2) -or Criteria3"

有关 Exchange 中的 OPath 筛选器的详细信息,请参阅 其他 OPATH 语法信息

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-GetImapProtocolLog

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-GetPopProtocolLog

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-Identity

Identity 参数指定要查看的邮箱。 为获得最佳性能,我们建议使用下列值:

  • 用户 ID 或用户主体名称 (UPN)
  • GUID

否则,可以使用任何其他能够唯一标识邮箱的值。 例如:

  • 名称
  • 别名
  • 可分辨名称 (DN)
  • 域 \ 用户名
  • 电子邮件地址
  • LegacyExchangeDN
  • SamAccountName

此参数不能与 Anr、ExternalDirectoryObjectId、PrimarySmtpAddress 或 UserPrincipalName 参数一同使用。

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online
-IgnoreDefaultScope

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-OrganizationalUnit

OrganizationalUnit 参数根据对象在 Active Directory 中的位置筛选结果。 只返回存在于指定位置的对象。 此参数的有效输入是使用 Get-OrganizationalUnit cmdlet 可见的组织单位 (OU) 或域。 可以使用任何能够唯一标识此 OU 或域的值。 例如:

  • 名称
  • 名称
  • 可分辨名称 (DN)
  • GUID
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-PrimarySmtpAddress

PrimarySmtpAddress 通过主 SMTP 电子邮件地址标识要查看的邮箱 (例如,navin@contoso.com) 。

此参数不能与 Anr、ExternalDirectoryObjectId、Identity 或 UserPrincipalName 参数一同使用。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online
-Properties

Properties 参数指定在此 cmdlet 的输出中返回的属性。 可以指定用逗号分隔的多个值。

有关可用属性的信息,请参阅 Get-EXOCasMailbox 属性集

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-PropertySets

PropertySets 参数指定在此 cmdlet 的输出中返回的属性的逻辑分组。 有效值为:

  • 最小值 (此值为默认值)
  • ActiveSync
  • Ews
  • Imap
  • Mapi
  • Pop
  • ProtocolSettings
  • 全部

可以指定用逗号分隔的多个值。

有关每个属性集中包含的属性详细信息,请参阅 Get-EXOCasMailbox 属性集

Type:PropertySet[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ProtocolSettings

ProtocolSettings 开关返回以下设置的服务器名称、TCP 端口和加密方法:

  • ExternalImapSettings
  • InternalImapSettings
  • ExternalPopSettings
  • InternalPopSettings
  • ExternalSmtpSettings
  • InternalSmtpSettings

不必为此开关指定值。

若要查看这些值,您需要使用格式设置 cmdlet。 例如,Get-CasMailbox laura@contoso.com -ProtocolSettings | Format-List

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ReadIsOptimizedForAccessibility

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-ResultSize

ResultSize 参数指定了要返回的结果的最大数量。 若要返回所有与查询相匹配的请求,则请将此参数的值设为无限制。 默认值为 1000。

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-SendLogsTo

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

Type:String[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online
-UserPrincipalName

UserPrincipalName 参数标识要由 UPN (查看的邮箱,例如navin@contoso.onmicrosoft.com) 。

此参数不能与 Anr、ExternalDirectoryObjectId、Identity 或 PrimarySmtpAddress 参数一同使用。

Type:String
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

输入

以下Get-CasMailbox参数在 Get-EXOCasMailbox 中不可用或不受支持:

  • IgnoreDefaultScope
  • ReadIsOptimizedForAccessibility
  • SortBy

输出

以下属性按设计从输出Get-EXOCasMailbox删除:

  • RunspaceId
  • Servername
  • OriginatingServer
  • IsValid