体验O365中的EXO PS V2 之三 通过EXO PowerShell V2获取客户端访问设置

通过之前的过程已经通过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 admin@lpwr.net -ExchangeEnvironmentName O365China

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

Get-EXOCasMailbox

EXOCasMailbox

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

Get-EXOCasMailbox -Identity "zhangsan@lpwr.net"

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

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

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

Get-EXOCasMailbox -Anr "admin"

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

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

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

Get-EXOCasMailbox lisi -ProtocolSettings

需要注意：

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