New-SPExcelDataConnectionLibrary

 

适用于: SharePoint Server 2010

上一次修改主题: 2015-03-09

向 Excel Services 应用程序 添加新数据连接库。

Syntax

New-SPExcelDataConnectionLibrary -Address <String> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-WhatIf [<SwitchParameter>]]

详细说明

New-SPExcelDataConnectionLibrary cmdlet 向 Excel Services 应用程序 Web 服务应用程序 的受信任的数据连接库列表中添加数据连接库。Excel Services 应用程序 仅加载位于受信任的数据连接库列表中的数据连接库中所存储的数据连接文件。数据连接库包含数据连接文件,这些文件包含 Excel Services 应用程序 和 Excel 客户端连接到外部数据源所需的全部资源。利用数据连接库,您可以重用和共享数据连接。可以使用工作簿文件中的信息加载数据连接;不过,如果使用数据连接库加载数据连接,则可以将数据连接与工作簿分开管理。

有关此 cmdlet 的权限和最新信息,请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

参数 是否必需 类型 说明

Address

必需

System.String

指定数据连接库的地址。该地址在受信任的数据连接库列表中必须唯一。

键入的值必须为 http://server_name 形式的有效 URL。

ExcelServiceApplication

必需

Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind

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

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

AssignmentCollection

可选

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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

备注

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

Confirm

可选

System.Management.Automation.SwitchParameter

在执行命令之前提示您确认。有关详细信息,请键入以下命令:get-help about_commonparameters

Description

可选

System.String

指定数据连接库的友好说明。

键入的值必须是有效的字符串;例如,“这是自定义的 OLEDB 提供程序”。

WhatIf

可选

System.Management.Automation.SwitchParameter

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

输入类型

返回类型

Example

--------------示例----------------

Get-SPExcelServiceApplication -Identity "MyExcelService" | New-SPExcelDataConnectionLibrary -address "http://portal/site/salesDCL" -description "This is the DCL where all the connections to the sales data are stored."

此示例添加新的数据连接库 (DCL),然后将其说明设置为位于名为 MyExcelService 的 Excel Services 应用程序 Web 服务应用程序 中的受信任数据连接库列表。

工作簿可以使用存储在该库中的连接文件刷新 Excel Services 应用程序 Web 服务应用程序 中的数据。

See Also

Reference

Get-SPExcelDataConnectionLibrary
Remove-SPExcelDataConnectionLibrary
Set-SPExcelDataConnectionLibrary