Get-CalendarDiagnosticLog

  • リファレンス
モジュール:
ExchangePowerShell
適用対象:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

このコマンドレットは、オンプレミスの Exchange とクラウドベースのサービスで使用できますが、オンプレミスの Exchange でのみ機能します。 クラウドベースのサービスでは、代わりに Get-CalendarDiagnosticObjects コマンドレットを使用します。

予定表ログの範囲を収集するには、Get-CalendarDiagnosticLog コマンドレットを使用します。 予定表の診断ログは、メールボックス内のすべての予定表アイテムおよび会議出席依頼を追跡します。 メールボックスで発生する予定表に関する問題のトラブルシューティングを行うために、この情報を利用できます。

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

構文

Get-CalendarDiagnosticLog
   [-Identity] <MailboxIdParameter>
   -MeetingID <String>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-LogLocation <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-CalendarDiagnosticLog
   [-Identity] <MailboxIdParameter>
   -Subject <String>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-LogLocation <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
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 でのみ使用できます。

Credential パラメーターは、このコマンドの実行に使用されるユーザー名とパスワードを指定します。 通常、このパラメーターはスクリプトや、必要なアクセス許可を持つ別の資格情報を入力する必要がある場合に使用します。

このパラメーターの値には、Get-Credential コマンドレットが必要です。 このコマンドを一時停止し、資格情報の入力を求めるメッセージを表示するには、値(Get-Credential)を使用します。 または、このコマンドを実行する前に、資格情報を変数 (たとえば、$cred = Get-Credential) に保存し、このパラメーターに変数名 ($cred) を使用します。 詳細については、Get-Credentialに関するページをご覧ください。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EndDate

EndDate パラメーターには、日付範囲の終了日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-EntryId

EntryId パラメーターは、エントリ ID によって結果をフィルター処理します。 複数の値をコンマで区切って指定できます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online

-Identity

Identity パラメーターでは、予定表アイテムを含むメールボックスを指定します。 メールボックスを一意に識別する任意の値を使用できます。 次に例を示します。

  • 名前
  • Alias
  • 識別名 (DN)
  • 正規 DN
  • Domain\Username
  • 電子メール アドレス
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • ユーザー ID またはユーザー プリンシパル名 (UPN)
Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ItemClass

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

このパラメーターは MeetingID パラメーターとのみ併用できます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online

-Latest

Latest スイッチは、最新の予定表アイテムのみの予定表ログ データを返すかどうかを指定します。 このスイッチで値を指定する必要はありません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-LogLocation

注: このパラメーターは、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 変数に置き換えます。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Online

-MeetingID

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

この値を見つけるには、まず Subject、StartDate、EndDate の各パラメーターを使用して予定表アイテムを検索するのが最も簡単です。 目的の予定表アイテムを見つけたら、今後のコマンドで MeetingID パラメーターの CleanGlobalObjectId 値を使用できます。

このパラメーターは、Subject パラメーターと一緒には使用しないでください。MeetingID パラメーターの値のほうが優先されるからです。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ReadFromDomainController

このパラメーターは、オンプレミスの Exchange でのみ使用できます。

ReadFromDomainController スイッチは、情報がユーザーのドメインのドメイン コントローラーから読み取られることを指定します。 このスイッチで値を指定する必要はありません。

コマンド: Set-AdServerSettings -ViewEntireForest $true フォレスト内のすべてのオブジェクトを含めるには、ReadFromDomainController スイッチが必要です。 それ以外の場合、コマンドは、古い情報を含むグローバル カタログを使用する可能性があります。 また、情報を取得するには、ReadFromDomainController スイッチを使用してコマンドの繰り返しを複数回実行する必要がある場合があります。

既定では、受信者の範囲は、Exchange サーバーをホストするドメインに設定されています。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

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

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-StartDate

StartDate パラメーターは、日付範囲の開始日を指定します。

コマンドを実行するコンピューターの [地域のオプション] 設定で定義されている短い日付形式を使用します。 たとえば、短い日付形式 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Subject

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

このパラメーターは、MeetingID パラメーターと一緒には使用しないでください。MeetingID パラメーターの値のほうが優先されるからです。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。