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

Get-CalendarDiagnosticObjects

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Online

Этот командлет доступен только в облачной службе.

Используйте командлет 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