New-SPExcelFileLocation
适用于： SharePoint Server 2010
上一次修改主题： 2015-03-09
向 Excel Services 应用程序 添加新的受信任位置。
Syntax
New-SPExcelFileLocation -Address <String> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AbortOnRefreshOnOpenFail <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-AutomaticVolatileFunctionCacheLifetime <Int32>] [-ChartAndImageSizeMax <Int32>] [-ChartRenderDurationMax <Int32>] [-ConcurrentDataRequestsPerSessionMax <Int32>] [-Confirm [<SwitchParameter>]] [-DefaultWorkbookCalcMode <File | Manual | Auto | AutoDataTables>] [-Description <String>] [-DisplayGranularExtDataErrors <SwitchParameter>] [-ExternalDataAllowed <None | Dcl | DclAndEmbedded>] [-IncludeChildren <SwitchParameter>] [-LocationType <SharePoint | Unc | Http>] [-ManualExtDataCacheLifetime <Int32>] [-NewWorkbookSessionTimeout <Int32>] [-PeriodicExtDataCacheLifetime <Int32>] [-RequestDurationMax <Int32>] [-RESTExternalDataAllowed <SwitchParameter>] [-SessionTimeout <Int32>] [-ShortSessionTimeout <Int32>] [-UdfsAllowed <SwitchParameter>] [-WarnOnDataRefresh <SwitchParameter>] [-WhatIf [<SwitchParameter>]] [-WorkbookSizeMax <Int32>]
详细说明
New-SPExcelFileLocation cmdlet 向 Excel Services 应用程序 Web 服务应用程序 中的受信任文件位置列表中添加新位置。Excel Services 应用程序 仅加载存储在受信任文件位置的工作簿。受信任文件位置的属性控制在 Excel Services 应用程序 中加载工作簿后这些工作簿的使用方式。Excel Services 应用程序 始终强制实施由从中加载工作簿的受信任文件位置定义的属性。受信任文件位置所用的属性是通过将工作簿的文件路径与受信任文件位置的 Address 参数进行比较来确定的。
最长的匹配项优先。例如，如果 http://portal/site/ 和 http://portal/site/subsite 是受信任位置，并且您从子网站加载工作簿，则应用程序使用子网站受信任位置的属性，因为该位置拥有最长的匹配地址。
有关此 cmdlet 的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 参数 | 是否必需 | 类型 | 说明 |
|---|---|---|---|
Address |
必需 |
System.String |
指定 Excel Services 应用程序 可从中加载工作簿的 Web 文件夹或文件目录。 键入的值必须为 http://myPortal/myTeam 形式的有效 URL；或 \\server_name\folder_name 形式的有效 UNC 路径 |
ExcelServiceApplication |
必需 |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind |
指定包含 SPExcelFileLocation 列表对象的 Excel Services 应用程序 Web 服务应用程序。 键入的值必须是 12345678-90ab-cdef-1234-567890bcdefgh 形式的有效 GUID；服务器场中 Excel Services 应用程序 Web 服务应用程序 的有效名称（例如 MyExcelService1）；或有效 SPExcelServiceApplication 对象的实例。 |
AbortOnRefreshOnOpenFail |
可选 |
System.Management.Automation.SwitchParameter |
指定如果打开 Excel Services 应用程序 文件时自动数据刷新操作失败，该文件的加载会自动失败。仅当满足下列条件时，加载才会失败： - 用户对该文件拥有 SharePoint 产品和技术只读权限。 - 工作簿文件拥有在打开 Excel Services 应用程序 文件时自动刷新的数据连接。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 备注 在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。 |
AutomaticVolatileFunctionCacheLifetime |
可选 |
System.Int32 |
指定缓存可变函数的计算值以进行自动重新计算的最长时间（以秒为单位）。有效值包括： -1 在工作簿加载时计算一次。 0 始终计算。 1 到 2073600 缓存时间为 1 秒到 24 天。默认整数值为 300。 键入的值必须为整数 -1 或 0，或介于 1 到 2073600 之间的某个整数值。 |
ChartAndImageSizeMax |
可选 |
System.Int32 |
指定可以打开的图表或图像的最大大小（以 MB 为单位）。默认值为 1。 键入的值必须为大于 0 的有效整数。 |
ConcurrentDataRequestsPerSessionMax |
可选 |
System.Int32 |
指定每个会话中允许的并发外部数据请求的最大数目。如果会话必须发出多于此数目的请求，则附加请求必须进入队列。此设置的作用范围为逻辑服务器。默认值为 5。 键入的值必须为正整数。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters |
DefaultWorkbookCalcMode |
可选 |
Microsoft.Office.Excel.Server.DefaultWorkbookCalcMode |
指定工作簿的计算模式。除 File 以外的设置将会重写工作簿设置。默认设置为 File。 键入的值必须为以下项之一：File、Manual、Auto 或 AutoDataTables。 |
Description |
可选 |
System.String |
指定新文件位置的友好说明。 键入的值必须为有效字符串；例如：this is the file location of the monthly sales reports。 |
DisplayGranularExtDataErrors |
可选 |
System.Management.Automation.SwitchParameter |
显示此位置中文件的外部数据故障的具体错误消息。 |
ExternalDataAllowed |
可选 |
Microsoft.Office.Excel.Server.AllowExternalData |
指定允许工作簿使用的外部数据访问类型。None 指定数据刷新处于禁用状态。Dcl 指定仅当数据使用受信任数据连接库中的连接文件时才刷新该数据。DclandEmbedded 指定可以使用数据连接库，但并非必须这样做。此设置的作用域为受信任位置。默认值为 None。 键入的值必须为以下设置之一： None Dcl DclAndEmbedded |
IncludeChildren |
可选 |
System.Management.Automation.SwitchParameter |
指示信任次级 URL、目录和库。例如，如果受信任文件位置为 http://portal，并且 IncludeChildren 为 true，则 http://portal/subSite 也受信任，就像是 Address 中指定的 URL 的任何次级 URL 一样。 |
LocationType |
可选 |
Microsoft.Office.Excel.Server.LocationType |
指定位置的类型。位置类型指示 Excel Services 应用程序 从 Address 中指定的位置检索文件的方式。默认设置是 SharePoint 类型。默认值为 SharePoint。 键入的值必须为以下项之一：SharePoint、UNC 或 HTTP。 |
ManualExtDataCacheLifetime |
可选 |
System.Int32 |
指定 Excel Services 应用程序 在重新发出手动的（或用户启动的）外部数据请求之前等待的时间（以秒为单位）。在此期间，可能会从外部数据缓存返回上一外部数据请求的结果。默认值为 300。 有效值为以下任一项： -1 第一次查询后从不刷新。 1 到 2073600 - 缓存时间为 1 秒到 24 天。 |
NewWorkbookSessionTimeout |
可选 |
System.Int32 |
指定新的未保存的工作簿的会话在没有用户活动的情况下在 Excel Services 应用程序 上保持活动状态的时间（以秒为单位）。有效值包括： -1 会话永不过期。 0 会话在单个请求结束时过期。 1 到 2073600 保持活动状态的时间为 1 秒到 24 天。默认值为 1800。 键入的值必须为 -1、0 或介于 1 到 2073600 之间的某个整数。 |
PeriodicExtDataCacheLifetime |
可选 |
System.Int32 |
指定 Excel Services 应用程序 在重新发出 on-open 或 periodic（即，自动）外部数据请求之前等待的时间（以秒为单位）。在此期间，可能会从外部数据缓存返回上一外部数据请求的结果。值为 -1 指定在首次查询后从不刷新。默认值为 300。 键入的值必须为 -1、0 或介于 1 到 2073600 之间的某个整数。 |
RequestDurationMax |
可选 |
System.Int32 |
指定会话中单个请求的最长持续时间（以秒为单位）。此时间过后，请求超时。默认值为 300。 键入的值必须为 -1（无限制）或介于 1 到 2073600 之间的某个整数。 |
RESTExternalDataAllowed |
可选 |
System.Management.Automation.SwitchParameter |
指定是否允许来自具象状态传输 (REST) 应用程序编程接口 (API) 的请求刷新外部数据连接。如果 ExternalDataAllowed 参数设置为 None，则 RESTExternalDataAllowed 参数无效。 |
SessionTimeout |
可选 |
System.Int32 |
指定会话在没有用户活动的情况下在 Excel Services 应用程序 上保持活动状态的时间（以秒为单位）。有效值包括： -1 会话永不过期。 0 会话在单个请求结束时过期。 1 到 2073600 保持活动状态的时间为 1 秒到 24 天。默认值为 300。 键入的值必须为 -1、0 或介于 1 到 2073600 之间的某个整数。 |
ShortSessionTimeout |
可选 |
System.Int32 |
指定用户必须与电子表格进行初始交互的时间（以秒为单位）。该时间过后，如果用户不活动，则会话关闭。该值必须始终小于 SessionTimeout。如果 ShortSessionTimeout 值大于或等于 SessionTimeout，则返回错误。默认值为 75。 键入的值必须为 -1 或介于 1 到 2073600 之间的某个整数。 |
UdfsAllowed |
可选 |
System.Management.Automation.SwitchParameter |
指定可由从 Address 中指定的受信任文件位置加载的工作簿调用用户定义的函数。 默认值为 False。 |
WarnOnDataRefresh |
可选 |
System.Management.Automation.SwitchParameter |
指定在首次刷新工作簿数据时向用户显示警告。默认值为 True。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
WorkbookSizeMax |
可选 |
System.Int32 |
指定可以加载的工作簿的最大大小（以 MB 为单位）。默认值为 10。 键入的值必须为 1 到 2000 之间的整数。 |
输入类型
返回类型
Example
--------------示例 1--------------
Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "http://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false
此示例向位于名为 MyExcelService 的 Excel Services 应用程序 Web 服务应用程序 中的受信任文件位置列表中添加新的受信任文件位置。
此示例支持工作簿从任何以 http://myPortal/myTeam 开头的子级或子文件夹加载。从此位置加载的所有工作簿都必须小于 50 MB。工作簿可以使用嵌入在工作簿文件中或存储在数据连接库中的连接刷新外部数据。将不会显示指出工作簿尝试刷新外部数据的警告消息。
--------------示例 2--------------
Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address http://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."
此示例向位于名为 MyExcelService 的 Excel Services 应用程序 Web 服务应用程序 中的受信任文件位置列表中添加具有给定地址和说明的新受信任文件位置。
See Also
Reference
Get-SPExcelFileLocation
Remove-SPExcelFileLocation
Set-SPExcelFileLocation