Get-EXOCasMailbox

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

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

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

構文

Identity (既定)

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

Anr

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

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Anr

適用対象: Exchange Online

Anr パラメーターには、あいまいな名前を解決 (ANR) するための検索を実行する際に使用する文字列を指定します。 部分的な文字列を指定して、その文字列に一致する属性を持つオブジェクトを検索することができます。 既定で検索対象となっているのは、以下の属性です。

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias

このパラメーターを ExternalDirectoryObjectId、Identity、PrimarySmtpAddress、または UserPrincipalName パラメーターと一緒に使用することはできません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Anr
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExternalDirectoryObjectId

適用対象: Exchange Online

ExternalDirectoryObjectId パラメーターは、Microsoft Entra ID の ObjectId で表示するメールボックスを識別します。

このパラメーターは、Anr、Identity、PrimarySmtpAddress、または UserPrincipalName パラメーターと一緒に使用することはできません。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Filter

適用対象: Exchange Online

Filter パラメーターは、OPATH 構文を使用して、指定されたプロパティと値で結果をフィルター処理します。 検索条件は構文"Property -ComparisonOperator 'Value'"を使用します。

  • OPATH フィルター全体を二重引用符 " " で囲みます。 フィルターにシステム値 (例えば、$true$false、または $null) が含まれている場合は、代わりに単一引用符 ' ' を使用します。 このパラメーターは文字列 (システム ブロックではありません) ですが、波かっこ { } を使用することもできますが、これはフィルターに変数が含まれていない場合のみです。
  • Property はフィルタリング可能なプロパティです。 フィルタリング可能なプロパティの詳細については、「 Get-EXOCasMailboxプロパティ セット」および 「Filterパラメータのフィルタブルプロパティ」を参照してください。
  • 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 構文情報」を参照してください。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-GetImapProtocolLog

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-GetPopProtocolLog

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Identity

適用対象: Exchange Online

Identity パラメーターには、表示するメールボックスを指定します。 最適なパフォーマンスを得るには、次の値を使用することをお勧めします:

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

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

  • 名前
  • Alias
  • 識別名 (DN)
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • LegacyExchangeDN
  • SamAccountName

このパラメーターは、Anr、ExternalDirectoryObjectId、PrimarySmtpAddress、または UserPrincipalName パラメーターと一緒に使用することはできません。

注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:0
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-IgnoreDefaultScope

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-OrganizationalUnit

適用対象: Exchange Online

OrganizationalUnit パラメーターは、Active Directory 内のオブジェクトの場所に基づいて結果をフィルタリングします。 指定された場所に存在するオブジェクトのみが返されます。 このパラメーターの有効な入力値は、Get-OrganizationalUnit コマンドレットを使用して表示される組織単位 (OU) またはドメインです。 OU またはドメインを一意に識別する、任意の値を使用できます。 以下に例を示します。

  • 名前
  • 識別名 (DN)
  • 識別名 (DN)
  • GUID

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PrimarySmtpAddress

適用対象: Exchange Online

PrimarySmtpAddress は、プライマリ SMTP 電子メール アドレス ( navin@contoso.comなど) で表示するメールボックスを識別します。

このパラメーターを Anr、ExternalDirectoryObjectId、Identity、または UserPrincipalName パラメーターと一緒に使用することはできません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

-Properties

適用対象: Exchange Online

Properties パラメーターは、このコマンドレットの出力で返されるプロパティを指定します。 複数の値をコンマで区切って指定できます。

使用可能なプロパティの詳細については、「 Get-EXOCasMailbox プロパティ セット」を参照してください。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PropertySets

適用対象: Exchange Online

PropertySets パラメーターは、このコマンドレットの出力で返されるプロパティの論理グループを指定します。 有効な値は次のとおりです。

  • 最小値 (これが既定値です)
  • ActiveSync
  • EWS
  • Imap
  • Mapi
  • pop
  • ProtocolSettings
  • すべて

複数の値をコンマで区切って指定できます。

各プロパティ セットに含まれるプロパティの詳細については、「 Get-EXOCasMailbox プロパティ セット」を参照してください。

パラメーターのプロパティ

型:

PropertySet[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ProtocolSettings

適用対象: Exchange Online

ProtocolSettings スイッチは、以下の設定のサーバー名、TCP ポート、および暗号化方法を返します。

  • ExternalImapSettings
  • InternalImapSettings
  • ExternalPopSettings
  • InternalPopSettings
  • ExternalSmtpSettings
  • InternalSmtpSettings

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

これらの値を表示するには、書式設定コマンドレットを使用する必要があります。 たとえば、「 Get-CasMailbox laura@contoso.com -ProtocolSettings | Format-List 」のように入力します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ReadIsOptimizedForAccessibility

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ResultSize

適用対象: Exchange Online

ResultSize パラメーターは、返される結果の最大数を指定します。 クエリに一致するすべてのリクエストを返す場合は、このパラメーターの値に unlimited を使用します。 既定値は 1,000 です。

パラメーターのプロパティ

型:Unlimited
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-SendLogsTo

適用対象: Exchange Online

このパラメーターは、Microsoft の内部使用のために予約されています。

パラメーターのプロパティ

型:

String[]

規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-UserPrincipalName

適用対象: Exchange Online

UserPrincipalName パラメーターは、UPN ( navin@contoso.onmicrosoft.com など) で表示するメールボックスを識別します。

このパラメーターを Anr、ExternalDirectoryObjectId、Identity、または PrimarySmtpAddress パラメーターと一緒に使用することはできません。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

Identity
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:True
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。

入力

Input types

次の Get-CasMailbox パラメータは、Get-EXOCasMailboxで使用またはサポートされていません。

  • IgnoreDefaultScope
  • ReadIsOptimizedForAccessibility
  • SortBy

出力

Output types

次のプロパティは、仕様により出力から削除 Get-EXOCasMailbox。

  • RunspaceId
  • Servername
  • OriginatingServer
  • IsValid