Set-SPExcelFileLocation

语法

Default （默认值）

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

说明

示例

示例 1

Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl

示例 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."

参数

-AbortOnRefreshOnOpenFail

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-Address

适用：SharePoint Server 2010、SharePoint Server 2013

System.String

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

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

参数属性

参数集

-AssignmentCollection

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-AutomaticVolatileFunctionCacheLifetime

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

0，始终计算

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

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

参数属性

参数集

-ChartAndImageSizeMax

适用：SharePoint Server 2010、SharePoint Server 2013

指定可以打开的图表或图像的最大大小（以 MB 为单位）。 默认值为 1。

键入的值必须为大于 0 的有效整数。

参数属性

参数集

-ChartRenderDurationMax

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-ConcurrentDataRequestsPerSessionMax

适用：SharePoint Server 2010、SharePoint Server 2013

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

键入的值必须是正整数。

参数属性

参数集

-Confirm

适用：SharePoint Server 2010、SharePoint Server 2013

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

参数属性

参数集

-DefaultWorkbookCalcMode

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-Description

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-DisplayGranularExtDataErrors

适用：SharePoint Server 2010、SharePoint Server 2013

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

参数属性

参数集

-ExcelServiceApplication

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-ExternalDataAllowed

适用：SharePoint Server 2010、SharePoint Server 2013

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

默认值为 None。

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

参数属性

参数集

-Identity

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-IncludeChildren

适用：SharePoint Server 2010、SharePoint Server 2013

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

参数属性

参数集

-LocationType

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-ManualExtDataCacheLifetime

适用：SharePoint Server 2010、SharePoint Server 2013

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

有效值包含:

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

1 到 2073600 缓存 1 秒到 24 天。

默认值为 300。

参数属性

参数集

-NewWorkbookSessionTimeout

适用：SharePoint Server 2010、SharePoint Server 2013

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

-1，会话永不过期

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

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

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

参数属性

参数集

-PeriodicExtDataCacheLifetime

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

默认值为 300。

参数属性

参数集

-RequestDurationMax

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

默认值为 300。

参数属性

参数集

-RESTExternalDataAllowed

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-SessionTimeout

适用：SharePoint Server 2010、SharePoint Server 2013

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

-1，会话永不过期

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

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

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

参数属性

参数集

-ShortSessionTimeout

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

-UdfsAllowed

适用：SharePoint Server 2010、SharePoint Server 2013

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

参数属性

参数集

-WarnOnDataRefresh

适用：SharePoint Server 2010、SharePoint Server 2013

指定在首次刷新工作簿数据时向用户显示警告。 默认值为 True。

参数属性

参数集

-WhatIf

适用：SharePoint Server 2010、SharePoint Server 2013

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

参数属性

参数集

-WorkbookSizeMax

适用：SharePoint Server 2010、SharePoint Server 2013

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

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

参数属性

参数集

CommonParameters