Set-SPUsageService

Задает свойства службы использования.

Синтаксис

Set-SPUsageService
   [[-Identity] <SPUsageServicePipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-LoggingEnabled <Boolean>]
   [-UsageLogCutTime <UInt32>]
   [-UsageLogLocation <String>]
   [-UsageLogMaxFileSizeKB <UInt32>]
   [-UsageLogMaxSpaceGB <UInt32>]
   [-WhatIf]
   [<CommonParameters>]

Описание

Командлет Set-SPUsageService обновляет свойства службы использования. Если параметр Identity не указан, командлет применяет изменения к локальной службе использования.

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

Примеры

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

Set-SPUsageService -LoggingEnabled $false
Set-SPUsageService -UsageLogLocation "D:\\testusagelogdir"
Set-SPUsageService -UsageLogCutTime 5

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

Параметры

-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

-Confirm

Предлагает подтвердить выполнение команды. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

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

-Identity

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

Тип должен указываться в одной из следующих форм:

--Допустимый GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh --Допустимое имя службы использования (например, UsageService1) - Экземпляр допустимого объекта SPUsageService.

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

-LoggingEnabled

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

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

-UsageLogCutTime

Задает продолжительность (в минутах) сбора данных об использовании в файле журнала использования. Значение по умолчанию - 5 минут.

Значение должно быть целым числом в диапазоне от 1 до 1440.

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

-UsageLogLocation

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

Значение должно быть допустимым локальным путем следующего вида:

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

-UsageLogMaxFileSizeKB

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

Минимальное значение - 512 килобайт (КБ), максимальное значение - 65536 КБ.

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

-UsageLogMaxSpaceGB

Максимальный объем пространства (в гигабайтах), разрешенный для журналов использования. Хотя параметр присутствует в более поздних версиях SharePoint Server, он применим только к SharePoint Server 2010.

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

-WhatIf

Отображает описание команды. При этом сама команда не выполняется. Чтобы получить дополнительные сведения, введите следующую команду: get-help about_commonparameters

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