Set-SPExcelServiceApplication
Задает глобальные свойства приложения служб 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 |
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по