Get-CalendarDiagnosticObjects

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online

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

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

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

構文

Get-CalendarDiagnosticObjects
   [-Identity] <UnifiedGroupOrUserMailboxIdParameter>
   [-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=WebServices;<AdditionalDetails>、Client=OWA;<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=Recipients/cn=696eea97d3c449eab648920d03385efb-adminなど/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendant)。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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にエクスポートします。

パラメーター

-AutoRequeryOnMeetingId

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

-ConfigurationName

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

-CustomPropertyNames

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

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

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

-EndDate

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

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

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

-EntryId

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

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

-EwsId

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

-ExactMatch

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

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

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

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

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

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

-Identity

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

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

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

-ItemClass

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

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

-ItemIds

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

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

-MaxResults

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

-MeetingId

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

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

-ODataId

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

-ResultSize

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

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

-ShouldBindToItem

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

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

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

-ShouldDecodeEnums

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

-ShouldFetchAttendeeCollection

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

-ShouldFetchRecurrenceExceptions

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

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

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

-StartDate

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

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

-Subject

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

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