Get-CalendarDiagnosticAnalysis
Хотя этот командлет доступен в локальной среде Exchange и в облачной службе, он работает только в локальной среде Exchange.
Используйте Get-CalendarDiagnosticAnalysis командлет для устранения проблем с надежностью календарей. Этот командлет можно использовать для анализа данных об элементах календаря из журналов диагностики. Эти данные указываются с помощью командлета Get-CalendarDiagnosticLog.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
DefaultSet
Get-CalendarDiagnosticAnalysis
-CalendarLogs <CalendarLog[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>]
LocationSet
Get-CalendarDiagnosticAnalysis
-LogLocation <String[]>
[-DetailLevel <AnalysisDetailLevel>]
[-GlobalObjectId <String>]
[-OutputAs <OutputType>]
[<CommonParameters>]
Описание
Следующие свойства элемента календаря возвращаются по умолчанию (если для параметра DetailLevel установлено значение Basic):
- Местное время журнала
- ItemId
- NormalizedSubject
- StartTime
- EndTime
- CalendarLogTriggerAction
- ClientInfoString
- OriginalLastModifiedTime
- ClientIntent
- CleanGlobalObjectId
- ItemClass
- ParentDisplay
- Duration (Длительность)
- 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
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр CalendarLogs указывает элемент календаря, который необходимо проанализировать. Элемент календаря определяется путем сохранения выходных данных командлета Get-CalendarDiagnosticLog в переменной и использования этой переменной для значения этого параметра.
Например, чтобы проанализировать собрание с темой "Ноябрьское бюджетное собрание" в почтовом ящике Шеннона Стила, выполните команду $Budget = Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "November Budget Meeting" -ExactMatch , а затем используйте значение $Budget для этого параметра.
Значение этого параметра должно идентифицировать один элемент. Чтобы определить несколько элементов, см. пример 3.
Этот параметр нельзя использовать с параметром LogLocation.
Свойства параметров
| Тип: | CalendarLog[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
DefaultSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DetailLevel
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр DetailLevel указывает уровень необходимый уровень детализации анализа. Допустимые значения:
- Базовый. Это значение является значением по умолчанию. Возвращаемые свойства элемента календаря перечислены в разделе Подробное описание.
- Дополнительно: возвращаются 37 дополнительных свойств элемента календаря. Это значение следует использовать только для подробных сведений об отладке.
Свойства параметров
| Тип: | AnalysisDetailLevel |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-GlobalObjectId
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр GlobalObjectId указывает идентификатор элемента календаря, который необходимо проанализировать. В Exchange 2013 этот параметр можно использовать вместе с параметром LogLocation, чтобы указать элемент календаря, если расположение содержит несколько экспортированных .msg файлов.
Свойство GlobalObjectId собрания использует тот же формат, что и свойство CleanGlobalObjectId (например, 040000008200E00074C5B7101A82E008000000009421DCCD5046CD0100000000000000001000000010B0349F6B17454685E17D9F9512E71F), и значение двух свойств, скорее всего, совпадает. Однако значение GlobalObjectId может меняться для экземпляров одного собрания в разных календарях (например, в разные экземпляры одного повторяющегося собрания приглашены разные участники).
Свойства параметров
| Тип: | String |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LogLocation
Применимо: Exchange Server 2013 г., Exchange Online
Примечание. Этот параметр был удален из Exchange 2016 и Exchange 2019 накопительным Обновления H1 2022, так как он принимает значения пути UNC. Чтобы указать элементы календаря для анализа, используйте параметр CalendarLogs.
Этот параметр работает только в Exchange 2013.
Параметр LogLocation указывает расположение экспортированных элементов календаря, которые необходимо проанализировать. Можно указать локальный путь или UNC-путь (\\Server\Share\User). Если значение содержит пробелы, его необходимо заключить в кавычки (").
Элементы календаря экспортируются в файлы .msg с помощью командлета Get-CalendarDiagnosticLog с параметром LogLocation. Если путь содержит несколько файлов MSG, все они анализируются при запуске Get-CalendarDiagnosticAnalysis.
Этот параметр нельзя использовать с параметром CalendarLogs.
Свойства параметров
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
LocationSet
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-OutputAs
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE, Exchange Online
Параметр OutputAs указывает формат выходных данных команды. Допустимые значения:
- CSV-файл (значение по умолчанию)
- HTML
- XML
Свойства параметров
| Тип: | OutputType |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.