Merge-SPUsageLog
Возвращает записи из файлов журнала об использовании.
Синтаксис
Merge-SPUsageLog
[-Identity] <SPUsageDefinitionPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-DiagnosticLogPath <String>]
[-EndTime <DateTime>]
[-OverWrite]
[-Partial]
[-Servers <String[]>]
[-StartTime <DateTime>]
[<CommonParameters>] Описание
Командлет Merge-SPUsageLog возвращает записи из файлов журнала об использовании для каждого сервера фермы, который соответствует условиям, а затем записывает результаты в конвейер.
Команда собирает, фильтрует и объединяет журналы с учетом указанных пользователем условий. Рекомендуем выполнять фильтрацию с помощью параметров StartTime и EndTime, чтобы оптимизировать работу этого командлета.
Следует указать по крайней мере тип использования. Сведения о допустимых типах использования приведены в статье Get-SPUsageDefinition.
Для этого командлета необходимо включить удаленное взаимодействие PowerShell.
Примеры
Пример 1
Merge-SPUsageLog -Identity 'Timer Jobs' -Servers SPSERVER1Объединяет журнал использования для определения использования "Задания таймера" с указанного сервера и выходные данные в консоль PowerShell.
Параметры
-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 2016, SharePoint Server 2019 |
-DiagnosticLogPath
Указывает файл, в который следует записывать диагностические сведения. Указывается относительный путь.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-EndTime
Задает конечное время для возвращаемых записей журнала.
Типом должен быть допустимый формат даты и времени для административного языка соответствующих страны или региона, то есть 2/16/2007 12:15:12 для английского языка (США).
Значение по умолчанию текущее время.
Если вы хотите указать время в формате UTC, добавьте "Z" в конец параметра. Пример: "2016-06-15 03:29:18.199 Z". Если не добавить "Z", будет показываться время, настроенное на локальном компьютере, а не время в формате UTC.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-Identity
Указывает имя файла журнала, содержащего данные об использовании.
| Type: | SPUsageDefinitionPipeBind |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-OverWrite
Перезаписывает диагностические данные в файле журнала, если он существует в заданном каталоге.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-Partial
Не используется.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-Servers
Один или несколько адресов серверов, по которым нужно выполнить фильтрацию.
Чтобы получить список действительных адресов в ферме, используйте команду Get-SPServer | Select Address.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-StartTime
Задает начальное время для возвращаемых записей журнала.
Типом должен быть допустимый формат даты и времени для административного языка соответствующих страны или региона, например 2/16/2007 12:15:12 для английского языка (США).
По умолчанию используется значение на один час раньше текущего времени на локальном компьютере.
Если вы хотите указать время в формате UTC, добавьте "Z" в конец параметра. Пример: "2016-06-15 03:29:18.199 Z". Если не добавить "Z", будет показываться время, настроенное на локальном компьютере, а не время в формате UTC.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
Входные данные
Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind
Microsoft.SharePoint.PowerShell.SPAssignmentCollection
Выходные данные
System.Object