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

Get-CalendarDiagnosticLog

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

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

Командлет Get-CalendarDiagnosticLog используется для получения диапазона журналов календаря. Журналы диагностики календаря позволяют отслеживать все элементы календаря и приглашения на собрания в почтовых ящиках. Вы можете использовать эти сведения при устранении проблем с календарем в почтовых ящиках.

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

Синтаксис

Get-CalendarDiagnosticLog
   [-Identity] <MailboxIdParameter>
   -MeetingID <String>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-LogLocation <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-CalendarDiagnosticLog
   [-Identity] <MailboxIdParameter>
   -Subject <String>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-LogLocation <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-CalendarDiagnosticLog
   [-Identity] <MailboxIdParameter>
   -LogLocation <String>
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-EndDate <ExDateTime>]
   [-EntryId <String>]
   [-ExactMatch <Boolean>]
   [-ItemClass <String[]>]
   [-ItemIds <String[]>]
   [-Latest]
   [-MeetingID <String>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [-StartDate <ExDateTime>]
   [-Subject <String>]
   [<CommonParameters>]

Описание

Выходные данные этого командлета содержат следующее:

  • IsFileLink: указывает, экспортирован ли элемент календаря в MSG-файл с помощью параметра LogLocation. Доступны значения True и False.
  • Удостоверение. Определяет почтовый ящик, в котором хранится элемент календаря. Пример значения: excallog://laura@contoso.com/?id=RgAAAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAAAAAAAAACoatc7EmnEQ1iF35p17stAAAAAAABEIAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP.
  • LogDate: дата регистрации элемента календаря.
  • NormalizedSubject: поле Subject элемента календаря.
  • CleanGlobalObjectId: идентификатор, который является константой на протяжении всего времени существования элемента календаря. Пример: 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55.

После запуска командлета Get-CalendarDiagnosticLog можно анализировать данные календаря с помощью командлета Get-CalendarDiagnosticAnalysis. Дополнительные сведения см. в разделе Get-CalendarDiagnosticAnalysis.

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

Примеры

Пример 1

Get-CalendarDiagnosticLog -Identity "Shannon Steele" -Subject "Weekly development meeting" -ExactMatch $true

Этот пример кода получает записи журнала диагностики календаря для почтового ящика пользователя Shannon Steele, для которых указана тема "Weekly development meeting" (Еженедельное собрание по разработке).

Пример 2

Get-CalendarDiagnosticLog -Identity oevans -StartDate "6/1/2018 6:00:00 AM" -EndDate "6/30/2018 5:00:00 PM"

В этом примере извлекаются записи журнала диагностики календаря для почтового ящика Оскара Эванса с 01.06.2018 по 30.06.2018 г.

Пример 3

Get-CalendarDiagnosticLog -Identity jkozma@contoso.com -Subject "Weekly development meeting" -Latest

Этот пример кода получает данные журнала диагностики календаря только для самого нового элемента календаря в почтовом ящике пользователя Jasen Kozma, для которого указана тема "Weekly development meeting" (Еженедельное собрание по разработке).

Пример 4

Get-CalendarDiagnosticLog -Identity "Jasen Kozma" -Subject "Budget Meeting" -ExactMatch $true -LogLocation "C:\My Documents\Calendar Diagnostic Export"

В Exchange 2013 в этом примере экспортируются все элементы календаря в журнале диагностики календаря для почтового ящика Джейсена Козьмы, у которых есть "Бюджетное собрание" в любом месте темы в указанную папку.

Примечания.

  • В этом примере файлы сообщений записываются в папку C:\My Documents\Calendar Diagnostic Export\jkozma@contoso.com.
  • В локальных организациях Exchange можно использовать командлет Get-CalendarDiagnosticAnalysis для анализа экспортированных MSG-файлов.
  • Этот пример не работает в Exchange 2016 или Exchange 2019, так как параметр LogLocation недоступен.

Параметры

-Credential

Этот параметр доступен только в локальной среде Exchange.

Параметр Credential указывает имя пользователя и пароль, используемые для выполнения этой команды. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения.

Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Этот параметр доступен только в локальной среде Exchange.

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-EndDate

Параметр EndDate указывает дату окончания из диапазона дат.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-EntryId

Параметр EntryId фильтрует результаты по идентификатору записи. Вы можете указать несколько значений, разделив их запятыми.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, 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 Server 2016, Exchange Server 2019, Exchange Online

-Identity

Параметр Identity определяет почтовый ящик, который содержит элементы календаря. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • GUID
  • LegacyExchangeDN
  • SamAccountName
  • Идентификатор пользователя или имя участника-пользователя
Type:MailboxIdParameter
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-ItemClass

Параметр ItemClass фильтрует результаты по указанному значению свойства MessageClass элемента календаря (например, IPM.Appointment). Вы можете указать несколько значений, разделив их запятыми.

Этот параметр может использоваться только с параметром MeetingID.

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

-ItemIds

Параметр ItemIds фильтрует результаты по идентификатору элемента. Вы можете указать несколько значений, разделив их запятыми.

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

-Latest

Параметр Latest определяет, нужно ли возвращать данные журнала календаря только для самого нового элемента календаря. Указывать значение для этого параметра необязательно.

Type:SwitchParameter
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. Использование этого командлета теперь ограничено локальным сервером.

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

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

В указанном расположении вложенная папка автоматически создается для заданного почтового ящика, который содержит экспортированные элементы календаря. Например, если указать значение "C:\My Documents\Calendar Export" для экспорта элементов календаря из почтового ящика Шеннона Стила, MSG-файлы фактически хранятся в C:\My Documents\Calendar Export\ssteele@contoso.com.

В локальных организациях Exchange можно использовать командлет Get-CalendarDiagnosticAnalysis для анализа экспортированных MSG-файлов.

Примечание. Команды, использующие этот параметр, могут завершиться ошибкой, если элемент календаря не имеет заголовка. Если при использовании этого параметра возникают ошибки, снова выполните команду и замените этот параметр перенаправлением на файл (| Set-Content -Path "C:\My Documents\Calendar Export") или замените выходные данные переменной PowerShell.

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

-MeetingID

Параметр MeetingID фильтрует результаты по глобально уникальному идентификатору элемента календаря. Значением является свойство CleanGlobalObjectId элемента календаря, доступного в выходных данных этого командлета, или с помощью других средств проверки MAPI. Пример значения: 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Это значение остается постоянным в течение всего времени существования элемента календаря.

Чтобы найти это значение, проще всего сначала найти элемент календаря с помощью параметров Subject, StartDate и EndDate. После того как вы найдете нужный элемент календаря, его значение CleanGlobalObjectId можно использовать для параметра MeetingID в будущих командах.

Не применяйте этот параметр вместе с параметром Subject, так как значение параметра MeetingID приоритетнее.

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

-ReadFromDomainController

Этот параметр доступен только в локальной среде Exchange.

Переключатель ReadFromDomainController указывает, что сведения будут считываться из контроллера домена в домене пользователя. Для этого переключателя не требуется указывать значение.

Для Set-AdServerSettings -ViewEntireForest $true включения всех объектов в лесу требуется параметр ReadFromDomainController. В противном случае команда может использовать глобальный каталог, содержащий устаревшие сведения. Кроме того, для получения сведений может потребоваться выполнить несколько итераций команды с параметром ReadFromDomainController.

По умолчанию в качестве области получателя задается домен, в котором размещаются серверы Exchange.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-ResultSize

Этот параметр определяет количество результатов, возвращаемых командлетом . Максимальное значение — 1000.

Type:Unlimited
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-StartDate

Параметр StartDate указывает дату начала из диапазона дат.

Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование формата короткой даты мм / дд / гггг, введите 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 Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Subject

Параметр Subject определяет элементы календаря с помощью текста, указанного в поле Subject. Регистр задаваемых вами текстовых значений не учитывается. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Вы можете указать, следует ли использовать точные соответствия, с помощью параметра ExactMatch.

Не применяйте этот параметр вместе с параметром MeetingID, так как значение параметра MeetingID приоритетнее.

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

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

Input types

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

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

Output types

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