Get-CalendarDiagnosticLog

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Командлет 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=RgAAAACF/h/dHTTkQbdPrk7z+G4SBwCoatc7EmnEQq1iF35p17stAAAAAAFEAACoatc7EmnEQq1iF35p17stAAAAABEIAAAP.
  • LogDate: дата и время регистрации элемента календаря.
  • NormalizedSubject: поле "Тема" элемента календаря.
  • 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"

Этот пример кода экспортирует в указанную папку все элементы календаря, приведенные в журнале диагностики календаря для почтового ящика пользователя Jasen Kozma, тема которых содержит "Budget Meeting" (Собрание, посвященное бюджету).

Примечания:

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

Параметры

-Credential

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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