Get-CalendarDiagnosticAnalysis

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Хотя этот командлет доступен в локальной среде Exchange и в облачной службе, он работает только в локальной среде Exchange.

Используйте Get-CalendarDiagnosticAnalysis командлет для устранения проблем с надежностью календарей. Этот командлет можно использовать для анализа данных об элементах календаря из журналов диагностики. Эти данные указываются с помощью командлета Get-CalendarDiagnosticLog.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-CalendarDiagnosticAnalysis
   -CalendarLogs <CalendarLog[]>
   [-DetailLevel <AnalysisDetailLevel>]
   [-GlobalObjectId <String>]
   [-OutputAs <OutputType>]
   [<CommonParameters>]

Get-CalendarDiagnosticAnalysis
   -LogLocation <String[]>
   [-DetailLevel <AnalysisDetailLevel>]
   [-GlobalObjectId <String>]
   [-OutputAs <OutputType>]
   [<CommonParameters>]

Описание

Следующие свойства элемента календаря возвращаются по умолчанию (если для параметра DetailLevel установлено значение Basic):

Местное время журнала
ItemId
NormalizedSubject
StartTime
EndTime
CalendarLogTriggerAction
ClientInfoString
OriginalLastModifiedTime
ClientIntent
CleanGlobalObjectId
ItemClass
ParentDisplay
Длительность
AppointmentRecurring
SentRepresentingEmailAddress
SenderEmailAddress
SentRepresentingDisplayName

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

$logs = Get-CalendarDiagnosticLog -Identity oevans -MeetingID 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000001000000010B0349F6B17454685E17D9F9512E71F

Get-CalendarDiagnosticAnalysis -CalendarLogs $logs -DetailLevel Advanced | Set-Content -Path "C:\My Documents\Oscar Evans Analysis.csv"

Этот пример получает указанный элемент календаря из почтового ящика Оскара Эванса, сохраняет его в виде переменной и записывает расширенный анализ элемента в CSV-файл.

Для базового анализа элемента не включайте параметр DetailLevel или используйте значение Basic, а не Advanced.

Пример 2

Get-CalendarDiagnosticAnalysis -LogLocation "C:\My Documents\Exported Calendar Logs\jkozma@contoso.com" -DetailLevel Advanced -OutputAs HTML | Set-Content -Path "C:\My Documents\Jasen Kozma Analysis.html"

В Exchange 2013 этот пример анализирует элементы календаря, которые ранее экспортировались из почтового ящика Jasen Козьмы, с помощью командлета Get-CalendarDiagnosticLog с параметром LogLocation, и записывает расширенный анализ элементов в HTML-файл.

Примечание. Параметр LogLocation доступен только в Exchange 2013. Сведения о расположении экспортированных элементов календаря в Exchange 2016 или Exchange 2019 см. в разделе Пример 3.

Для базового анализа элементов не включайте параметр DetailLevel или используйте значение Basic, а не Advanced.

Пример 3

$calitems = Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Budget Meeting"

ForEach($item in $calitems){$i++; Get-CalendarDiagnosticAnalysis -CalendarLogs $item -OutputAs HTML | Set-Content -Path ("\\FileServer01\Data\Jasen Kozma Analysis{0}.html" -f $i)}

В этом примере анализируются элементы календаря, экспортированные из почтового ящика Jasen Козьмы с помощью командлета Get-CalendarDiagnosticLog, а расширенный анализ каждого элемента записывается в HTML-файл с помощью UNC-пути.

Для базового анализа элементов не включайте параметр DetailLevel или используйте значение Basic, а не Advanced.

Параметры

-CalendarLogs

Параметр CalendarLogs указывает элемент календаря, который необходимо проанализировать. Элемент календаря определяется путем сохранения выходных данных командлета Get-CalendarDiagnosticLog в переменной и использования этой переменной для значения этого параметра.

Например, чтобы проанализировать собрание с темой "Ноябрьское бюджетное собрание" в почтовом ящике Шеннона Стила, выполните команду $Budget = Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "November Budget Meeting" -ExactMatch , а затем используйте значение $Budget для этого параметра.

Значение этого параметра должно идентифицировать один элемент. Чтобы определить несколько элементов, см. пример 3.

Этот параметр нельзя использовать с параметром LogLocation.

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

-DetailLevel

Параметр DetailLevel указывает уровень необходимый уровень детализации анализа. Допустимые значения:

Базовый. Это значение по умолчанию. Возвращаемые свойства элемента календаря перечислены в разделе Подробное описание.
Дополнительно: возвращаются 37 дополнительных свойств элемента календаря. Это значение следует использовать только для подробных сведений об отладке.

Type:	AnalysisDetailLevel
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

-GlobalObjectId

Параметр GlobalObjectId указывает идентификатор элемента календаря, который необходимо проанализировать. В Exchange 2013 этот параметр можно использовать вместе с параметром LogLocation, чтобы указать элемент календаря, если расположение содержит несколько экспортированных MSG-файлов.

Свойство GlobalObjectId собрания использует тот же формат, что и свойство CleanGlobalObjectId (например, 0400000008200E00074C5B7101A82E008000000009421DCCD5046CD01000000000000000000100000010B0349F6B17454685E17D9F9512E71F) и значение двух свойств, вероятно, совпадает. Однако значение GlobalObjectId может меняться для экземпляров одного собрания в разных календарях (например, в разные экземпляры одного повторяющегося собрания приглашены разные участники).

Type:	String
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

Примечание. Этот параметр был удален из Exchange 2016 и Exchange 2019 накопительным Обновления H1 за 2022 год, так как он принимает значения пути UNC. Чтобы указать элементы календаря для анализа, используйте параметр CalendarLogs.

Этот параметр работает только в Exchange 2013.

Параметр LogLocation указывает расположение экспортированных элементов календаря, которые необходимо проанализировать. Можно указать локальный путь или UNC-путь (\\Server\Share\User). Если значение содержит пробелы, его необходимо заключить в кавычки (").

Элементы календаря экспортируются в MSG-файлы с помощью командлета Get-CalendarDiagnosticLog с параметром LogLocation. Если путь содержит несколько файлов MSG, все они анализируются при запуске Get-CalendarDiagnosticAnalysis.

Этот параметр нельзя использовать с параметром CalendarLogs.

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

-OutputAs

Параметр OutputAs указывает формат выходных данных команды. Допустимые значения:

CSV (значение по умолчанию)
HTML
XML

Type:	OutputType
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

Входные данные

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

Выходные данные

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.

Поделиться через