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>]
[-ShouldResolveParticipants <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 のメールボックス内の Team Lunch という件名との会議の診断情報を返し、結果を 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 パラメーターは、結果に含まれる、指定した予定表アイテムのカスタム プロパティを返します。 有効な値については、「Exchange Online PowerShell の CustomPropertyNames パラメーターの値」を参照してください。
複数の値をコンマで区切って指定できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndDate
適用対象: Exchange Online
EndDate パラメーターは、"OriginalLastModifiedTime" プロパティの日付範囲の終了日を指定します (会議が最後に変更されたときで、作成されなかったとき)。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 MM/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 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
{{ EwsId の説明を塗りつぶす }}
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExactMatch
適用対象: Exchange Online
ExactMatch パラメーターは、Subject パラメーターに指定したテキスト値に関して完全一致と部分一致どちらを使用するかを指定します。 有効な値は次のとおりです。
- $true: 件名検索では完全一致が使用され、メールボックス内のすべての予定表アイテムが検索されます。 たとえば、"budget" で検索すると、検索結果は件名に "budget" と含まれているアイテムを検索しますが、"budgeting" は含まれません。
- $false: 件名検索は部分一致を使用し、メールボックス内の最大 1,000 個の予定表アイテムを検索します。 たとえば、"budget" と検索すると、件名内に "budget" と "budgeting" を含むアイテムが検索されます。 この値が既定値です。
部分的な件名一致検索では、関連する予定表アイテムの一部が返されない場合があります。 より正確な結果を得るには、完全一致の件名検索を使用してください。
このパラメーターは、サブジェクト パラメーターでのみ使用します。
MeetingId パラメーターを使用する場合、このパラメーターの値は無視されます。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Online
ID パラメーターでは、予定表を表示するメールボックスまたは Microsoft 365 グループを指定します。 メールボックスまたは Microsoft 365 グループを一意に識別する任意の値を使用できます。 例:
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- ドメイン\ユーザー名
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
注意: Identityパラメータの値$nullまたは存在しない値は、IdentityパラメータなしでGet-コマンドを実行したかのように、 すべての オブジェクトを返します。 Identity パラメーターの値のリストが正確であり、存在しない$null値が含まれていないことを確認します。
パラメーターのプロパティ
| 型: | 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 パラメーターは、予定表アイテムのグローバル一意識別子で結果をフィルター処理します。 値は、このコマンドレットの出力で、または他の MAPI 検査ツールを使用して使用できる予定表アイテムの CleanGlobalObjectId プロパティです。 値の例は 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
{{ ShouldFetchAttendeeCollection の説明を埋める }}
パラメーターのプロパティ
| 型: | 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 |
-ShouldResolveParticipants
適用対象: Exchange Online
{{ ShouldResolveParticipants description }} を埋める
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StartDate
適用対象: Exchange Online
StartDate パラメーターは、"OriginalLastModifiedTime" プロパティの日付範囲の開始日を指定します (会議が最後に変更されたときで、作成されなかったとき)。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 MM/dd/yyyy を使用するようにコンピューターが構成されている場合は、「09/01/2018」と入力して 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」を参照してください。