Get-CalendarDiagnosticObjects
Этот командлет доступен только в облачной службе.
Используйте командлет Get-CalendarDiagnosticObjects для сбора диапазона журналов календаря. Журналы диагностики календаря отслеживают важные данные о событиях, связанных с календарем, для каждого почтового ящика и могут использоваться для устранения проблем с календарем, возникающих в почтовых ящиках. Журналы отслеживают все элементы календаря и сообщения о собраниях.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Get-CalendarDiagnosticObjects
[-Identity] <UnifiedGroupOrUserMailboxIdParameter>
[-AutoRequeryOnMeetingId <Boolean>]
[-ConfigurationName <String>]
[-CustomPropertyNames <String[]>]
[-EndDate <ExDateTime>]
[-EntryId <String>]
[-EwsId <String>]
[-ExactMatch <Boolean>]
[-ItemClass <String[]>]
[-ItemIds <String[]>]
[-MaxResults <Int32>]
[-MeetingId <String>]
[-ODataId <String>]
[-ResultSize <Unlimited>]
[-ShouldBindToItem <Boolean>]
[-ShouldDecodeEnums <Boolean>]
[-ShouldFetchAttendeeCollection <Boolean>]
[-ShouldFetchRecurrenceExceptions <Boolean>]
[-StartDate <ExDateTime>]
[-Subject <String>]
[<CommonParameters>] Описание
Ниже перечислены некоторые наиболее интересные свойства, возвращаемые в результатах.
- AppointmentState: 1 = встреча является собранием, 2 = встреча была получена, 4 = встреча отменена, и 8 = встреча является переадресованной встречей.
- CalendarLogTriggerAction: действие, выполняемое с элементом (например, Создание или Обновление).
- ClientInfoString: сущность, которая внесла изменение (например,
Client=OWA;<AdditionalDetails>,Client=WebServices;<AdditionalDetails>; илиClient=TBA;Service=MSExchangeMailboxAssistants;Action=ELCAssistant;). - MeetingRequestType: 1 = Сообщение собрания является приглашением на собрание, 65536 = Сообщение собрания является полным обновлением существующего собрания, 131072 = Сообщение собрания является информационным обновлением существующего собрания, 262144 = Сообщение собрания является автоматическим обновлением, 524288 = Обновление устарело или 1048576 = Сообщение собрания пересылается делегату. и копия помечается как информационная.
- OriginalLastModifiedTime: используется в качестве основного поля сортировки для упорядочения событий.
- ResponseType: 0 = организатор не получил ответ, 1 = копия организатора собрания, 2 = Предварительный, 3 = Принять, 4 = Отклонить или 5 = Участник не ответил.
- ResponsibleUserName: значение LegacyExchangeDN пользователя, который внес изменение (например,
/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Configuration/cn=Servers/cn=BN6PR11MB1587/cn=Microsoft System Attendantили/o=ExchangeLabs/ou=Exchange Administrative Group (FYDIBOHF23SPDLT)/cn=Recipients/cn=696eea97d3c449eab648920d03385efb-admin).
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $trueВ этом примере показано, как получить журналы диагностики календаря из почтового ящика пользователя Pedro Pizarro для всех элементов, у которых значение в поле Subject точно совпадает с текстом Team Meeting.
Пример 2
$A = Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Meeting" -ExactMatch $true
$A | Select-Object *,@{n='OLMT'; e={[DateTime]::Parse($_.OriginalLastModifiedTime.ToString())}} | sort OLMT | Format-Table OriginalLastModifiedTime,CalendarLogTriggerAction,ItemClass,ClientInfoStringЭто то же самое, что и в предыдущем примере, но теперь результаты сортируются по исходному времени последнего изменения.
Пример 3
Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -MeetingID 40000008200E00074C5B7101A82E00800000000693ADAA3B5FCD201000000000000000010000000FF760A70460EAA4096B879872DF24F49В этом примере показано, как получить журналы диагностики календаря из почтового ящика пользователя Pedro Pizarro для собрания с указанным уникальным идентификатором глобального объекта (GOID).
Пример 4
Get-CalendarDiagnosticObjects -Identity "Pedro Pizarro" -Subject "Team Lunch" -StartDate 7/1/2018 -EndDate 7/31/2018 | Export-Csv "C:\My Documents\Team Lunch Meeting.csv" -NoTypeInformationЭтот пример возвращает диагностические сведения для собраний с темой Team Lunch в почтовом ящике Педро Писарро, которые были изменены в июле 2018 г., и экспортирует результаты в файл C:\My Documents\Team Lunch Meeting.csv.
Параметры
-AutoRequeryOnMeetingId
{{ Fill AutoRequeryOnMeetingId Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ConfigurationName
{{ Fill ConfigurationName Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-CustomPropertyNames
Параметр CustomPropertyNames возвращает указанное настраиваемое свойство элемента календаря в результатах. Допустимые значения см. в разделе Значения параметра CustomPropertyNames в Exchange Online PowerShell.
Вы можете указать несколько значений, разделив их запятыми.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EndDate
Параметр EndDate указывает дату окончания диапазона дат для свойства OriginalLastModifiedTime (когда собрание было изменено, а не было создано).
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 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 Online |
-EntryId
Параметр EntryID фильтрует результаты по указанному значению свойства EntryID, которое соответствует свойству MAPI PR_ENTRYID.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EwsId
{{ Fill EwsId Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ExactMatch
Параметр ExactMatch определяет вид соответствия (точное либо частичное), которое следует использовать для текстовых значений, указываемых для параметра Subject. Допустимые значения:
- $true. Поиск темы использует точное совпадение и выполняет поиск по всем элементам календаря в почтовом ящике. Например, при поиске по запросу "бюджет", поиск будет искать элементы, имеющие "бюджет" в любом месте темы, но не "бюджетирование".
- $false. Поиск темы использует частичное совпадение и выполняет поиск не более 1000 элементов календаря в почтовом ящике. Например, если вы ищете "бюджет", поиск будет искать элементы с "бюджет" и "бюджет" в любом месте темы. Это значение используется по умолчанию.
Поиск по теме с частичным соответствием может возвратить не все релевантные элементы календаря. Чтобы получить более точные результаты, попробуйте использовать поиск по теме с точным соответствием.
Этот параметр используется только с параметром Subject.
Значение этого параметра игнорируется при использовании параметра MeetingId.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Параметр Identity указывает почтовый ящик или группу Microsoft 365, календарь которых требуется просмотреть. Можно использовать любое значение, однозначно определяющее почтовый ящик или группу Microsoft 365. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
| Type: | UnifiedGroupOrUserMailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ItemClass
Параметр ItemClass фильтрует результаты по указанному значению свойства MessageClass элемента календаря (например, IPM.Appointment). Вы можете указать несколько значений, разделив их запятыми.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ItemIds
Параметр ItemIds фильтрует результаты по идентификатору элемента. Вы можете указать несколько значений, разделив их запятыми.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MaxResults
{{ Fill MaxResults Description }}
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-MeetingId
Параметр MeetingId фильтрует результаты по глобальному уникальному идентификатору элемента календаря. Значением является свойство CleanGlobalObjectId элемента календаря, доступного в выходных данных этого командлета, или с помощью других средств проверки MAPI. Пример значения: 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Это значение остается постоянным в течение всего времени существования элемента календаря.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ODataId
{{ Fill ODataId Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
Этот параметр определяет количество результатов, возвращаемых командлетом . Максимальное значение — 1000.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ShouldBindToItem
Параметр ShouldBindToItem указывает, следует ли усекать значения свойств, поддерживающих потоковую передачу (например, AppointmentRecurrenceBlob). Допустимые значения:
- $true. Значения больших потоковых свойств не усекаются, поэтому возвращается полное значение.
- $false. Значения больших потоковых свойств усекаются. Это значение используется по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ShouldDecodeEnums
{{ Fill ShouldDecodeEnums Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ShouldFetchAttendeeCollection
{{ Fill ShouldFetchAttendeeCollection Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ShouldFetchRecurrenceExceptions
Параметр ShouldFetchRecurrenceExceptions указывает, следует ли включать исключения в повторяющиеся собрания. Допустимые значения:
- $true. Включение исключений для повторяющихся собраний. При использовании этого значения потребуется также параметр ItemIds.
- $false: не включайте исключения в повторяющиеся собрания. Это значение используется по умолчанию.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-StartDate
Параметр StartDate указывает дату начала диапазона дат для свойства OriginalLastModifiedTime (когда собрание было изменено, а не было создано).
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 09/01/2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 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 Online |
-Subject
Параметр Subject определяет элементы календаря с помощью текста, указанного в поле Subject. Система не учитывает регистр задаваемых вами текстовых значений. Если значение содержит пробелы, необходимо заключить его в кавычки. Вы можете указать, следует ли использовать точные соответствия, с помощью параметра ExactMatch.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по