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

Set-SPExcelServiceApplication

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

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

Синтаксис

Set-SPExcelServiceApplication
   [[-Identity] <SPExcelServiceApplicationPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
   [-ExternalDataConnectionLifetime <Int32>]
   [-FileAccessMethod <FileAccessMethod>]
   [-LoadBalancingScheme <LoadBalancingScheme>]
   [-MemoryCacheThreshold <Int32>]
   [-PrivateBytesMax <Int32>]
   [-SessionsPerUserMax <Int32>]
   [-SiteCollectionAnonymousSessionsMax <Int32>]
   [-TerminateProcessOnAccessViolation]
   [-ThrottleAccessViolationsPerSiteCollection <Int32>]
   [-UnattendedAccountApplicationId <String>]
   [-UnusedObjectAgeMax <Int32>]
   [-WhatIf]
   [-WorkbookCache <String>]
   [-WorkbookCacheSizeMax <Int32>]
   [-UseEffectiveUserName]
   [-WorkbookModelUsageTracker <String>]
   [<CommonParameters>]
Set-SPExcelServiceApplication
   [[-Identity] <SPExcelServiceApplicationPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
   [-ExternalDataConnectionLifetime <Int32>]
   [-FileAccessMethod <FileAccessMethod>]
   [-LoadBalancingScheme <LoadBalancingScheme>]
   [-MemoryCacheThreshold <Int32>]
   [-PrivateBytesMax <Int32>]
   [-SessionsPerUserMax <Int32>]
   [-SiteCollectionAnonymousSessionsMax <Int32>]
   [-TerminateProcessOnAccessViolation]
   [-ThrottleAccessViolationsPerSiteCollection <Int32>]
   [-UnusedObjectAgeMax <Int32>]
   [-WhatIf]
   [-WorkbookCache <String>]
   [-WorkbookCacheSizeMax <Int32>]
   [-UnattendedServiceAccount <PSCredential>]
   [-UseEffectiveUserName]
   [-WorkbookModelUsageTracker <String>]
   [<CommonParameters>]

Описание

Командлет изменяет глобальные Set-ExcelServiceApplication свойства среды выполнения для приложения службы Excel. Изменения свойств, внесенные с помощью этого командлета, влияют на все компьютеры фермы, на которых выполняется экземпляр указанного службы Excel приложения веб-службы приложения.

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

Примеры

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

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -SessionsPerUserMax 10

В этом примере задается службы Excel Application, чтобы разрешить каждому пользователю одновременно открывать не более 10 сеансов на внутреннем сервере приложений, на котором выполняется службы Excel приложение.

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

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1

В этом примере максимальное число частных байтов памяти на компьютере задается в значение -1, указывающее, что службы Excel приложение будет потреблять 50 процентов доступных ресурсов памяти.

Параметры

-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

-CachingOfUnusedFilesEnable

Указывает, что файлы, которые больше не используются приложением службы Excel, могут оставаться в кэше для последующего использования. Если этот параметр не указан, по умолчанию принимается значение true (истина).

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

-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

-CrossDomainAccessAllowed

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

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

-EncryptedUserConnectionRequired

Требуется, чтобы шифрование использовалось между конечным пользователем и сервером, на котором выполняется службы Excel приложение. Областью действия этого параметра является логический сервер. Значение по умолчанию: None (нет).

Типом должно быть значение None или Connection.

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

-ExternalDataConnectionLifetime

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

Допустимые значения:

-1 Никогда не перезапускайте

От 1 до 2073600 Оставаться активным от 1 секунды до 24 дней.

Значение по умолчанию — 1800.

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

-FileAccessMethod

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

Типом должно быть значение UseImpersonation или UseFileAccessAccount.

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

-Identity

Указывает объект SPExcelServiceApplication, который необходимо обновить.

Тип должен быть допустимым ИДЕНТИФИКАТОРом GUID в форме 12345678-90ab-cdef-1234-567890bcdefgh; допустимое имя приложения веб-службы приложения службы Excel в ферме (например, MyExcelService1) или экземпляр допустимого объекта SPExcelServiceApplication.

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

-LoadBalancingScheme

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

Типом должно быть одно из следующих значений: RoundRobin, Local или WorkbookURL.

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

-MemoryCacheThreshold

Указывает процентную долю от наибольшего количества байтов исключительного пользования, которая может быть выделена для размещения неактивных объектов. При превышении порогового значения кэша памяти неиспользуемые в настоящий момент кэшированные объекты удаляются. Значение 0 отключает кэширование неактивных объектов. Значение по умолчанию равно 90.

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

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

-PrivateBytesMax

Указывает максимальное количество частных байтов (в мегабайтах), используемых приложением службы Excel. Если значение равно -1, под байты исключительного пользования по умолчанию выделяется 50 процентов физической памяти компьютера. Допустимы значение -1 (без ограничений) и любое положительное целое число. Значение по умолчанию равно -1.

Типом должно быть значение -1 или любое положительное целое число.

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

-SessionsPerUserMax

Указывает наибольшее число сеансов, разрешенное для одного пользователя. В случае достижения этого значения при открытии новых сеансов самый старый сеанс удаляется. Можно использовать значение -1 (без ограничений) или любое положительное целое число. Значение по умолчанию: 25.

Типом должно быть значение -1 или любое положительное целое число.

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

-SiteCollectionAnonymousSessionsMax

Указывает наибольшее число анонимных сеансов, разрешенное для одного семейства веб-сайтов. Значение 0 запрещает анонимные сеансы. Можно использовать значения -1 (без ограничений), 0 (параметр отключен) или любое положительное целое число. Значение по умолчанию: 25.

Типом должно быть значение -1, 0 или любое положительное целое число.

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

-TerminateProcessOnAccessViolation

Завершает службы Excel приложение при нарушении доступа в процессе.

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

-ThrottleAccessViolationsPerSiteCollection

Указывает, что если книга вызывает ошибку нарушения доступа в приложении службы Excel, все файлы, исходящие из семейства веб-сайтов этой книги, блокируются для загрузки в течение указанного периода (в секундах). Это правило не распространяется на существующие сеансы для файлов из этого семейства сайтов. Допустимы значение 0 (параметр отключен) и любое значение от 1 до 2 073 600 секунд (24 дня). Значение по умолчанию равно 0.

Типом должно быть положительное целое число от 0 до 2 073 600.

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

-UnattendedAccountApplicationId

Указывает идентификатор приложения, используемый для поиска учетных данных учетной записи автоматической службы безопасного хранения данных, которая указана с помощью параметра UnattendedAccountSecureServiceAppName. Обращение к службе безопасного хранения данных выполняется, если этот параметр задан и возникают определенные ошибки. Допустимыми значениями являются буквенно-цифровые строки не длиннее 256 символов. Значение по умолчанию: пустая строка.

Типом должна быть допустимая строка буквенно-цифровых символов (например, UnattendedServiceAccountID).

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

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

-UnattendedServiceAccount

Автоматическая учетная запись службы — это одна учетная запись, которую все книги могут использовать для обновления данных. Эта учетная запись необходима для обновления данных, если в подключениях к книге указано "Использовать автоматическую учетную запись службы" без использования учетных данных Windows.

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

-UnusedObjectAgeMax

Указывает наибольшее время хранения в кэше памяти объектов, которые не используются в настоящий момент в сеансе (мин.). Можно использовать значение -1 (параметр отключен) или положительное целое число из диапазона от 1 до 34 560 минут (24 дня). Значение по умолчанию равно -1.

Типом должно быть значение -1 или целое число от 1 до 34 560.

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

-UseEffectiveUserName

Свойство UseEffectiveUserName является альтернативой делегированию Windows, позволяя пользователям безопасно получать доступ к данным служб Analysis Services.

Этот параметр будет влиять только на подключения к внешним данным на основе подключений к книге Analysis Services с параметром проверки подлинности "Использовать учетную запись пользователя, прошедшего проверку подлинности".

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

-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

-WorkbookCache

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

Если значение не задано, то значением по умолчанию является подкаталог временного каталога системы.

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

-- C:\folder_name -- \\server_name\folder_name

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

-WorkbookCacheSizeMax

Задает максимально допустимый размер отдельного сеанса в МБ. Значение по умолчанию равно 0.

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

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

-WorkbookModelUsageTracker

{{Fill WorkbookModelUsageTracker Description}}

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