New-SPExcelDataConnectionLibrary

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

语法

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

说明

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

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

示例

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

$sa = Get-SPExcelServiceApplication
New-SPExcelDataConnectionLibrary -Address "https://portal/site/salesDCL" -Description "This is the DCL where all the connections to the sales data are stored." -ExcelServiceApplication $sa

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

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

参数

-Address

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

键入的值必须为有效的 URL,格式为 https://server_name。

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ExcelServiceApplication

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

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

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

-WhatIf

Displays a message that describes the effect of the command instead of executing the command. For more information, type the following command: get-help about_commonparameters

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

-工作分配

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

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

-描述

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

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

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