Get-EXOCasMailbox

參考

模組:: ExchangePowerShell

適用於:: Exchange Online

此 Cmdlet 僅適用于 Exchange Online PowerShell 模組。如需詳細資訊，請參閱關於 Exchange Online PowerShell 模組。

使用 Get-EXOCasMailbox Cmdlet 來檢視信箱上設定的用戶端存取設定。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

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>]

Description

此 Cmdlet 會傳回一或多個信箱的各種用戶端存取設定。這些設定包括Outlook 網頁版、Exchange ActiveSync、POP3 和 IMAP4 的選項。

範例

範例 1

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

此範例會傳回具有身 Jeffhay@contoso.com 分識別之使用者的下列用戶端存取設定值：

ActiveSyncEnabled
EwsEnabled
OWAEnabled
PopEnabled
ImapEnabled
MAPIEnabled
ECPEnabled

參數

-ActiveSyncDebugLogging

將保留此參數供 Microsoft 內部使用。

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

-Anr

Anr 參數會指定用來執行模糊名稱解析 (ANR) 搜尋的字串。您可以指定部分字串，然後搜尋屬性符合該字串的物件。搜尋的預設屬性如下：

CommonName (CN)
DisplayName
FirstName
LastName
別名

您無法搭配 ExternalDirectoryObjectId、Identity、PrimarySmtpAddress 或 UserPrincipalName 參數使用此參數。

Type:	String
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-Filter

Filter 參數會使用 OPATH 語法，依指定的屬性和值來篩選結果。搜尋準則使用語法 "Property -ComparisonOperator 'Value'"。

以雙引號「」括住整個 OPATH 篩選準則。如果篩選條件包含系統值 (例如 $true、 $false 或 $null)，請改為使用單引號 ' '。雖然此參數是字串 (不是系統區塊)，您也可以使用大括弧 { }，但只有在篩選條件不包含變數時。
Property 是可篩選的屬性。如需可篩選屬性的詳細資訊，請參閱 Filter 參數的 Get-EXOCasMailbox 屬性集和 Filterable 屬性。
ComparisonOperator 是 OPATH 比較運算子 (例如 -eq equals 和 -like 字串比較) 。如需比較運算子的詳細資訊，請參閱 about_Comparison_Operators。
Value 是要搜尋的屬性值。以單引號括住文字值和變數 ('Value' 或 '$Variable')。如果變數值包含單引號，您必須識別 (逸出) 單引號，以正確展開變數。例如，使用 '$($User -Replace "'","''")'，而不是 '$User'。請勿以引號括住整數或系統值 (例如，請改用 500 、 $true 、 $false 或 $null) 。

您可以使用邏輯運算子 -and 和 -or 將多個搜尋準則鏈結在一起。例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。

如需 Exchange 中 OPATH 篩選的詳細資訊，請參閱其他 OPATH 語法資訊。

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

-GetImapProtocolLog

將保留此參數供 Microsoft 內部使用。

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

-GetPopProtocolLog

將保留此參數供 Microsoft 內部使用。

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

-Identity

Identity 參數會指定您想要檢視的信箱。為了獲得最佳效能，建議您使用下列值：

使用者識別碼或使用者主要名稱 (UPN)
GUID

否則，您可以使用可唯一識別信箱的任何其他值。例如：

名稱
別名
辨別名稱 (DN)
Domain\Username
電子郵件地址
LegacyExchangeDN
SamAccountName

您無法搭配 Anr、ExternalDirectoryObjectId、PrimarySmtpAddress 或 UserPrincipalName 參數使用此參數。

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

-IgnoreDefaultScope

將保留此參數供 Microsoft 內部使用。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
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
Required:	False
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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

-Properties

Properties 參數會指定在這個 Cmdlet 的輸出中傳回的屬性。您可以指定多個以逗號分隔的值。

如需可用屬性的詳細資訊，請參閱 Get-EXOCasMailbox 屬性集。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
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
Required:	False
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
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online

-ReadIsOptimizedForAccessibility

將保留此參數供 Microsoft 內部使用。

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

-ResultSize

ResultSize 參數會指定傳回的結果筆數上限。若要傳回符合查詢的所有要求，請使用 unlimited 作為此參數的值。預設值為 1000。

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

-SendLogsTo

將保留此參數供 Microsoft 內部使用。

Type:	String[]
Position:	Named
Default value:	None
Required:	False
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
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online

輸入

Input types

Get-EXOCasMailbox 中無法使用或支援下列Get-CasMailbox參數：

IgnoreDefaultScope
ReadIsOptimizedForAccessibility
SortBy

輸出

Output types

根據設計，會從Get-EXOCasMailbox輸出中移除下列屬性：

RunspaceId
Servername
OriginatingServer
IsValid

共用方式為

Get-EXOCasMailbox

Syntax

Description

範例

範例 1

參數

-ActiveSyncDebugLogging

-Anr

-ExternalDirectoryObjectId

-Filter

-GetImapProtocolLog

-GetPopProtocolLog

-Identity

-IgnoreDefaultScope

-OrganizationalUnit

-PrimarySmtpAddress

-Properties

-PropertySets

-ProtocolSettings

-ReadIsOptimizedForAccessibility

-ResultSize

-SendLogsTo

-UserPrincipalName

輸入

輸出

意見反應

其他資源