Get-CalendarDiagnosticAnalysis
Хотя этот командлет доступен в локальной среде 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по