次の方法で共有


Get-CalendarDiagnosticObjects

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Get-CalendarDiagnosticObjects コマンドレットを使用して、さまざまな予定表ログを収集します。 予定表診断ログは、各メールボックスの重要な予定表関連のイベント データを追跡し、メールボックスで発生する予定表の問題のトラブルシューティングに使用できます。 ログは、すべての予定表アイテムと会議メッセージを追跡します。

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

構文

Default (既定)

Get-CalendarDiagnosticObjects
    [-Identity] <UnifiedGroupOrUserMailboxIdParameter>
    [-AnalyzeExceptionWithOriginalStartDate <ExDateTime>]
    [-AutoRequeryOnMeetingId <Boolean>]
    [-ConfigurationName <String>]
    [-CustomPropertyNames <String[]>]
    [-EndDate <ExDateTime>]
    [-EntryId <String>]
    [-EwsId <String>]
    [-ExactMatch <Boolean>]
    [-ItemClass <String[]>]
    [-ItemIds <String[]>]
    [-MaxResults <Int32>]
    [-MeetingId <String>]
    [-ODataId <String>]
    [-ResultSize <Unlimited>]
    [-ShouldBindToItem <Boolean>]
    [-ShouldDecodeEnums <Boolean>]
    [-ShouldFetchAttendeeCollection <Boolean>]
    [-ShouldFetchRecurrenceExceptions <Boolean>]
    [-StartDate <ExDateTime>]
    [-Subject <String>]
    [<CommonParameters>]

説明

結果として返される次のプロパティに注目してください。

  • AppointmentState: 1 = 予定は会議、2 = 予定は受信済み、4 = 予定は取り消され、8 = 予定は転送された予定です。
  • CalendarLogTriggerAction: アイテムに対して実行されるアクション ([作成] や [更新] など)。
  • ClientInfoString: 変更を加えたエンティティ ( Client=OWA;<AdditionalDetails>Client=WebServices;<AdditionalDetails>Client=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;など)。
  • MeetingRequestType: 1 = 会議メッセージは会議出席依頼、65536 = 会議メッセージは既存の会議の完全な更新です。131072 = 会議メッセージは既存の会議の情報更新であり、262144 = 会議メッセージはサイレント更新、524288 = 更新プログラムが古くなっている、または 1048576会議メッセージが代理人に転送される コピーは情報としてマークされます。
  • OriginalLastModifiedTime: イベントを並べ替えるプライマリ並べ替えフィールドとして使用されます。
  • ResponseType: 0 = 開催者が応答を受け取っていない、1 = 開催者の会議のコピー、2 = 仮、3 = 承諾、4 = 辞退、または 5 = 出席者が応答していない。
  • ResponsibleUserName: 変更を行ったユーザーの LegacyExchangeDN 値 ( /o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendant/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=696eea97d3c449eab648920d03385efb-adminなど)。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例 1

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

この例では、Pedro Pizarro のメールボックスで、件名が「チーム会議」に完全に一致するすべてのアイテムに関する予定表の診断ログを取得します。

例 2

$A = Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true

$A | Select-Object *,@{n='OLMT'; e={[DateTime]::Parse($_.OriginalLastModifiedTime.ToString())}} | sort OLMT | Format-Table OriginalLastModifiedTime,CalendarLogTriggerAction,ItemClass,ClientInfoString

これは前の例と同じですが、結果は元の最終変更時刻で並べ替えられます。

例 3

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -MeetingID 40000008200E00074C5B7101A82E00800000000693ADAA3B5FCD201000000000000000010000000FF760A70460EAA4096B879872DF24F49

この例では、Pedro Pizarro のメールボックスで、指定された一意のグローバル オブジェクト ID (GOID) を持つ会議に関する予定表の診断ログを取得します。

例 4

Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Lunch" -StartDate 7/1/2018 -EndDate 7/31/2018 | Export-Csv "C:\My Documents\Team Lunch Meeting.csv" -NoTypeInformation

次の使用例は、2018 年 7 月に変更された Pedro Pizarro のメールボックスで対象のチーム ランチとの会議の診断情報を返し、結果をファイル C:\My Documents\Team Lunch Meeting.csv にエクスポートします。

パラメーター

-AnalyzeExceptionWithOriginalStartDate

適用対象: Exchange Online

{{ Fill AnalyzeExceptionWithOriginalStartDate Description }}

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

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

パラメーター セット

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

-AutoRequeryOnMeetingId

適用対象: Exchange Online

{{ Fill AutoRequeryOnMeetingId Description }}

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

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

パラメーター セット

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

-ConfigurationName

適用対象: Exchange Online

{{ Fill ConfigurationName Description }}

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

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

パラメーター セット

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

-CustomPropertyNames

適用対象: Exchange Online

CustomPropertyNames パラメーターは、結果に含まれる、指定した予定表アイテムのカスタム プロパティを返します。 有効な値については、PowerShell の CustomPropertyNames パラメーターの値Exchange Online参照してください。

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

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

型:

String[]

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

パラメーター セット

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

-EndDate

適用対象: Exchange Online

EndDate パラメーターは、OriginalLastModifiedTime プロパティの日付範囲の終了日を指定します (会議が最後に変更されたとき、作成されていません)。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

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

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

