Merge-SPLogFile

  • Ссылка
Модуль:
sharepoint-server
Применяется к:
SharePoint Server Subscription Edition

Собирает записи журналов трассировки со всех компьютеров фермы в единый файл журнала на локальном компьютере.

Синтаксис

Merge-SPLogFile
     -Path <String>
     [-Area <String[]>]
     [-AssignmentCollection <SPAssignmentCollection>]
     [-Category <String[]>]
     [-ContextFilter <String[]>]
     [-Correlation <Guid[]>]
     [-EndTime <DateTime>]
     [-EventID <String[]>]
     [-ExcludeNestedCorrelation]
     [-Level <String>]
     [-Message <String[]>]
     [-Overwrite]
     [-Process <String[]>]
     [-StartTime <DateTime>]
     [-ThreadID <UInt32[]>]
     [<CommonParameters>]

Описание

Командлет Merge-SPLogFile возвращает записи из файлов журналов трассировки единой службы ведения журнала (ULS) на каждом сервере фермы, соответствующем условиям, и записывает результаты в новый файл журнала на локальном компьютере. Если результаты не возвращаются, в окне консоли Windows PowerShell записывается предупреждение.

Рекомендуем выполнять фильтрацию с помощью параметров StartTime и EndTime, чтобы оптимизировать работу этого командлета. Некоторые параметры фильтрации, например Process, Area, Category, EventID и Message, поддерживают использование подстановочных знаков.

Сведения о разрешениях и актуальную информацию о Windows PowerShell для продуктов SharePoint см. в сетевой документации о командлетах SharePoint Server.

Примеры

--------------ПРИМЕР 1-----------------

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite

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

--------------ПРИМЕР 2-----------------

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area Search

В этом примере выполняется объединение данных журнала из области Search, полученных за последний час.

--------------ПРИМЕР 3-----------------

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Area "SharePoint Foundation","Web Analytics Services"

В этом примере выполняется объединение данных журнала из областей SharePoint Foundation и Web Analytics Services, полученных за последний час.

--------------------------ПРИМЕР 4------------------------

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Level High

В этом примере выполняется объединение данных журнала уровня High или более высоких уровней.

--------------------------ПРИМЕР 5------------------------

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -StartTime "06/09/2008 16:00" -EndTime "06/09/2008 16:15"

В этом примере выполняется объединение данных журнала для событий за определенный временной интервал, заданный в допустимом формате для США.

--------------------------ПРИМЕР 6------------------------

Merge-SPLogFile -Path "C:\Logs\FarmMergedLog.log" -Overwrite -Message "*permission changed*"

В этом примере выполняется объединение данных журнала для событий с текстом permission changed, используемым в качестве текста сообщения.

--------------------------ПРИМЕР 7------------------------

Merge-SPLogFile -Overwrite -Path d:\1.log -ContextFilter "name=timer job*" -Area "*search*"

В этом примере выполняется объединение данных журнала для всех заданий таймера поиска.

--------------------------ПРИМЕР 8------------------------

Merge-SPLogFile -Overwrite -Path d:\2.log -ContextFilter "user=contoso?joeuser"

В этом примере демонстрируется способ объединения данных журнала для всех пользователей, имена которых заданы в формате contoso\joeuser или Contoso/joeuser.

Параметры

-Area

Задает имя области для фильтрации.

Тип значения: допустимое имя, например SharePoint Foundation.

Поддерживается использование подстановочных знаков.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-AssignmentCollection

Позволяет корректно удалять объекты. При использовании объектов таких типов, как SPWeb или SPSite, возможен захват больших объемов памяти, и работа с такими объектами в скриптах Windows PowerShell требует точного управления памятью. С помощью объекта SPAssignment вы можете назначить объекты переменной и освободить память, удалив ненужные объекты. Объекты SPWeb, SPSite или SPSiteAdministration после использования удаляются автоматически, если коллекция назначения или параметр Global не применяются.

Если применяется параметр Global, то все объекты размещаются в глобальной области памяти. Если объекты не используются сразу же или не удаляются командой Stop-SPAssignment, может возникнуть ситуация нехватки памяти.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Category

Задает идентификатор категории для фильтрации.

Тип значения: допустимое имя категории, например category1.

Поддерживается использование подстановочных знаков.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ContextFilter

Задает фильтр для записей трассировки в определенном контексте в формате ключ=значение, например пользователь=contoso\joeuser.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Correlation

Задает идентификатор взаимосвязи для фильтрации. Типом должен быть допустимый идентификатор GUID в формате F0BB0790-4323-A153-096F-ABCDC80E24D4.

Type:Guid[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-EndTime

Задает конечное время для возвращаемых записей журнала.

Типом должен быть допустимый формат даты и времени с учетом административного языка соответствующих страны/региона, например 2/16/2007 12:15:12 для английского языка (США).

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-EventID

Задает идентификатор события, по которому следует выполнить фильтрацию. Поддерживается использование подстановочных знаков.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ExcludeNestedCorrelation

Исключает вложенные значения корреляции в результатах. Этот параметр используется только в тех случаях, когда фильтрация результатов выполняется с помощью параметра ContextFilter.

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Level

Задает имя уровня для фильтрации.

Результаты включают заданный уровень и более высокие уровни.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Message

Задает текст сообщения для фильтрации.

Типом должен быть допустимый текст. Текст с пробелами должен быть заключен в кавычки, например "Это проверочное сообщение".

Поддерживается использование подстановочных знаков.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Overwrite

Производит перезапись файла журнала, если он уже расположен по заданному пути.

Типом должно быть одно из следующих значений:

  • $True
  • $False

Значение по умолчанию: $False.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Path

Задает путь и имя файла, в который будет осуществляться запись файла объединенного журнала. Можно использовать относительные пути.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Process

Задает имя процесса для фильтрации.

Поддерживается использование подстановочных знаков.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-StartTime

Задает начальное время для возвращаемых записей журнала.

Типом должен быть допустимый формат даты и времени с учетом административного языка соответствующих страны/региона, например 2/16/2007 12:15:12 для английского языка (США).

По умолчанию используется значение на один час раньше текущего значения времени на локальном компьютере.

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ThreadID

Задает идентификатор потока для фильтрации.

Тип значения: допустимое целое число от 0 до 4 294 967 295.

Type:UInt32[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition