New-SPExcelServiceApplication
适用于: SharePoint Server 2010
上一次修改主题: 2015-03-09
创建 Excel Services 应用程序 的新实例。
Syntax
New-SPExcelServiceApplication -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-CachingOfUnusedFilesEnable <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-CrossDomainAccessAllowed <SwitchParameter>] [-Default <SwitchParameter>] [-EncryptedUserConnectionRequired <None | Connection>] [-ExternalDataConnectionLifetime <Int32>] [-FileAccessMethod <UseImpersonation | UseFileAccessAccount>] [-LoadBalancingScheme <WorkbookUrl | RoundRobin | Local>] [-MemoryCacheThreshold <Int32>] [-Name <String>] [-PrivateBytesMax <Int32>] [-SessionsPerUserMax <Int32>] [-SiteCollectionAnonymousSessionsMax <Int32>] [-TerminateProcessOnAccessViolation <SwitchParameter>] [-ThrottleAccessViolationsPerSiteCollection <Int32>] [-UnattendedAccountApplicationId <String>] [-UnusedObjectAgeMax <Int32>] [-WhatIf [<SwitchParameter>]] [-WorkbookCache <String>] [-WorkbookCacheSizeMax <Int32>]
详细说明
New-SPExcelServiceApplication cmdlet 会使用新设置创建一个新的 Excel Services 应用程序 Web 服务应用程序。创建新的 Excel Services 应用程序 Web 服务应用程序 后,可以使用 Set-SPExcelServiceApplication cmdlet 修改新应用程序的全局设置。
有关此 cmdlet 的权限和最新信息,请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
参数 | 是否必需 | 类型 | 说明 |
---|---|---|---|
ApplicationPool |
必需 |
Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind |
为新的 Excel Service 应用程序指定要在其中运行 Web 服务的现有 IIS 应用程序池。 键入的值必须为有效的 SPIisWebServiceApplicationPool 对象。 |
Name |
必需 |
System.String |
指定新 Excel Services 应用程序 Web 服务应用程序 的友好名称。您使用的名称必须是位于此服务器场中的 Excel Services 应用程序 Web 服务应用程序 的唯一名称。该名称最多可包含 128 个字符。默认值为 Service_numofapplications+1。 键入的值必须是有效字符串;例如,MyExcelServiceApp1。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。 备注 在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。 |
CachingOfUnusedFilesEnable |
可选 |
System.Management.Automation.SwitchParameter |
指定 Excel Services 应用程序 不再使用的文件可以保留在缓存中供以后使用。如果命令中未指定该参数,则默认值为 true。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息,请键入以下命令:get-help about_commonparameters |
CrossDomainAccessAllowed |
可选 |
System.Management.Automation.SwitchParameter |
指定驻留在其他 HTTP 域中的 Web 部件或页面可以请求和呈现受信任工作簿及数据连接文件。 |
Default |
可选 |
System.Management.Automation.SwitchParameter |
指定将此服务应用程序的代理添加到场的默认代理组中。 |
EncryptedUserConnectionRequired |
可选 |
Microsoft.Office.Excel.Server.EncryptedConnectionMode |
要求在最终用户和 Excel Services 应用程序 服务器之间使用加密。此设置的作用范围为逻辑服务器。默认值为 None。 键入的值必须为以下项之一:None 或 Connection。 |
ExternalDataConnectionLifetime |
可选 |
System.Int32 |
指定外部数据连接可在连接池中保持打开状态的最大秒数。有效值包括: -1 从不回收 1 到 2073600 保持活动状态的时间为 1 秒到 24 天。 默认值为 1800。 |
FileAccessMethod |
可选 |
Microsoft.Office.Excel.Server.FileAccessMethod |
指定 Excel Services 应用程序 用于检索文件的身份验证方法。UseFileAccessAccount 指定所有工作簿始终使用运行 Excel Services 应用程序 的服务帐户的凭据。UseImpersonation 指定 Excel Services 应用程序 以发出请求的用户的身份检索工作簿文件。默认值为 UseImpersonation。 键入的值必须为以下项之一:UseImpersonation 或 UseFileAccessAccount。 |
LoadBalancingScheme |
可选 |
Microsoft.Office.Excel.Server.LoadBalancingScheme |
指定 Excel Services 应用程序 Web 服务应用程序 向运行 Excel Calculation Services 的不同后端计算机发送请求时所使用的负载平衡架构。默认值为 WorkbookURL。 键入的值必须为以下项之一:RoundRobin、Local 或 WorkbookURL。 |
MemoryCacheThreshold |
可选 |
System.Int32 |
指定可以分配给非活动对象的最大专用字节所占的百分比。如果超过内存缓存阈值,则将释放当前未使用的缓存对象。将该值设置为 0 将禁止缓存非活动对象。默认值为 90。 键入的值必须为 0 到 95 之间的整数。 |
PrivateBytesMax |
可选 |
System.Int32 |
指定 Excel Services 应用程序 使用的专用字节的最大数量(以 MB 为单位)。如果设置为 -1,则最大专用字节数默认为计算机上的物理内存的 50%。有效值包括 -1(无限制)以及任何正整数。默认值为 -1。 键入的值必须为 -1 或任何正整数。 |
SessionsPerUserMax |
可选 |
System.Int32 |
指定用户的最大允许会话数。如果达到此最大值,在启动新会话时,将会删除最旧的会话。有效值包括 -1(无限制)以及任何正整数。默认值为 25。 键入的值必须为 -1 或任何正整数。 |
SiteCollectionAnonymousSessionsMax |
可选 |
System.Int32 |
指定每个网站集允许的最大匿名会话数。值 0 指定不允许匿名会话。有效值包括 -1(无限制)、0(禁用此设置)或任何正整数。默认值为 25。 键入的值必须为 -1、0 或任何正整数。 |
TerminateProcessOnAccessViolation |
可选 |
System.Management.Automation.SwitchParameter |
在进程中出现访问冲突时终止 Excel Services 应用程序。 |
ThrottleAccessViolationsPerSiteCollection |
可选 |
System.Int32 |
指定如果工作簿在 Excel Services 应用程序 上导致出现访问冲突错误,则在指定的时间段(以秒为单位)内,将阻止加载源自该工作簿的网站集的所有文件。该网站集上的文件的现有会话不受影响。有效值包括 0(禁用该设置)以及介于 1 到 2073600 秒(24 天)之间的值。默认值为 0。 键入的值必须为 0 到 2073600 之间的整数。 |
UnattendedAccountApplicationId |
可选 |
System.String |
指定用于从 UnattendedAccountSecureServiceAppName 指定的安全存储服务查找无人参与的服务帐户凭据的应用程序 ID。如果设置了此参数并且发生了特定错误,则将联系安全存储服务。有效值为最多含 256 个字符的字母数字字符串。默认值为空字符串。 键入的值必须为有效的字母数字字符串;例如 UnattendedServiceAccountID。 备注 无人参与帐户是一个所有工作簿都可用其来刷新数据的帐户。当工作簿连接为身份验证指定 None 时,或使用任何非 Windows 凭据刷新数据时,需要使用无人参与帐户。 |
UnusedObjectAgeMax |
可选 |
System.Int32 |
指定会话中当前未使用的对象可以保留在内存缓存中的最长时间(以分钟为单位)。有效值包括 -1(无最大设置)以及介于 1 到 34560 分钟(24 天)之间的正整数。默认值为 -1。 键入的值必须为 -1 或介于 1 到 34560 之间的某个整数。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息,而不执行命令。有关详细信息,请键入以下命令:get-help about_commonparameters |
WorkbookCache |
可选 |
System.String |
指定用于存储 Excel Services 应用程序 使用的工作簿的缓存的本地文件系统位置。 如果没有指定任何值,则默认值是系统临时目录中的子目录。 键入的值必须为以下某种形式的有效路径: -- C:\folder_name -- \\server_name\folder_name |
WorkbookCacheSizeMax |
可选 |
System.Int32 |
指定各个会话允许的最大大小(以 MB 为单位)。默认值为 0。 键入的值必须为任何正整数。 |
输入类型
返回类型
Example
--------------示例 1--------------
New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"
此示例创建 Excel Services 应用程序 的新实例,其显示名称为 MyExcelService
。
--------------示例 2--------------
New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5
此示例创建 Excel Services 应用程序 的新示例,其显示名称为 My Excel Service
,并且仅允许每个用户在每台运行 Excel Services 应用程序 的后端应用程序服务器计算机上使用五个会话。