Set-SPExcelFileLocation

参考

模块:: SharePointServer

适用于:: SharePoint Server 2010, SharePoint Server 2013

为 Excel Services 应用程序设置受信任文件位置的属性。

语法

Set-SPExcelFileLocation
   [-Identity] <SPExcelFileLocationPipeBind>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-AbortOnRefreshOnOpenFail]
   [-Address <String>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AutomaticVolatileFunctionCacheLifetime <Int32>]
   [-ChartAndImageSizeMax <Int32>]
   [-ConcurrentDataRequestsPerSessionMax <Int32>]
   [-Confirm]
   [-DefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
   [-Description <String>]
   [-DisplayGranularExtDataErrors]
   [-ExternalDataAllowed <AllowExternalData>]
   [-IncludeChildren]
   [-LocationType <LocationType>]
   [-ManualExtDataCacheLifetime <Int32>]
   [-NewWorkbookSessionTimeout <Int32>]
   [-PeriodicExtDataCacheLifetime <Int32>]
   [-RequestDurationMax <Int32>]
   [-RESTExternalDataAllowed]
   [-SessionTimeout <Int32>]
   [-ShortSessionTimeout <Int32>]
   [-UdfsAllowed]
   [-WarnOnDataRefresh]
   [-WhatIf]
   [-WorkbookSizeMax <Int32>]
   [-ChartRenderDurationMax <Int32>]
   [<CommonParameters>]

说明

cmdlet Set-SPExcelFileLocation 设置应用程序从中加载工作簿的位置Excel Services的属性。 Excel Services应用程序仅加载存储在受信任文件位置的工作簿。受信任文件位置的属性控制在应用程序Excel Services加载工作簿时如何使用它们。 Excel Services Application 始终强制实施从中加载工作簿的受信任文件位置定义的属性。受信任文件位置使用的属性是通过比较工作簿的文件路径和受信任文件位置的 Address 参数来确定的。

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

示例

--------------示例 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 "https://"} | 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 服务应用程序的默认文件位置的说明。

参数

-AbortOnRefreshOnOpenFail

指定在打开文件时，如果自动数据刷新操作失败，Excel Services应用程序文件的加载会自动失败。仅当满足下列条件时，加载才会失败：

-- 用户对 Excel Services 应用程序文件具有只读权限。 -- 工作簿文件具有的数据连接在 Excel 文件打开时自动刷新。

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

-Address

System.String

指定应用程序可从Excel Services加载工作簿的 Web 文件夹或文件目录。

该类型必须是格式 https://myPortal/myTeam的有效 URL，或者格式为 \\server_name\folder_name 的有效 UNC 路径

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

-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

-AutomaticVolatileFunctionCacheLifetime

指定缓存可变函数的计算值以进行自动重新计算的最长时间（以秒为单位）。有效值包括：

-1，在工作簿加载时计算一次

0，始终计算

1 到 2073600，缓存时间为 1 秒至 24 天

键入的值必须为整数 -1 或 0，或介于 1 到 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

-ChartAndImageSizeMax

指定可以打开的图表或图像的最大大小（以 MB 为单位）。默认值为 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

-ChartRenderDurationMax

