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


New-SPExcelServiceApplication

Создает новый экземпляр приложения служб Excel.

Синтаксис

New-SPExcelServiceApplication
   -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
   [-Name <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-Default]
   [-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>]
New-SPExcelServiceApplication
   -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
   [-Name <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-Default]
   [-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>]

Описание

Командлет New-SPExcelServiceApplication создает новое приложение веб-службы приложения службы Excel с новыми параметрами. После создания приложения веб-службы приложения службы Excel можно использовать Set-SPExcelServiceApplication командлет для изменения глобальных параметров нового приложения.

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

Примеры

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

New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"

В этом примере создается экземпляр приложения службы Excel с отображаемым именем MyExcelService.

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

New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5

В этом примере создается новый экземпляр приложения службы Excel с отображаемым именем My Excel Service и допускается только пять сеансов на пользователя для каждого серверного сервера приложений, на котором выполняется службы Excel приложение.

Параметры

-ApplicationPool

Указывает существующий пул приложений IIS, в котором будет запущена веб-служба для нового приложения Excel Service.

Типом должен быть действительный объект SPIisWebServiceApplicationPool.

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

-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

-Default

Добавляет прокси-сервер для этого приложения-службы в группу прокси-серверов по умолчанию фермы.

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

-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

-Name

Указывает понятное имя для нового приложения веб-службы приложения службы Excel. Используемое имя должно быть уникальным именем приложения веб-службы приложений службы Excel, которое находится в этой ферме. Это имя может содержать не более 128 знаков. Значение по умолчанию — Service_numofapplications+1.

Типом должна быть допустимая строка (например, MyExcelServiceApp1).

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

-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

{{Fill UnattendedServiceAccount Description}}

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

-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

{{Fill UseEffectiveUserName Description}}

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

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