Set-SPExcelFileLocation
适用于： SharePoint Server 2010
上一次修改主题： 2015-03-09
为 Excel Services 应用程序 设置受信任文件位置的属性。
Syntax
Set-SPExcelFileLocation [-Identity] <SPExcelFileLocationPipeBind> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AbortOnRefreshOnOpenFail <SwitchParameter>] [-Address <String>] [-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>]
详细说明
Set-SPExcelFileLocation cmdlet 设置 Excel Services 应用程序 从中加载工作簿的位置的属性。Excel Services 应用程序 仅加载存储在受信任文件位置的工作簿。受信任文件位置的属性控制在 Excel Services 应用程序 中加载工作簿后这些工作簿的使用方式。Excel Services 应用程序 始终强制实施由从中加载工作簿的受信任文件位置定义的属性。受信任文件位置使用的属性是通过比较工作簿的文件路径和受信任文件位置的 Address 参数来确定的。
有关此 cmdlet 的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。
Parameters
| 参数 | 是否必需 | 类型 | 说明 |
|---|---|---|---|
Identity |
必需 |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelFileLocationPipeBind |
指定要更新的 FileLocation 对象。该名称在文件位置列表中必须唯一。 键入的值必须是 12345678-90ab-cdef-1234-567890bcdefgh 形式的有效 GUID；用于标识文件位置的 http://myPortal/myTeam 形式的有效字符串；用于标识路径的 C:\folder_name 形式的有效字符串或有效 SPExcelFileLocation 对象的实例。 |
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 应用程序 文件时自动数据刷新操作失败，该文件的加载会自动失败。仅当满足下列条件时，加载才会失败： -- 用户对 Excel Services 应用程序 文件具有 Windows SharePoint 只读权限。 -- 工作簿文件具有的数据连接在 Excel 文件打开时自动刷新。 |
Address |
可选 |
System.String 指定 Excel Services 应用程序 可从中加载工作簿的 Web 文件夹或文件目录。 键入的值必须为 http://myPortal/myTeam 形式的有效 URL；或 \\server_name\folder_name 形式的有效 UNC 路径 |
|
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 天 键入的值必须为整数 -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 设置以外的所有设置将替代工作簿设置。如果此参数发生更改，则当刷新 ConfigDB 属性缓存时，此参数会应用于 Excel Services 应用程序 上的所有新会话。默认设置为 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 |
位置的类型。LocationType 指示 Excel Services 应用程序 如何从在 Address 中指定的位置检索文件。默认值为 SharePoint。 键入的值必须为以下项之一：SharePoint、UNC 或 HTTP。 |
ManualExtDataCacheLifetime |
可选 |
System.Int32 |
指定 Excel Services 应用程序 在重新发出手动的（或用户启动的）外部数据请求前等待的时间（以秒为单位）。在此期间，可能会从外部数据缓存返回上一外部数据请求的结果。 有效值为： -1 第一次查询后从不刷新 1 到 2073600 缓存时间为 1 秒到 24 天。 默认值为 300。 |
NewWorkbookSessionTimeout |
可选 |
System.Int32 |
指定一个新的未保存的工作簿的会话在没有用户活动的情况下在 Excel Services 应用程序 上保持活动状态的时间（以秒为单位）。默认值为 1800。有效值包括： -1，会话永不过期 0，会话在单个请求结束时过期 1 到 2073600，保持活动状态的时间为 1 秒到 24 天。 键入的值必须为 -1、0 或介于 1 到 2073600 之间的某个整数。 |
PeriodicExtDataCacheLifetime |
可选 |
System.Int32 |
指定 Excel Services 应用程序 在重新发出 on-open 或 periodic（即，自动）外部数据请求之前等待的时间（以秒为单位）。在此期间，可能会从外部数据缓存返回上一外部数据请求的结果。值为 -1 指定首次查询后从不刷新。 键入的值必须为 -1、0 或介于 1 到 2073600 之间的某个整数。 默认值为 300。 |
RequestDurationMax |
可选 |
System.Int32 |
指定会话中单个请求的最长持续时间（以秒为单位）。此时间过后，该请求超时。 键入的值必须为 -1（无限制）或介于 1 到 2073600 之间的某个整数。 默认值为 300。 |
RESTExternalDataAllowed |
可选 |
System.Management.Automation.SwitchParameter |
指定是否允许来自具象状态传输 (REST) 应用程序编程接口 (API) 的请求刷新外部数据连接。 如果 External DataAllowed 参数设置为 None，则 RESTExternalDataAllowed 参数没有效果。 |
SessionTimeout |
可选 |
System.Int32 |
指定会话在没有用户活动的情况下在 Excel Services 应用程序 上保持活动状态的时间（以秒为单位）。默认设置为 300 秒。默认值为 300。有效值包括： -1，会话永不过期 0，会话在单个请求结束时过期 1 到 2073600，保持活动状态的时间为 1 秒到 24 天。 键入的值必须为 -1、0 或介于 1 到 2073600 之间的某个整数。 |
ShortSessionTimeout |
可选 |
System.Int32 |
指定用户必须与电子表格进行初始交互的时间（以秒为单位）。此时间过后，如果用户不活动，则会话关闭。该值必须始终小于 SessionTimeout。如果 ShortSessionTimeout 值大于或等于 SessionTimeout，则返回错误。默认值为 75。 键入的值必须为 -1 或介于 1 到 2073600 之间的某个整数。 |
UdfsAllowed |
可选 |
System.Management.Automation.SwitchParameter |
指定从 Address 指定的受信任文件位置加载的工作簿可以调用用户定义的函数。 |
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-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl
此示例获取名为 My Excel Service 的 Excel Services 应用程序 Web 服务应用程序 的每个受信任文件位置（该位置允许从工作簿文件加载数据连接），并指定这些位置必须使用数据连接库加载数据连接。
--------------示例 2--------------
Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "http://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services Application. It allows any file from anywhere in SharePoint to load."
此示例更改服务器场中每个 Excel Services 应用程序 Web 服务应用程序 的默认文件位置的说明。
See Also
Reference
Get-SPExcelFileLocation
New-SPExcelFileLocation
Remove-SPExcelFileLocation