パラメーター セット

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

-EntryId

適用対象: Exchange Online

EntryID パラメーターは、指定された EntryID プロパティ値で結果をフィルターします。このプロパティは MAPI プロパティ PR_ENTRYID に対応しています。

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

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

パラメーター セット

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

-EwsId

適用対象: Exchange Online

{{ Fill EwsId Description }}

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

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

パラメーター セット

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

-ExactMatch

適用対象: Exchange Online

ExactMatch パラメーターは、Subject パラメーターに指定したテキスト値に関して完全一致と部分一致どちらを使用するかを指定します。 有効な値は次のとおりです。

  • $true: 件名の検索では、完全一致が使用され、メールボックス内のすべての予定表アイテムが検索されます。 たとえば、"予算" を検索すると、検索では"予算" が件名の任意の場所にあるが、"予算作成" ではないアイテムが検索されます。
  • $false: 件名の検索では、部分的な一致が使用され、メールボックス内の最大 1,000 個の予定表アイテムが検索されます。 たとえば、"予算" を検索すると、件名の任意の場所で "予算" と "予算作成" を持つアイテムが検索されます。 この値が既定値です。

部分的な件名一致検索では、関連するすべての予定表アイテムが返されない場合があります。 より正確な結果を得るには、完全一致の件名検索を使用してください。

このパラメーターは Subject パラメーターでのみ使用します。

MeetingId パラメーターを使用する場合、このパラメーターの値は無視されます。

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

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

パラメーター セット

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

-Identity

適用対象: Exchange Online

Identity パラメーターは、予定表を表示するメールボックスまたは Microsoft 365 グループを指定します。 メールボックスまたは Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • ドメイン\ユーザー名
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)

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

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

パラメーター セット

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

-ItemClass

適用対象: Exchange Online

ItemClass パラメーターは、予定表アイテムの指定された MessageClass プロパティ値で結果をフィルターします (たとえば、IPM.Appointment)。 複数の値をコンマで区切って指定できます。

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

型:

String[]

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

パラメーター セット

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

-ItemIds

適用対象: Exchange Online

ItemIds パラメーターは、アイテム ID で結果をフィルター処理します。 複数の値をコンマで区切って指定できます。

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

型:

String[]

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

パラメーター セット

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

-MaxResults

適用対象: Exchange Online

{{ Fill MaxResults Description }}

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

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

パラメーター セット

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

-MeetingId

適用対象: Exchange Online

MeetingId パラメーターは、予定表アイテムのグローバル一意識別子によって結果をフィルター処理します。 値は、このコマンドレットの出力で使用できる予定表アイテムの CleanGlobalObjectId プロパティ、または他の MAPI 検査ツールを使用してです。 値の例は 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55 です。 この値は予定表アイテムの存続期間を通じて一定です。

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

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

パラメーター セット

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

-ODataId

適用対象: Exchange Online

{{ Fill ODataId Description }}

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

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

パラメーター セット

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

-ResultSize

適用対象: Exchange Online

このパラメーターは、コマンドレットによって返される結果の数を決定します。 最大値は 1000 です。

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

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

パラメーター セット

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

-ShouldBindToItem

適用対象: Exchange Online

ShouldBindToItem パラメーターは、ストリーム可能な大きなプロパティ値を切り詰めるかどうかを指定します (たとえば、AppointmentRecurrenceBlob)。 有効な値は次のとおりです。

  • $true: 大きなストリーミング可能なプロパティの値は切り捨てられないため、完全な値が返されます。
  • $false: 大きなストリーミング可能なプロパティの値は切り捨てられます。 この値が既定値です。

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

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

パラメーター セット

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

-ShouldDecodeEnums

適用対象: Exchange Online

{{ Fill ShouldDecodeEnums Description }}

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

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

パラメーター セット

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

-ShouldFetchAttendeeCollection

適用対象: Exchange Online

{{ Fill ShouldFetchAttendeeCollection Description }}

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

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

パラメーター セット

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

-ShouldFetchRecurrenceExceptions

適用対象: Exchange Online

ShouldFetchRecurrenceExceptions パラメーターは、定期的な会議に例外を含めるかどうかを指定します。 有効な値は次のとおりです。

  • $true: 定期的な会議の例外を含めます。 この値を使用する場合は、ItemIds パラメーターも使用する必要があります。
  • $false: 定期的な会議の例外を含めないでください。 この値が既定値です。

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

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

パラメーター セット

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

-StartDate

適用対象: Exchange Online

StartDate パラメーターは、OriginalLastModifiedTime プロパティの日付範囲の開始日を指定します (会議が最後に変更されたとき、作成されていません)。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。

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

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

パラメーター セット

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

-Subject

適用対象: Exchange Online

Subject パラメーターでは、Subject フィールドで指定したテキストで予定表アイテムを特定します。 指定されたテキスト値は、大文字小文字を区別しません。 値にスペースが含まれている場合は、値を引用符で囲んでください。 ExactMatch パラメーターを使用して、正確な一致を使用するかどうかを設定できます。

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

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

パラメーター セット

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

CommonParameters

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