Get-SPExcelUserDefinedFunction
傳回使用者定義的函數或使用者定義之函數的集合。
語法
Default (預設值)
Get-SPExcelUserDefinedFunction
[[-Identity] <SPExcelUDFPipeBind>]
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
Description
Get-SPExcelUserDefinedFunction Cmdlet 會讀取使用者定義的函數及其屬性,或傳回 Excel Services 應用程式 Web 服務應用程式的使用者定義函數集合。 Excel Services 應用程式只會使用位於使用者定義函數清單中的使用者定義函數。 使用者定義函數是可以使用標準 Excel Services 應用程式公式語法從 Excel Services 應用程式活頁簿呼叫的受管理程式碼組件。 組件可以執行自訂邏輯或其他動作,例如重新整理資料。 Windows PowerShell Cmdlet 可操作於使用者定義的函數清單中的項目,但不會在組件上操作。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊,請參閱線上文件 SharePoint Server Cmdlet。
範例
範例 1
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf
本範例顯示名為 SampleCompany.SampleApplication.SampleUdf 的使用者定義函數,其位於名為 MyExcelService 的 Excel Services 應用程式 Web 服務應用程式中的使用者定義函數。
範例 2
Get-SPExcelServiceApplication | Get-SPExcelUserDefinedFunction | format-list
此範例會顯示陣列中每一個 Excel Services 應用程式 Web 服務應用程式的每個使用者定義函數,然後以清單顯示結果。
參數
-AssignmentCollection
適用項目:SharePoint Server 2010、SharePoint Server 2013
管理物件以適當處置它們。 使用 SPWeb 或 SPSite 等物件可能會耗用大量的記憶體,因此在 Windows PowerShell 指令碼中使用這些物件時,必須適當地管理記憶體。 您可以使用 SPAssignment 物件將物件指派給變數,並在不需要時處置這些物件,以釋放記憶體。 使用 SPWeb、SPSite 或 SPSiteAdministration 物件時,若未使用指派集合或 Global 參數,將會自動處置這些物件。
使用 Global 參數時,所有物件會包含在全域儲存區內。 若未立即使用物件,或未使用 Stop-SPAssignment 命令處置物件,將會發生記憶體不足的狀況。
參數屬性
| 類型: | SPAssignmentCollection |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ExcelServiceApplication
適用項目:SharePoint Server 2010、SharePoint Server 2013
指定包含 SPExcelUserDefinedFunction 清單物件的 Excel Services 應用程式 Web 服務應用程式。
其類型必須為有效的 GUID,且格式為 12345678-90ab-cdef-1234-567890bcdefgh;在伺服器陣列 (例如,MyExcelService1) 中,Excel Services 應用程式 Web 服務應用程式的有效名稱;或是有效之 SPExcelServiceApplication 物件的執行個體。
參數屬性
| 類型: | SPExcelServiceApplicationPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Identity
適用項目:SharePoint Server 2010、SharePoint Server 2013
指定要取得的 UserDefinedFunction 物件。 如果未指定 Identity 參數,Cmdlet 會傳回使用者定義函式清單中的所有函式。
類型必須是程式碼組件的有效名稱 (例如 SampleCompany.SampleApplication.SampleUdf) ;或有效 SPExcelUDF 物件的執行個體。
參數屬性
| 類型: | SPExcelUDFPipeBind |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | False |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。