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

Set-SPWordConversionServiceApplication

  • Ссылка
Модуль:
SharePointServer
Применяется к:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Задает свойства для приложения Word Automation Services.

Синтаксис

Set-SPWordConversionServiceApplication
   [-Identity] <WordServiceApplicationPipeBind>
   [-ActiveProcesses <Int32>]
   [-AddSupportedFormats <String[]>]
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-ClearSupportedFormats]
   [-Confirm]
   [-ConversionsPerInstance <Int32>]
   [-ConversionTimeout <Int32>]
   [-DatabaseCredential <PSCredential>]
   [-DatabaseName <String>]
   [-DatabaseServer <String>]
   [-DisableBinaryFileScan]
   [-DisableEmbeddedFonts]
   [-KeepAliveTimeout <Int32>]
   [-MaximumConversionAttempts <Int32>]
   [-MaximumConversionTime <Int32>]
   [-MaximumMemoryUsage <Int32>]
   [-RecycleProcessThreshold <Int32>]
   [-RemoveSupportedFormats <String[]>]
   [-TimerJobFrequency <Int32>]
   [-WhatIf]
   [-MaximumGroupSize <Int32>]
   [-MaximumSyncConversionRequests <Int32>]
   [<CommonParameters>]

Описание

Командлет Set-SPWordConversionServiceApplication задает глобальные свойства приложения Word Automation Services.

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

Примеры

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

Get-SPServiceApplication -Name WordServices1 | Set-SPWordConversionServiceApplication -TimerJobFrequency 30

В этом примере для приложения WordServices1 указывается частота запуска задания таймера, равная 30 минутам.

Параметры

-ActiveProcesses

Указывает количество процессов преобразования на каждом компьютере, на котором запущено приложение-служба. Это значение эквивалентно числу одновременных преобразований. Значение по умолчанию — 8.

Типом должно быть целое число от 1 до 1000.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-AddSupportedFormats

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

Возможное значение — разделенный запятыми список следующих строк: docx, doc, mht, rtf, xml.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ApplicationPool

Указывает существующий пул приложений под управлением IIS, в котором запущен данный экземпляр служб автоматизации Word.

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

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ClearSupportedFormats

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConversionsPerInstance

Указывает количество элементов, отправляемых в каждый процесс преобразования (см. описание параметра ActiveProcesses ранее в этой таблице) при каждом запуске задания таймера. Значение по умолчанию — 12.

Возможные значения: допустимое целое число.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ConversionTimeout

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

Типом должно быть допустимое целое число от 1 до 60.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseCredential

Указывает учетные данные, используемые для подключения к базе данных приложения служб автоматизации Word. Этот параметр следует использовать только в том случае, если для доступа к базе данных приложения-службы используется проверка подлинности SQL.

Если указан параметр DatabaseCredential, обязательными также являются параметры DatabaseName и DatabaseServer.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseName

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

Возможные значения: допустимое имя базы данных SQL, например MetadataDB1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseServer

Указывает имя хост-сервера для базы данных служб автоматизации Word.

Возможные значения: допустимое имя узла сервера баз данных SQL Server, например SQLServerHost1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisableBinaryFileScan

Указывает, выполняются ли дополнительные проверки при обработке документов Word. Этот параметр следует отключать лишь в том случае, если все обрабатываемые службой документы получены из надежных источников.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DisableEmbeddedFonts

Указывает, следует ли пропускать внедренные шрифты в подаваемых на вход документах.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

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

Типом должен быть действительный идентификатор GUID в виде 12345678-90ab-cdef-1234-567890bcdefgh, действительное имя приложения служб автоматизации Word (например, WordSvcApp1) или экземпляр действительного объекта SPServiceApplication.

Type:WordServiceApplicationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-KeepAliveTimeout

Задает период в секундах, по истечении которого преобразование, не реагирующее на команды, завершается. Значение по умолчанию — 30 дней.

Типом должно быть целое число от 10 до 60.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumConversionAttempts

Задает максимальное число попыток преобразования, после совершения которых преобразование помечается как невыполненное (Failed). Значение по умолчанию — 2.

Типом должно быть целое число от 1 до 10.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumConversionTime

Указывает максимальный период в секундах, по истечении которого преобразование завершается. Значение по умолчанию равно 300.

Типом должно быть целое число от 60 до MaxInt.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumGroupSize

{{Fill MaximumGroupSize Description}}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumMemoryUsage

Указывает максимальный объем системной памяти (в процентах), который разрешено использовать приложению-службе. Значение по умолчанию — 100.

Типом должно быть целое число от 10 до 100.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MaximumSyncConversionRequests

{{Fill MaximumSyncConversionRequests Description}}

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RecycleProcessThreshold

Указывает число документов, которые могут быть преобразованы до повторного запуска процесса преобразования. Дополнительные сведения о процессе преобразования см. в описании параметра ActiveProcess выше в этой таблице.

Типом должно быть целое число от 1 до 1000.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-RemoveSupportedFormats

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

Тип значения — разделенный запятыми список, содержащий одну или несколько из следующих строк: docx, doc, mht, rtf и xml.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-TimerJobFrequency

Указывает частоту запуска (в минутах) задания таймера для данного приложения-службы. Значение по умолчанию — 15.

Типом должно быть целое число от 1 до 59.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019