Поделиться через


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 Subscription Edition

-DiagnosticLogPath

Указывает файл, в который следует записывать диагностические сведения. Указывается относительный путь.

Type:String
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 для английского языка (США).

Значение по умолчанию — текущее время.

Если вы хотите указать время в формате 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 Subscription Edition

-Identity

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

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

-OverWrite

Перезаписывает диагностические данные в файле журнала, если он существует в заданном каталоге.

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

-Partial

Не используется.

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

-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 Subscription Edition

-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 Subscription Edition

Входные данные

Microsoft.SharePoint.PowerShell.SPUsageDefinitionPipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Выходные данные

System.Object