Get-SPExcelUserDefinedFunction

项目
03/07/2017

适用于： SharePoint Server 2010

上一次修改主题： 2015-03-09

返回用户定义的函数或用户定义函数的集合。

Syntax

Get-SPExcelUserDefinedFunction [[-Identity] <SPExcelUDFPipeBind>] -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>]

详细说明

Get-SPExcelUserDefinedFunction cmdlet 读取用户定义的函数及其属性，或者为 Excel Services 应用程序 Web 服务应用程序返回用户定义函数的集合。Excel Services 应用程序仅使用位于用户定义函数列表中的用户定义函数。用户定义的函数是可以使用标准 Excel Services 应用程序公式语法从 Excel Services 应用程序工作簿调用的托管代码程序集。这些程序集可以执行自定义逻辑或其他操作，如刷新数据。Windows PowerShell cmdlet 对用户定义函数列表中的条目执行操作，而不对程序集执行操作。

有关此 cmdlet 的权限和最新信息，请参阅联机文档 (https://go.microsoft.com/fwlink/?LinkId=163185)。

Parameters

参数	是否必需	类型	说明
Identity	可选	Microsoft.Office.Excel.Server.Cmdlet.SPExcelUDFPipeBind	指定要获取的 UserDefinedFunction 对象。如果未指定 Identity 参数，则 cmdlet 返回用户定义的函数列表中的所有函数。键入的值必须为代码程序集的有效名称（如 SampleCompany.SampleApplication.SampleUdf）；或有效 SPExcelUDF 对象的实例。
ExcelServiceApplication	必需	Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind	指定包含 SPExcelUserDefinedFunction 列表对象的 Excel Services 应用程序 Web 服务应用程序。键入的值必须是 12345678-90ab-cdef-1234-567890bcdefgh 形式的有效 GUID；服务器场中 Excel Services 应用程序 Web 服务应用程序的有效名称（例如 MyExcelService1）；或有效 SPExcelServiceApplication 对象的实例。
AssignmentCollection	可选	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。备注在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

Identity

可选

Microsoft.Office.Excel.Server.Cmdlet.SPExcelUDFPipeBind

指定要获取的 UserDefinedFunction 对象。如果未指定 Identity 参数，则 cmdlet 返回用户定义的函数列表中的所有函数。

键入的值必须为代码程序集的有效名称（如 SampleCompany.SampleApplication.SampleUdf）；或有效 SPExcelUDF 对象的实例。

ExcelServiceApplication

必需

Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind

指定包含 SPExcelUserDefinedFunction 列表对象的 Excel Services 应用程序 Web 服务应用程序。

键入的值必须是 12345678-90ab-cdef-1234-567890bcdefgh 形式的有效 GUID；服务器场中 Excel Services 应用程序 Web 服务应用程序的有效名称（例如 MyExcelService1）；或有效 SPExcelServiceApplication 对象的实例。

AssignmentCollection

可选

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

备注

在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

输入类型

返回类型

Example

--------------示例 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 服务应用程序显示每个用户定义函数，然后在列表中显示结果。

通过