Get-CalendarDiagnosticLog
Хотя этот командлет доступен в локальной среде 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по