Set-SPExcelDataConnectionLibrary

 

適用版本:SharePoint Server 2013 Enterprise

上次修改主題的時間:2015-03-09

設定 Excel Services 應用程式 之資料連線庫的屬性。

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

Set-SPExcelDataConnectionLibrary Cmdlet 會設定程式庫的屬性,Excel Services 應用程式 會從中載入資料連線檔案。資料連線檔案必須儲存在信任之資料連線庫清單中的資料連線庫,Excel Services 應用程式 才會載入該資料連線檔案。資料連線庫是一種包含資料連線檔案的清單。這些檔案包含 Excel Services 應用程式 與 Excel 用戶端在連線到外部資料來源時,所需的一切內容。資料連線庫可讓您重複使用和共用資料連線。資料連線可藉由使用活頁簿檔案的資訊來載入。不過使用資料連線庫載入資料連線時,會為資料連線提供另一個階層,以便與活頁簿分開管理這些資料連線。

SharePoint 管理命令介面

 

參數 必要 類型 說明

Identity

必要

Microsoft.Office.Excel.Server.Cmdlet.SPExcelDCLPipeBind

這會指定要更新的 DataConnectionLibrary 物件。

其類型必須為有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh;資料連線庫 (例如,DataConnectionLib1) 的有效名稱;有效的 URL,且格式為 http://server_name;或是有效之 SPExcelDCL 物件的執行個體。

ExcelServiceApplication

必要

Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind

這會指定包含 SPExcelDataConnectionLibrary 清單物件的 Excel Services 應用程式 Web 服務應用程式。

其類型必須為有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh;在伺服器陣列 (例如,MyExcelService1) 中,Excel Services 應用程式 Web 服務應用程式 的有效名稱;或是有效之 SPExcelServiceApplication 物件的執行個體。

Address

選用

System.String

這會指定資料連線庫的位址。在信任的資料連線庫清單中的位址必須是唯一的。

此類型必須是格式為 http://server_name 的有效 URL。

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

這會指定資料連線庫的易懂說明。

其類型必須為有效的字串;例如,「這是儲存所有銷售資料連線的資料連線庫」。

WhatIf

選用

System.Management.Automation.SwitchParameter

顯示訊息描述命令效果,而非描述命令執行的效果。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

--------------範例 1--------------

Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "http://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Description "This is the DCL where all the connections to the sales data are stored

此範例會為信任之資料連線庫清單 (DCL) 中的項目 http://portal/site/salesDCL 設定顯示說明,該資料連線庫清單位於名為 MyExcelService 的 Excel Services 應用程式 Web 服務應用程式 中。

--------------範例 2--------------

Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataConnectionLibrary | where {$_.address -eq "http://portal/site/salesDCL" } | Set-SPExcelDataConnectionLibrary -Address "http://portal/site/salesDCL

此範例會在信任的資料連線庫清單中,將項目 http://portal/test/site/salesDCL 的資料連線庫位址更新成 http://portal/site/salesDCL,該資料連線庫位於名為 MyExcelService 的 Excel Services 應用程式 Web 服務應用程式 中。

顯示: