Get-CalendarDiagnosticObjects
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
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
{{ Fill AutoRequeryOnMeetingId Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ConfigurationName
{{ Fill ConfigurationName Description }}
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
{{ Fill EwsId Description }}
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
{{ Fill MaxResults Description }}
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
{{ Fill ODataId Description }}
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
{{ Fill ShouldDecodeEnums Description }}
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ShouldFetchAttendeeCollection
{{ Fill ShouldFetchAttendeeCollection Description }}
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 プロパティの日付範囲の開始日を指定します (会議が最後に変更されたとき、作成されていません)。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 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 |
-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 |