通过

New-SPExcelServiceApplication

  • 参考
模块:
SharePointServer
适用于:
SharePoint Server 2010, SharePoint Server 2013

创建 Excel Services 应用程序的新实例。

语法

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 cmdlet 使用新设置创建新的Excel Services应用程序 Web 服务应用程序。 创建新的Excel Services应用程序 Web 服务应用程序后，可以使用 Set-SPExcelServiceApplication cmdlet 修改新应用程序的全局设置。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息，请参阅 SharePoint Server cmdlet。

示例

------------------示例 1------------------

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

此示例使用显示名称 MyExcelService 创建 Excel Services Application 的新实例。

------------------示例 2------------------

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

本示例使用显示名称 My Excel Service 创建 Excel Services Application 的新实例，并且对于运行 Excel Services Application 的每个后端应用程序服务器计算机，每个用户只允许五个会话。

参数

-ApplicationPool

为新的 Excel Service 应用程序指定要在其中运行 Web 服务的现有 IIS 应用程序池。

键入的值必须为有效的 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 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。 如果未立即使用对象，或未通过使用 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 Services应用程序不再使用的文件可以保留在缓存中供以后使用。 如果命令中未指定该参数，则默认值为 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 域中的 Web 部件或页面可以请求和呈现受信任工作簿及数据连接文件。

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 Services应用程序服务器之间使用加密。 此设置的作用范围为逻辑服务器。 默认值为 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 Services检索文件的身份验证方法。 UseFileAccessAccount 指定所有工作簿始终使用运行 Excel Services Application 的服务帐户的凭据。 UseImpersonation 指定 Excel Services Application 以发出请求的用户身份检索工作簿文件。 默认值为 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 Services应用程序 Web 服务应用程序用来向运行 Excel Calculation Services 的不同后端计算机发送请求的负载均衡架构。 默认值为 WorkbookURL。

键入的值必须为以下项之一：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 Services 应用程序 Web 服务应用程序指定友好名称。 使用的名称必须是此场中Excel Services应用程序 Web 服务应用程序的唯一名称。 该名称最多可包含 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 Services Application 使用的最大专用字节（以兆字节为单位）。 如果设置为 -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 Services应用程序。

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 Services 应用程序上导致访问冲突错误，则会阻止来自该工作簿网站集的所有文件在指定时间段内加载， (以秒为单位) 。 该网站集上的文件的现有会话不受影响。 有效值包括 0（禁用该设置）以及介于 1 到 2073600 秒（24 天）之间的值。 默认值为 0。

键入的值必须为 0 到 2073600 之间的整数。

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 指定的 Secure Store Service 查找无人参与的服务帐户凭据的应用程序 ID。 如果设置了此参数并且发生了特定错误，则将联系 Secure Store Service。 有效值为最多含 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 到 34560 分钟（24 天）之间的正整数。 默认值为 -1。

键入的值必须为 -1 或介于 1 到 34560 之间的某个整数。

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 Services Application 使用的工作簿的缓存的本地文件系统位置。

如果没有指定任何值，则默认值是系统临时目录中的子目录。

键入的值必须为以下某种形式的有效路径：

-- 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

指定各个会话允许的最大大小（以 MB 为单位）。 默认值为 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