Remove-SPExcelDataProvider

 

適用版本:SharePoint Server 2013 Enterprise

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

從 Excel Services 應用程式 移除資料提供者。

Remove-SPExcelDataProvider [-Identity] <SPExcelDataProviderPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Remove-SPExcelDataProvider Cmdlet 會移除存放在安全資料提供者清單中的資料提供者。只有當連線的資料提供者位於安全資料提供者清單中時,Excel Services 應用程式 才會重新整理外部資料連線。Excel Services 應用程式 包括此清單中的一組常用資料提供者,因此使用 Cmdlet 來修改安全資料提供者通常只會在自訂的資料連線方案中進行。

SharePoint 管理命令介面

 

參數 必要 類型 說明

Identity

必要

Microsoft.Office.Excel.Server.Cmdlet.SPExcelDataProviderPipeBind

這會指定要移除的 SPExcelDataProvider 物件。

其類型必須為有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh,或是有效之 SPExcelDataProvider 物件的執行個體。

AssignmentCollection

選用

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

為能適當處置物件而管理物件。使用 SPWebSPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。使用 SPWebSPSiteSPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。

注意事項附註:
使用 Global 參數時,所有物件會包含在全域儲存區內。若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。

Confirm

選用

System.Management.Automation.SwitchParameter

執行命令之前,會先提示您進行確認。如需詳細資訊,請輸入下列命令:get-help about_commonparameters

WhatIf

選用

System.Management.Automation.SwitchParameter

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

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

Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataProvider | where {$_.providerID -eq "SQLOLEDB" } | Remove-SPExcelDataProvider

此範例會從安全資料提供者清單中移除預設的 SQL OLEDB 資料提供者,該清單位於名為 MyExcelService 的 Excel Services 應用程式 Web 服務應用程式 中。

Excel Services 應用程式 將不再重新整理任何使用此資料提供者的資料連線。

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

$provider = Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelDataProvider | { where {$_.providerID -eq "MyCustomProvider"}
Remove-SPExcelDataProvider $provider

此範例會從安全資料提供者清單中移除自訂的資料提供者,該清單位於名為 MyExcelService 的 Excel Services 應用程式 Web 服務應用程式 中。

Excel Services 應用程式 將不再重新整理任何使用此資料提供者的資料連線。

顯示: