Get-CalendarDiagnosticLog
このコマンドレットは、オンプレミスの Exchange とクラウドベースのサービスで使用できますが、オンプレミスの Exchange でのみ機能します。 クラウドベースのサービスでは、代わりに Get-CalendarDiagnosticObjects コマンドレットを使用します。
予定表ログの範囲を収集するには、Get-CalendarDiagnosticLog コマンドレットを使用します。 予定表の診断ログは、メールボックス内のすべての予定表アイテムおよび会議出席依頼を追跡します。 メールボックスで発生する予定表に関する問題のトラブルシューティングを行うために、この情報を利用できます。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
MeetingId
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-MeetingID <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>]
MeetingSubject
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-Subject <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>]
ExportToMsg
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-LogLocation <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-EndDate <ExDateTime>]
[-EntryId <String>]
[-ExactMatch <Boolean>]
[-ItemClass <String[]>]
[-ItemIds <String[]>]
[-Latest]
[-MeetingID <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[-StartDate <ExDateTime>]
[-Subject <String>]
[<CommonParameters>]
説明
このコマンドレットの出力には、次の情報が含まれています。
- IsFileLink: LogLocation パラメーターを使用して、予定表アイテムを.msg ファイルにエクスポートするかどうかを示します。 値は True または False です。
- Identity: 予定表アイテムを保持しているメールボックスを識別します。 値の例は、excallog://laura@contoso.com/?id=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAP です。
- LogDate: 予定表アイテムが記録された日時です。
- NormalizedSubject: 予定表アイテムの Subject フィールドです。
- CleanGlobalObjectId: 予定表アイテムの存続期間を通じて一定の値を保つ識別子です。 たとえば、040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55。
Get-CalendarDiagnosticLog コマンドレットを実行すると、Get-CalendarDiagnosticAnalysis コマンドレットを使用して予定表データを分析できます。 詳細については、「Get-CalendarDiagnosticAnalysis」を参照してください。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $true
この例では、Shannon Steele のメールボックスを "Weekly development meeting" という件名で検索して、予定表の診断ログのエントリを取得します。
例 2
Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2018 6:00:00 AM" -EndDate "6/30/2018 5:00:00 PM"
この例では、2018 年 6 月 1 日から 2018 年 6 月 30 日まで、オスカー Evans のメールボックスの予定表診断ログ エントリを取得します。
例 3
Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -Latest
この例では、Jasen Kozma のメールボックスにある、メッセージの件名が "Weekly development meeting" の最新の予定表アイテムのみに関する予定表診断ログ データを取得します。
例 4
Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"
Exchange 2013 では、この例では、Jasen Kozma のメールボックスの予定表診断ログ内のすべての予定表アイテムをエクスポートします。このメールボックスには、指定したフォルダーの任意の場所に "予算会議" があります。
注:
- この例では、メッセージ ファイルは C:\My Documents\Calendar Diagnostic Export\jkozma@contoso.com に書き込まれます。
- オンプレミスの Exchange 組織では、Get-CalendarDiagnosticAnalysis コマンドレットを使用して、エクスポートされた.msg ファイルを分析できます。
- この例は、LogLocation パラメーターを使用できないため、Exchange 2016 または Exchange 2019 では機能しません。
パラメーター
-Credential
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
Credential パラメーターは、このコマンドの実行に使用されるユーザー名とパスワードを指定します。 通常、このパラメーターはスクリプトや、必要なアクセス許可を持つ別の資格情報を入力する必要がある場合に使用します。
このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。
パラメーターのプロパティ
| 型: | PSCredential |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EndDate
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
EndDate パラメーターには、日付範囲の終了日を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。
パラメーターのプロパティ
| 型: | ExDateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ExportToMsg
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-EntryId
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
EntryId パラメーターは、エントリ ID によって結果をフィルター処理します。 複数の値をコンマで区切って指定できます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ExportToMsg
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ExactMatch
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ExactMatch パラメーターは、Subject パラメーターに指定したテキスト値に関して完全一致と部分一致どちらを使用するかを指定します。 有効な値は次のとおりです。
- $true: 件名の検索では、完全一致が使用され、メールボックス内のすべての予定表アイテムが検索されます。 たとえば、"予算" を検索すると、検索では"予算" が件名の任意の場所にあるが、"予算作成" ではないアイテムが検索されます。
- $false: 件名の検索では、部分的な一致が使用され、メールボックス内の最大 1,000 個の予定表アイテムが検索されます。 たとえば、"予算" を検索すると、件名の任意の場所で "予算" と "予算作成" を持つアイテムが検索されます。 この値が既定値です。
部分的な件名一致検索では、関連するすべての予定表アイテムが返されない場合があります。 より正確な結果を得るには、完全一致の件名検索を使用してください。
このパラメーターは Subject パラメーターでのみ使用します。
MeetingId パラメーターを使用する場合、このパラメーターの値は無視されます。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ExportToMsg
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Identity パラメーターでは、予定表アイテムを含むメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。
- 名前
- Alias
- 識別名 (DN)
- 正規 DN
- ドメイン\ユーザー名
- 電子メール アドレス
- GUID
- LegacyExchangeDN
- SamAccountName
- ユーザー ID またはユーザー プリンシパル名 (UPN)
パラメーターのプロパティ
| 型: | MailboxIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ItemClass
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ItemClass パラメーターは、予定表アイテムの指定された MessageClass プロパティ値で結果をフィルターします (たとえば、IPM.Appointment)。 複数の値をコンマで区切って指定できます。
このパラメーターは MeetingID パラメーターとのみ併用できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ExportToMsg
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ItemIds
適用対象: Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
ItemIds パラメーターは、アイテム ID で結果をフィルター処理します。 複数の値をコンマで区切って指定できます。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ExportToMsg
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Latest
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Latest スイッチは、最新の予定表アイテムのみの予定表ログ データを返すかどうかを指定します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ExportToMsg
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-LogLocation
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Online
注: このパラメーターは、UNC パス値を受け入れるため、2022 H1 累積更新プログラムによって Exchange 2016 および Exchange 2019 から削除されました。 このコマンドレットの使用がローカル サーバーに制限されるようになりました。
このパラメーターは、Exchange 2010 および Exchange 2013 でのみ機能します。
LogLocation パラメーターでは、予定表アイテムを .msg ファイルにエクスポートする場所を指定します。 ローカル パスまたは UNC パス (\\Server\Share) を指定できます。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。
指定した場所に指定したメールボックス用のサブフォルダーが自動的に作成され、エクスポートした予定表アイテムが保持されます。 たとえば、シャノン スティールのメールボックスから予定表アイテムをエクスポートする値 "C:\My Documents\Calendar Export" を指定した場合、.msg ファイルは実際には C:\My Documents\Calendar Export\ssteele@contoso.comに格納されます。
オンプレミスの Exchange 組織では、Get-CalendarDiagnosticAnalysis コマンドレットを使用して、エクスポートされた.msg ファイルを分析できます。
注:予定表アイテムにタイトルがない場合、このパラメーターを使用するコマンドが失敗することがあります。 このパラメーターを使用するときにエラーが発生した場合は、コマンドをもう一度実行し、このパラメーターをファイルへのリダイレクト (| Set-Content -Path "C:\My Documents\Calendar Export") に置き換えるか、出力を PowerShell 変数に置き換えます。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ExportToMsg
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MeetingId
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
MeetingSubject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-MeetingID
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
MeetingID パラメーターでは、予定表アイテムのグローバル一意識別子で結果をフィルター処理します。 値は、このコマンドレットの出力で使用できる予定表アイテムの CleanGlobalObjectId プロパティ、または他の MAPI 検査ツールを使用してです。 値の例は 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55 です。 この値は予定表アイテムの存続期間を通じて一定です。
この値を見つけるには、まず Subject、StartDate、EndDate の各パラメーターを使用して予定表アイテムを検索するのが最も簡単です。 目的の予定表アイテムを見つけたら、今後のコマンドで MeetingID パラメーターの CleanGlobalObjectId 値を使用できます。
このパラメーターは、Subject パラメーターと一緒には使用しないでください。MeetingID パラメーターの値のほうが優先されるからです。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MeetingId
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
ExportToMsg
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-ReadFromDomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
このパラメーターは、オンプレミスの Exchange でのみ使用できます。
ReadFromDomainController スイッチは、情報がユーザーのドメインのドメイン コントローラーから読み取られることを指定します。 このスイッチで値を指定する必要はありません。
コマンド: Set-AdServerSettings -ViewEntireForest $true フォレスト内のすべてのオブジェクトを含めるには、ReadFromDomainController スイッチが必要です。 それ以外の場合、コマンドは、古い情報を含むグローバル カタログを使用する可能性があります。 また、情報を取得するには、ReadFromDomainController スイッチを使用してコマンドの繰り返しを複数回実行する必要がある場合があります。
既定では、受信者の範囲は、Exchange サーバーをホストするドメインに設定されています。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResultSize
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
このパラメーターは、コマンドレットによって返される結果の数を決定します。 最大値は 1000 です。
パラメーターのプロパティ
| 型: | Unlimited |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-StartDate
適用対象: Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
StartDate パラメーターは、日付範囲の開始日を指定します。
コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、コンピューターが短い日付形式 MM/dd/yyyy を使用するように構成されている場合は、「2018 年 9 月 1 日」と入力して、2018 年 9 月 1 日を指定します。 日付のみを入力したり、日付と時刻を入力することもできます。 日付と時刻を入力する場合は、値を引用符 (”) で囲む必要があります (例: "09/01/2018 5:00 PM")。
パラメーターのプロパティ
| 型: | ExDateTime |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ExportToMsg
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Subject
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE、Exchange Online
Subject パラメーターでは、Subject フィールドで指定したテキストで予定表アイテムを特定します。 指定したテキスト値では、大文字小文字が区別されません。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。 ExactMatch パラメーターを使用して、完全一致を使用するかどうかを設定できます。
このパラメーターは、MeetingID パラメーターと一緒には使用しないでください。MeetingID パラメーターの値のほうが優先されるからです。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
MeetingSubject
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
ExportToMsg
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。