New-SPExcelServiceApplication

模块:: SharePointServer module

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

语法

ExistingTargetApplicationParameterSet

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

NewTargetApplicationParameterSet

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 对象。

参数属性

类型:	SPIisWebServiceApplicationPoolPipeBind
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AssignmentCollection

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

使用全局参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

参数属性

类型:	SPAssignmentCollection
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CachingOfUnusedFilesEnable

指定Excel Services应用程序不再使用的文件可以保留在缓存中供以后使用。如果命令中未指定该参数，则默认值为 true。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

执行命令前，看到确认提示。有关详细信息，请键入以下命令：get-help about_commonparameters

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-CrossDomainAccessAllowed

指定驻留在其他 HTTP 域中的 Web 部件或页面可以请求和呈现受信任工作簿及数据连接文件。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Default

指定将此服务应用程序的代理添加到场的默认代理组中。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-EncryptedUserConnectionRequired

要求在最终用户和Excel Services应用程序服务器之间使用加密。此设置的作用范围为逻辑服务器。默认值为 None。

键入的值必须为以下项之一：None 或 Connection。

参数属性

类型:	EncryptedConnectionMode
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ExternalDataConnectionLifetime

指定外部数据连接可在连接池中保持打开状态的最大秒数。有效值包括：

-1 从不回收

1 到 2073600 保持活动状态 1 秒到 24 天。

默认值为 1800。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-FileAccessMethod

指定应用程序Excel Services检索文件的身份验证方法。 UseFileAccessAccount 指定所有工作簿始终使用运行 Excel Services Application 的服务帐户的凭据。 UseImpersonation 指定 Excel Services Application 以发出请求的用户身份检索工作簿文件。默认值为 UseImpersonation。

键入的值必须为以下项之一：UseImpersonation 或 UseFileAccessAccount。

参数属性

类型:	FileAccessMethod
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-LoadBalancingScheme

指定Excel Services应用程序 Web 服务应用程序用来向运行 Excel Calculation Services 的不同后端计算机发送请求的负载均衡架构。默认值为 WorkbookURL。

键入的值必须为以下项之一：RoundRobin、Local 或 WorkbookURL。

参数属性

类型:	LoadBalancingScheme
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-MemoryCacheThreshold

指定可以分配给非活动对象的最大专用字节所占的百分比。如果超过内存缓存阈值，则将释放当前未使用的缓存对象。将该值设置为 0 将禁止缓存非活动对象。默认值为 90。

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

为新的 Excel Services 应用程序 Web 服务应用程序指定友好名称。使用的名称必须是此场中Excel Services应用程序 Web 服务应用程序的唯一名称。该名称最多可包含 128 个字符。默认值为 Service_numofapplications+1。

键入的值必须是有效字符串；例如，MyExcelServiceApp1。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PrivateBytesMax

指定 Excel Services Application 使用的最大专用字节（以兆字节为单位）。如果设置为 -1，则最大专用字节数默认为计算机上的物理内存的 50%。有效值包括 -1（无限制）以及任何正整数。默认值为 -1。

键入的值必须为 -1 或任何正整数。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SessionsPerUserMax

指定用户的最大允许会话数。如果达到此最大值，在启动新会话时，将会删除最旧的会话。有效值包括 -1（无限制）以及任何正整数。默认值为 25。

键入的值必须为 -1 或任何正整数。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SiteCollectionAnonymousSessionsMax

指定每个网站集允许的最大匿名会话数。值 0 指定不允许匿名会话。有效值包括 -1（无限制）、0（禁用此设置）或任何正整数。默认值为 25。

键入的值必须为 -1、0 或任何正整数。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-TerminateProcessOnAccessViolation

当进程中发生访问冲突时，终止Excel Services应用程序。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ThrottleAccessViolationsPerSiteCollection

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

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UnattendedAccountApplicationId

指定用于从 UnattendedAccountSecureServiceAppName 指定的 Secure Store Service 查找无人参与的服务帐户凭据的应用程序 ID。如果设置了此参数并且发生了特定错误，则将联系 Secure Store Service。有效值为最多含 256 个字符的字母数字字符串。默认值为空字符串。

键入的值必须为有效的字母数字字符串；例如 UnattendedServiceAccountID。

无人参与帐户是一个所有工作簿都可用其来刷新数据的帐户。当工作簿连接为身份验证指定 None 时，或使用任何非 Windows 凭据刷新数据时，需要使用无人参与帐户。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ExistingTargetApplicationParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UnattendedServiceAccount

参数属性

类型:	PSCredential
默认值:	None
支持通配符:	False
不显示:	False

参数集

NewTargetApplicationParameterSet

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UnusedObjectAgeMax

指定会话中当前未使用的对象可以保留在内存缓存中的最长时间（以分钟为单位）。有效值包括 -1（无最大设置）以及介于 1 到 34560 分钟（24 天）之间的正整数。默认值为 -1。

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UseEffectiveUserName

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WorkbookCache

指定用于存储 Excel Services Application 使用的工作簿的缓存的本地文件系统位置。

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

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

-- C：\folder_name -- \\server_name\folder_name

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WorkbookCacheSizeMax

指定各个会话允许的最大大小（以 MB 为单位）。默认值为 0。

键入的值必须为任何正整数。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WorkbookModelUsageTracker

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

反馈

此页面是否有帮助？