Add-ecsfiletrustedlocation：Stsadm 操作 (Office SharePoint Server)
操作名称：Add-ecsfiletrustedlocation
说明
允许管理员向受信任位置列表添加文件。
此操作与“位置”用户界面设置等效，该设置位于 SharePoint Shared Services 管理网站的“Excel Services 添加受信任文件位置”页上。
语法
stsadm -o add-ecsfiletrustedlocation
-ssp <SSP name>
-location {URL | UNC}
-LocationType {SharePoint |UNC |HTTP}
-IncludeChildren {True | False}
[-SessionTimeout <time in seconds>]
[-ShortSessionTimeout <time in seconds>]
[-MaxRequestDuration <time in seconds>]
[-MaxWorkbookSize <file size in MB>]
[-MaxChartSize <size in MB>]
[-VolatileFunctionCacheLifetime <time in seconds>]
[-DefaultWorkbookCalcMode {File | Manual | Auto | AutoDataTables}]
[-AllowExternalData {None | Dcl | DclAndEmbedded}]
[-WarnOnDataRefresh {True | False}]
[-StopOpenOnRefreshFailure {True | False}]
[-PeriodicCacheLifetime <time in seconds>]
[-ManualCacheLifetime <time in seconds>]
[-MaxConcurrentRequestsPerSession <number of requests>]
[-AllowUdfs {True | False}]
[-Description <descriptive text>]
参数
参数 |
值 |
是否必需 |
说明 |
ssp |
一个有效的 SSP 名称，例如“SharedServices1” |
是 |
为要配置的 Excel Calculation Services 提供资源的 SSP 的名称。 |
location |
受信任的文件夹的有效位置 有效值为：
最大长度为 1024 个字符。 |
是 |
这是受信任的目录的 URL。此参数的格式由特定位置的 locationtype 参数的值来确定。 |
locationtype |
下列受支持的类型之一：
|
是 |
指定位置类型。此参数的值决定着用于检索工作簿的身份验证方法。如果值是 SharePoint 或 HTTP，则 location 参数的值是有效的 URL。如果值是 UNC，则 location 参数的值是有效的 UNC。 此参数与 location 参数结合使用。 |
includechildren |
下列值之一：
|
是 |
True 表示子目录或子库受信任；False 表示它们不受信任。 |
sessionTimeout |
下列有效整数之一：
|
否 |
Excel Calculation Services 会话在过期之前保持打开且非活动状态的最长时间（秒）。该值从每个请求结束时开始算起。 |
shortSessionTimeout |
下列有效整数之一：
|
否 |
在发生任何用户交互之前，Excel Calculation Services 会话在关闭之前保持打开且非活动状态的最长时间（秒）。时间从最初打开的请求结束时开始算起。 |
maxRequestDuration |
下列有效整数之一：
|
否 |
会话中单个请求的最长持续时间（秒）。 |
maxWorkbookSize |
1 和 2000 之间的有效整数 |
否 |
Excel Calculation Services 可打开的工作簿的最大大小，以兆字节 (MB) 为单位。 |
maxChartSize |
1 和 2147483647 之间的有效整数 |
否 |
Excel Calculation Services 可打开的图表的最大大小 (MB)。 |
volatileFunctionCacheLifetime |
下列有效整数之一：
|
否 |
为便于自动重新计算，将可变函数计算值缓存的最长时间（秒）。 |
defaultWorkbookCalcMode |
下列值之一：
|
否 |
所有工作簿的计算模式。 |
allowExternalData |
下列值之一：
|
否 |
指定允许的外部数据连接类型。 |
warnOnDataRefresh |
下列值之一：
|
否 |
True：在刷新使用了用户的标识的外部数据源之前显示提示。 False：在刷新外部数据源之前不显示提示。 |
stopOpenOnRefreshFailure |
下列值之一：
|
否 |
True：停止打开工作簿。 此行为发生在以下情况下：工作簿包含“打开时刷新”数据连接，但打开时无法刷新工作簿，且用户对工作簿没有“打开项目”权限。 False：不停止打开工作簿。 有关工作簿的详细信息，请参阅 Excel Services 技术概述（该链接可能指向英文页面）(https://go.microsoft.com/fwlink/?linkid=110301&clcid=0x804)。 |
periodicCacheLifetime |
下列有效整数之一：
|
否 |
系统可以使用外部数据查询结果的最长时间（秒）。 |
manualCacheLifetime |
下列有效整数之一：
|
否 |
系统可以使用显式手动外部数据查询结果的最长时间（秒）。 |
maxConcurrentRequestsPerSession |
1 和 2147483647 之间的有效整数 |
否 |
每个会话所允许的最大并发外部数据查询数。 |
allowUdfs |
下列值之一：
|
否 |
True：表示可以从此受信任位置中的工作簿调用用户定义函数。 False：表示无法从此受信任位置中的工作簿调用用户定义函数。 |
description |
一个有效的字符串值，例如“这是受信任的位置” |
否 |
受信任位置的可选说明。 最大长度为 4096 个字符。 |
备注
受信任位置列表允许 Excel Calculation Services 仅从管理员认为安全的位置加载文件。此列表用于加载这两种文件：用户明确加载（在呈现器中浏览和显示）的文件，以及当 Excel Web Access Web 部件驻留在数字仪表板上时隐式加载的那些文件。
在检查某文件以查看它是否在受信任位置中时，仅应检查最初请求的文件或 URL。这可能不同于用户请求的文件或 URL，原因是在确定将加载的文件或 URL 之前可能有重定向操作。
受信任位置的列表存储在共享服务提供程序数据库中，并应用到逻辑服务器。