Merge-SPLogFile
Собирает записи журналов трассировки со всех компьютеров фермы в единый файл журнала на локальном компьютере.
Синтаксис
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 |