Get-EXOCasMailbox

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online

このコマンドレットは、Exchange Online PowerShell モジュールでのみ使用できます。詳細については、「Exchange Online PowerShell モジュールについて」を参照してください。

Get-EXOCasMailbox コマンドレットを使用して、メールボックスで構成されているクライアントアクセス設定を表示します。

以下の構文セクションのパラメーターセットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

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

説明

このコマンドレットは、1 つ以上のメールボックスのさまざまなクライアントアクセス設定を返します。これらの設定には、Outlook on the web、Exchange ActiveSync、POP3、IMAP4 のオプションが含まれます。

例

例 1

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

この例では、ID 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
Alias

このパラメーターは、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 、等しい場合や -like 文字列比較の場合)。比較演算子の詳細については、「about_Comparison_Operators」を参照してください。
Value は、検索するプロパティ値です。テキスト値と変数を一重引用符 ('Value'または'$Variable') で囲みます。変数値に一重引用符が含まれている場合、変数を正しく展開するには、一重引用符を識別する (エスケープする) 必要があります。たとえば、'$User'の代わりに'$($User -Replace "'","''")'を使用します。整数またはシステム値を引用符で囲まないでください (代わりに、 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 パラメーターは、表示するメールボックスを指定します。最適なパフォーマンスを得るには、次の値を使用することをお勧めします。

ユーザー ID またはユーザープリンシパル名 (UPN)
GUID

それ以外の場合は、メールボックスを一意に識別する他の値を使用できます。例:

名前
Alias
識別名 (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 コマンドレットを使用して表示される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。以下に例を示します。

名前
識別名 (DN)
識別名 (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 パラメーターは、このコマンドレットの出力で返されるプロパティを指定します。複数の値をコンマで区切って指定できます。

使用可能なプロパティの詳細については、「 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 パラメーターは、このコマンドレットの出力で返されるプロパティの論理グループを指定します。有効な値は次のとおりです。

最小値 (既定値)
ActiveSync
Ews
Imap
Mapi
ポップ
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

このスイッチで値を指定する必要はありません。

これらの値を表示するには、書式設定コマンドレットを使用する必要があります。たとえば、「 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 を使用します。既定値は 1,000 です。

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 パラメーターは、 navin@contoso.onmicrosoft.comUPN で表示するメールボックスを識別します (例: )。

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

構文

説明

例

例 1

パラメーター

-ActiveSyncDebugLogging

-Anr

-ExternalDirectoryObjectId

-Filter

-GetImapProtocolLog

-GetPopProtocolLog

-Identity

-IgnoreDefaultScope

-OrganizationalUnit

-PrimarySmtpAddress

-Properties

-PropertySets

-ProtocolSettings

-ReadIsOptimizedForAccessibility

-ResultSize

-SendLogsTo

-UserPrincipalName

入力

出力

フィードバック

その他のリソース