Get-CalendarDiagnosticLog
Хотя этот командлет доступен в локальной версии Exchange и в облачной службе, он работает только в локальной среде Exchange. В облачной службе используйте командлет Get-CalendarDiagnosticObjects.
Командлет Get-CalendarDiagnosticLog используется для получения диапазона журналов календаря. Журналы диагностики календаря позволяют отслеживать все элементы календаря и приглашения на собрания в почтовых ящиках. Вы можете использовать эти сведения при устранении проблем с календарем в почтовых ящиках.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
MeetingId
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-MeetingID <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>]
MeetingSubject
Get-CalendarDiagnosticLog
[-Identity] <MailboxIdParameter>
-Subject <String>
[-Credential <PSCredential>]
[-DomainController <Fqdn>]
[-LogLocation <String>]
[-ReadFromDomainController]
[-ResultSize <Unlimited>]
[<CommonParameters>]
ExportToMsg
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"
В этом примере получены записи журнала диагностики Calendar для почтового ящика Оскара Эванса с 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 в этом примере экспортируются все элементы календаря из журнала диагностики Calendar для почтового ящика Ясена Козьмы и содержащие фразу "Бюджетное собрание" в теме указанной папки.
Примечания.
- В этом примере файлы сообщений записываются в папку C:\My Documents\Calendar Diagnostic Export\jkozma@contoso.com.
- В локальных организациях Exchange вы можете использовать командлет Get-CalendarDiagnosticAnalysis для анализа экспортированных .msg файлов.
- Этот пример не работает в Exchange 2016 или Exchange 2019, так как параметр LogLocation недоступен.
Параметры
-Credential
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр Credential указывает имя пользователя и пароль, используемые для выполнения этой команды. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения.
Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.
Свойства параметров
| Тип: | PSCredential |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EndDate
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр EndDate указывает дату окончания из диапазона дат.
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование короткого формата даты ММ/ДД/ГГГГ, введите 01.09.2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".
Свойства параметров
| Тип: | ExDateTime |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExportToMsg
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-EntryId
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр EntryId фильтрует результаты по идентификатору записи. Вы можете указать несколько значений, разделив их запятыми.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExportToMsg
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ExactMatch
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр ExactMatch определяет вид соответствия (точное либо частичное), которое следует использовать для текстовых значений, указываемых для параметра Subject. Допустимые значения:
- $true. При поиске по теме используется точное совпадение и поиск выполняется по всем элементам календаря в почтовом ящике. Например, при поиске по запросу "бюджет" поиск будет искать элементы, которые содержат слово "бюджет" в теме, но не слово "бюджет".
- $false. При поиске по теме используется частичное совпадение, и в почтовом ящике выполняется поиск не более 1000 элементов календаря. Например, при поиске по запросу "бюджет" будут искать элементы, которые содержат слова "бюджет" и "составление бюджета" в любом месте в теме. Это значение используется по умолчанию.
При поиске частичного совпадения темы могут быть возвращены не все соответствующие элементы календаря. Чтобы получить более точные результаты, попробуйте использовать поиск по теме с точным соответствием.
Этот параметр используется только с параметром Subject.
Значение этого параметра игнорируется при использовании параметра MeetingId.
Свойства параметров
| Тип: | Boolean |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExportToMsg
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр Identity определяет почтовый ящик, который содержит элементы календаря. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Домен\Имя пользователя
- Адрес электронной почты
- GUID
- LegacyExchangeDN
- SamAccountName
- Идентификатор пользователя или имя участника-пользователя
Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.
Свойства параметров
| Тип: | MailboxIdParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | 1 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ItemClass
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр ItemClass фильтрует результаты по указанному значению свойства MessageClass элемента календаря (например, IPM.Appointment). Вы можете указать несколько значений, разделив их запятыми.
Этот параметр может использоваться только с параметром MeetingID.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExportToMsg
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ItemIds
Применимо: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр ItemIds фильтрует результаты по идентификатору элемента. Вы можете указать несколько значений, разделив их запятыми.
Свойства параметров
| Тип: | String[] |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExportToMsg
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Latest
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр Latest определяет, нужно ли возвращать данные журнала календаря только для самого нового элемента календаря. С этим параметром не нужно указывать значение.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExportToMsg
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LogLocation
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Online
Примечание. Этот параметр был удален из Exchange 2016 и Exchange 2019 накопительным обновлением за первое полугодие 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.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExportToMsg
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
MeetingId
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
MeetingSubject
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-MeetingID
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр MeetingID фильтрует результаты по глобально уникальному идентификатору элемента календаря. Значением является свойство CleanGlobalObjectId элемента календаря, доступное в выходных данных этого командлета или с помощью других средств проверки MAPI. Пример значения: 040000008200E00074C5B7101A82E00800000000B0225ABF0710C80100000000000000001000000005B27C05AA7C4646B0835D5EB4E41C55. Это значение остается постоянным в течение всего времени существования элемента календаря.
Чтобы найти это значение, проще всего сначала выполнить поиск элемента календаря по параметрам Subject, StartDate и EndDate. Найдя нужный элемент календаря, можно использовать его значение CleanGlobalObjectId для параметра MeetingID в будущих командах.
Не применяйте этот параметр вместе с параметром Subject, так как значение параметра MeetingID приоритетнее.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
MeetingId
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
ExportToMsg
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ReadFromDomainController
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
Этот параметр доступен только в локальной среде Exchange.
Переключатель ReadFromDomainController указывает, что сведения будут считываться из контроллера домена в домене пользователя. С этим параметром не нужно указывать значение.
Команда: чтобы включить все объекты в лесу, Set-AdServerSettings -ViewEntireForest $true требуется ключ ReadFromDomainController. В противном случае команда может использовать глобальный каталог, содержащий устаревшие сведения. Кроме того, для получения информации может потребоваться выполнить несколько итераций команды с помощью переключателя ReadFromDomainController.
По умолчанию в качестве области получателей задается домен, на котором размещаются серверы Exchange.
Свойства параметров
| Тип: | SwitchParameter |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Этот параметр определяет количество результатов, возвращаемых командлетом. Максимальное значение — 1000.
Свойства параметров
| Тип: | Unlimited |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-StartDate
Применимо: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр StartDate указывает дату начала из диапазона дат.
Используйте формат короткой даты, определенный в настройках региональных параметров на компьютере, на котором выполняется команда. Например, если компьютер настроен на использование короткого формата даты ММ/ДД/ГГГГ, введите 01.09.2018, чтобы указать 1 сентября 2018 года. Допускается ввод только даты или даты и времени. Если вы вводите дату и время дня, заключите это значение в кавычки ("), например," 09/01/2018 5:00 PM ".
Свойства параметров
| Тип: | ExDateTime |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
ExportToMsg
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Subject
Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
Параметр Subject определяет элементы календаря с помощью текста, указанного в поле Subject. Регистр задаваемых вами текстовых значений не учитывается. Если значение содержит пробелы, его необходимо заключить в кавычки ("). Вы можете указать, следует ли использовать точные соответствия, с помощью параметра ExactMatch.
Не применяйте этот параметр вместе с параметром MeetingID, так как значение параметра MeetingID приоритетнее.
Свойства параметров
| Тип: | String |
| Значение по умолчанию: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
MeetingSubject
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
ExportToMsg
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.
Входные данные
Input types
Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.
Выходные данные
Output types
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.