通過之前的過程已經通過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指定的方式進行輸出,否則輸出屬性值結果將爲空。