Get-SPExcelUserDefinedFunction
傳回使用者定義的函數或使用者定義之函數的集合。
語法
Default (預設值)
Get-SPExcelUserDefinedFunction
[[-Identity] <SPExcelUDFPipeBind>]
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[<CommonParameters>]
Description
Get-SPExcelUserDefinedFunction Cmdlet 會讀取使用者定義函數及其屬性，或傳回 Excel Services 應用程式 Web 服務應用程式的使用者定義函式集合。 Excel Services 應用程式只會使用使用者定義函數清單中的使用者定義函數。 使用者定義函式是 Managed 程式代碼元件，可使用標準 Excel Services 應用程式公式語法，從 Excel Services 應用程式活頁簿呼叫。 元件可以執行自定義邏輯或其他動作，例如重新整理數據。 Windows PowerShell Cmdlet 會在使用者定義函數清單中的項目上運作，但不會在元件上運作。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
範例 1
Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf
本範例會從名為 MyExcelService 的 Excel Services 應用程式 Web 服務應用程式中使用者定義函數列表中，顯示名為 SampleCompany.SampleApplication.SampleUdf 的使用者定義函式。
範例 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。