通过之前的过程已经通过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
2、带动词前缀与不带动词前缀等价。
Get-EXOCasMailbox
EXOCasMailbox
3、指定获取某个邮箱的客户端设置
Get-EXOCasMailbox -Identity “[email protected]”
可以查看指定邮箱的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指定的方式进行输出,否则输出属性值结果将为空。