呈现任何单个图表) 最长 (时间（秒）。

有效值：-1 (无限制) ;从 1 到 2073600 (24 天) 。

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

-ConcurrentDataRequestsPerSessionMax

指定每个会话中允许的并发外部数据请求的最大数目。如果会话必须发出多于此数目的请求，则附加请求必须进入队列。此设置的作用范围为逻辑服务器。默认值为 5。

键入的值必须是正整数。

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

-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

-DefaultWorkbookCalcMode

指定工作簿的计算模式。除 File 设置以外的所有设置将替代工作簿设置。如果此参数已更改，则刷新 ConfigDB 属性缓存时，它将应用于 Excel Services 应用程序上的所有新会话。默认设置为 File。

键入的值必须为以下项之一：File、Manual、Auto 或 AutoDataTables。

Type:	DefaultWorkbookCalcMode
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-Description

指定新文件位置的友好说明。

键入的值必须为有效字符串；例如：this is the file location of the monthly sales reports。

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

-DisplayGranularExtDataErrors

显示此位置中文件的外部数据故障的具体错误消息。

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

-ExcelServiceApplication

指定包含 SPExcelFileLocation 列表对象的Excel Services应用程序 Web 服务应用程序。

类型必须是有效的 GUID，格式为 12345678-90ab-cdef-1234-567890bcdefgh;场中Excel Services应用程序 Web 服务应用程序的有效名称 (例如 MyExcelService1) ;或有效 SPExcelServiceApplication 对象的实例。

Type:	SPExcelServiceApplicationPipeBind
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-ExternalDataAllowed

指定工作簿允许的外部数据访问类型：None 指定禁用数据刷新。 Dcl 指定仅当数据使用受信任数据连接库中的连接文件时才刷新该数据。 DclandEmbedded 指定可以使用数据连接库，但并非必须这样做。此设置的作用域为受信任位置。

默认值为 None。

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

Type:	AllowExternalData
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-Identity

指定要更新的 FileLocation 对象。该名称在文件位置列表中必须唯一。

类型必须是有效的 GUID，格式为 12345678-90ab-cdef-1234-567890bcdefgh;标识文件位置的有效字符串，格式 https://myPortal/myTeam为 ;标识路径的有效字符串，格式为 C：\folder_name;或有效的 SPExcelFileLocation 对象的实例。

Type:	SPExcelFileLocationPipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-IncludeChildren

指示信任次级 URL、目录和库。例如，如果受信任的文件位置为 https://portal，而 IncludeChildren 为 true，则 https://portal/subSite 也受信任，就像地址中指定的 URL 下的任何 subURL 一样。

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

-LocationType

位置的类型。 LocationType 指示Excel Services应用程序如何从地址中指定的位置检索文件。默认值为 SharePoint。

键入的值必须为以下项之一：SharePoint、UNC 或 HTTP。

Type:	LocationType
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2010, SharePoint Server 2013

-ManualExtDataCacheLifetime

指定Excel Services应用程序在重新发出手动或用户发起的外部数据请求之前等待的时间（以秒为单位）。在此期间，可能会从外部数据缓存返回上一外部数据请求的结果。

有效值包含:

-1 从不在第一个查询后刷新

1 到 2073600 缓存 1 秒到 24 天。

默认值为 300。

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

-NewWorkbookSessionTimeout

指定未保存的新工作簿的会话将在没有用户活动的Excel Services应用程序上保持活动的时间（以秒为单位）。默认值为 1800。有效值包括：

-1，会话永不过期

0，会话在单个请求结束时过期

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

键入的值必须为 -1、0 或介于 1 到 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

-PeriodicExtDataCacheLifetime

指定 Excel Services应用程序在重新发出打开或定期 (（即自动) 外部数据请求）之前等待的时间（以秒为单位）。在此期间，可能会从外部数据缓存返回上一外部数据请求的结果。值为 -1 指定首次查询后从不刷新。

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

默认值为 300。

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

-RequestDurationMax

指定会话中单个请求的最长持续时间（以秒为单位）。此时间过后，该请求超时。

键入的值必须为 -1（无限制）或介于 1 到 2073600 之间的某个整数。

默认值为 300。

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

-RESTExternalDataAllowed

指定是否允许来自具象状态传输 (REST) 应用程序编程接口 (API) 的请求刷新外部数据连接。

如果 External DataAllowed 参数设置为 None，RESTExternalDataAllowed 参数将不起作用。

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

-SessionTimeout

指定会话在应用程序上保持活动状态的时间（以秒为单位），Excel Services应用程序中没有用户活动。默认值为 300 秒。默认值为 300。有效值包括：

-1，会话永不过期

0，会话在单个请求结束时过期

1 到 2073600，保持活动状态的时间为 1 秒到 24 天。

键入的值必须为 -1、0 或介于 1 到 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

-ShortSessionTimeout

指定用户必须与电子表格进行初始交互的时间（以秒为单位）。此时间过后，如果用户不活动，则会话关闭。该值必须始终小于 SessionTimeout。如果 ShortSessionTimeout 值大于或等于 SessionTimeout，则返回错误。默认值为 75。

键入的值必须为 -1 或介于 1 到 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

-UdfsAllowed

指定从 Address 指定的受信任文件位置加载的工作簿可以调用用户定义的函数。

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

-WarnOnDataRefresh

指定在首次刷新工作簿数据时向用户显示警告。默认值为 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

-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

-WorkbookSizeMax

指定可以加载的工作簿的最大大小（以 MB 为单位）。默认值为 10。

键入的值必须为 1 到 2000 之间的整数。

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

通过

Set-SPExcelFileLocation

语法

说明

示例

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

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

参数

-AbortOnRefreshOnOpenFail

-Address

-AssignmentCollection

-AutomaticVolatileFunctionCacheLifetime

-ChartAndImageSizeMax

-ChartRenderDurationMax

-ConcurrentDataRequestsPerSessionMax

-Confirm

-DefaultWorkbookCalcMode

-Description

-DisplayGranularExtDataErrors

-ExcelServiceApplication

-ExternalDataAllowed

-Identity

-IncludeChildren

-LocationType

-ManualExtDataCacheLifetime

-NewWorkbookSessionTimeout

-PeriodicExtDataCacheLifetime

-RequestDurationMax

-RESTExternalDataAllowed

-SessionTimeout

-ShortSessionTimeout

-UdfsAllowed

-WarnOnDataRefresh

-WhatIf

-WorkbookSizeMax

反馈

其他资源