New-SPExcelFileLocation

模块:: SharePointServer module

向 Excel Services 应用程序中添加新的受信任位置。

语法

Default （默认值）

New-SPExcelFileLocation
    -Address <String>
    -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
    [-AbortOnRefreshOnOpenFail]
    [-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 将New-SPExcelFileLocation新位置添加到Excel Services应用程序 Web 服务应用程序中的受信任文件位置列表中。 Excel Services应用程序仅加载存储在受信任文件位置的工作簿。受信任文件位置的属性控制在应用程序Excel Services加载工作簿时如何使用工作簿。 Excel Services应用程序始终强制实施从中加载工作簿的受信任文件位置定义的属性。受信任文件位置所用的属性是通过将工作簿的文件路径与受信任文件位置的 Address 参数进行比较来确定的。

最长的匹配项优先。例如，如果 https://portal/site/ 和 https://portal/site/subsite 是受信任位置，并且您从子网站加载工作簿，则应用程序将使用子网站受信任位置的属性，因为它具有最长的匹配地址。

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

示例

示例 1

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

本示例将新的受信任文件位置添加到名为 MyExcelService 的 Excel Services 应用程序 Web 服务应用程序中的受信任文件位置列表中。

此示例使工作簿能够从以开头的任何子文件夹或子文件夹加载 https://myPortal/myTeam. 从此位置加载的所有工作簿都必须小于 50 MB。工作簿可以使用嵌入在工作簿文件中或存储在数据连接库中的连接刷新外部数据。将不会显示指出工作簿尝试刷新外部数据的警告消息。

示例 2

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."

本示例将新的受信任文件位置添加到位于名为 MyExcelService 的 Excel Services Application Web 服务应用程序中的受信任文件位置列表中，其中包含给定的地址和说明。

参数

-AbortOnRefreshOnOpenFail

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

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Address

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AssignmentCollection

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

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

参数属性

类型:	SPAssignmentCollection
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AutomaticVolatileFunctionCacheLifetime

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

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

0 始终计算。

1 到 2073600 缓存 1 秒到 24 天。默认整数值为 300。

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ChartAndImageSizeMax

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

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ChartRenderDurationMax

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConcurrentDataRequestsPerSessionMax

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

键入的值必须是正整数。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultWorkbookCalcMode

指定工作簿的计算模式。除 File 以外的设置将会重写工作簿设置。默认设置为 File。

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

参数属性

类型:	DefaultWorkbookCalcMode
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Description

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

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DisplayGranularExtDataErrors

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ExcelServiceApplication

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

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

参数属性

类型:	SPExcelServiceApplicationPipeBind
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	True
来自剩余参数的值:	False

-ExternalDataAllowed

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

键入的值必须为以下设置之一：

None

Dcl

DclAndEmbedded

参数属性

类型:	AllowExternalData
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-IncludeChildren

指示信任次级 URL、目录和库。例如，如果受信任的文件位置为 https://portal ，而 IncludeChildren 为 true， https://portal/subSite 则也受信任，而从属于地址中指定的 URL 的任何 URL 也是如此。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-LocationType

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

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

参数属性

类型:	LocationType
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ManualExtDataCacheLifetime

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

有效值为以下任一项：

-1 第一次查询后从不刷新。1 到 2073600 - 缓存时间为 1 秒到 24 天。

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-NewWorkbookSessionTimeout

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

-1 会话永不过期。

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

1 到 2073600 保持活动状态 1 秒到 24 天。默认值为 1800。

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PeriodicExtDataCacheLifetime

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

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RequestDurationMax

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

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-RESTExternalDataAllowed

指定是否允许来自具象状态传输 (REST) 应用程序编程接口 (API) 的请求刷新外部数据连接。如果 ExternalDataAllowed 参数设置为 None，则 RESTExternalDataAllowed 参数无效。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-SessionTimeout

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

-1 会话永不过期。

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

1 到 2073600 保持活动状态 1 秒到 24 天。默认值为 300。

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ShortSessionTimeout

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

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UdfsAllowed

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

默认值为 False。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WarnOnDataRefresh

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WorkbookSizeMax

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

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

参数属性

类型:	Int32
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

反馈

此页面是否有帮助？