易宝典文章——体验O365中的EXO PS V2 之三 通过Exchange Online PowerShell V2获取客户端访问设置

clip_image002

通过之前的过程已经通过Exchange Online PowerShell V2连接到Office 365的Exchange Online组织中了。接下来将体验通过Exchange Online PowerShell V2获取相关组织中的对象信息。

特别声明,和一贯的介绍一样。为了技术知识的本地化,除国内世纪互联版Office 365可能存在的尚未实现的功能,会以全球版Office 365作为实例来介绍外,后续所有实例将以国内世纪互联版Office 365作为环境进行介绍。

一、Get-EXOCasMailbox命令

在Exchange Online PowerShell V2模块中获取客户端访问设置,可以通过Get-EXOCasMailbox(或EXOCasMailbox)命令来实现。从目前的预览版中,对于新版命令带动词前缀和不带动词前缀具有等价效果。为了遵从PowerShell一直以来的命令风格,后续介绍中将在多数情况中以完整的带动词前缀的形式进行介绍。

该命令的作用类似于旧版Exchange Online PowerShell的Get-CasMailbox命令的功能,但根据微软的介绍,提高了返回输出效率和扩展了功能。

默认返回一个或多个邮箱的多种客户端访问设置。包括OWA、Exchange ActiveSync、POP3和IMAP4等选项。

1、完整语法

EXOCasMailbox

[[-Identity] <String>]

[-Filter <String>]

[-ExternalDirectoryObjectId <Guid>]

[-OrganizationalUnit <String>]

[-Properties <String[]>]

[-PropertySets <PropertySet[]>]

[-ProtocolSettings]

[-ResultSize <Unlimited>]

[-UserPrincipalName <String>]

[<CommonParameters>]

或:

EXOCasMailbox

[-Anr <String>]

[-Filter <String>]

[-OrganizationalUnit <String>]

[-Properties <String[]>]

[-PropertySets <PropertySet[]>]

[-ProtocolSettings]

[-ResultSize <Unlimited>]

[<CommonParameters>]

2、参数说明

Anr:

指定用于模糊查询的字符串。命令将返回在某些属性的值中包含该参数指定字符串的对象。这些属性默认有:

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

该参数不能与Identity参数同时使用,其默认值为None。

ExternalDirectoryObjectId:

指定Azure Active Directory中邮箱的ObjectId标识来检索查找显示要查看的邮箱。该参数指定的值应该为一个GUID类型数据,但需要注意的是此值不是邮箱自身在Exchange Online中的GUID,也不是Identity。其默认值为None。

Filter:

使用OPath语法对查询的结果进行基于属性和属性值的筛选和查找。筛选条件使用”Property -ComparisonOperator ‘Value'”的形式提供。其默认值为None。

Identity:

指定查看的邮箱。可以使用任何能够唯一标识该邮箱的值。包括:

  • Distinguished Name(DN)
  • Canonical DN
  • <DomainName>\<AccountName>
  • Email Address
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • User ID
  • User Principal Name(UPN)

该参数不支持Name属性和Alias属性,同样的不能与Anr参数同时使用。此外,该参数放在首位时,可以省略参数名。其默认值为None。

OrganizationalUnit:

指定筛选对象所在AD中的OU名称,即获取某个OU中的对象可以使用该参数指定OU。其参数可欧时能够唯一标识OU或域的任何值。包括:

  • Name
  • Canonical Name
  • Distinguished Name(DN)
  • GUID

其默认值为None。

Properties:

指定命令返回输出的属性,即指定需要查询的属性。该参数可以指定一个或多个属性名称,如果是多个属性名称,需要使用逗号进行分隔。

PropertySet:

指定命令返回输出的属性逻辑集,该命令支持的有效值有:

  • Minimum(该集合为命令默认输出)
  • ActiveSync
  • Ews
  • Imap
  • Mapi
  • Pop
  • ProtocolSetting
  • All

可以指定多个值,也可以使用星号(*)作为通配符使用。其默认值为None。

ProtolcolSettings:

获取提供相关通讯协议的服务器名称、TCP端口和加密方法,包括的通讯协议设置有:

  • ExternallmapSetting
  • InternalImapSettings
  • ExternalPopSettings
  • InternalPopSettings
  • ExternalSmtpSettings
  • InternalSmtpSettings

该参数结果的输出支持Format-List进行格式化。其默认值为None。

ResultSize:

指定要返回的最大查询条目数。如果需要返回匹配条件的所有条目使用unlimited作为该参数的值即可。其默认值为1000。

UserPrincipalName:

指定要查看邮箱的UPN。其默认值为None。

二、体验Get-EXOCasMailbox

1、连接到Office 365的Exchange Online组织。

Connect-ExchangeOnline -UserPrincipalName [email protected] -ExchangeEnvironmentName O365China

clip_image004

2、带动词前缀与不带动词前缀等价。

Get-EXOCasMailbox

clip_image006

EXOCasMailbox

clip_image008

3、指定获取某个邮箱的客户端设置

Get-EXOCasMailbox -Identity “[email protected]

clip_image010

可以查看指定邮箱的ECP、OWA、IMAP、POP、MAPI、EWS以及ActiveSync是否启用的状态。

4、通过模糊查询用户,获取邮箱客户端设置

查看用户名、别名等属性中包含“admin”字符串的邮箱客户端设置

Get-EXOCasMailbox -Anr “admin”

clip_image012

可以看到返回了“admin”和“administrator”的邮箱客户端设置信息。

5、查看指定用户邮箱的客户端协议配置信息

如果需要查看某个用户的某种客户端协议由Office 365 Exchange Online的哪台服务器,在哪个TCP端口提供,以及是否启用了何种加密协议,可以通过指定ProtocolSettings参数返回。

Get-EXOCasMailbox lisi -ProtocolSettings

clip_image014

需要注意:

ProtocolSettings参数出的属性,不能通过Properties指定的方式进行输出,否则输出属性值结果将为空。