Set-SPExcelUserDefinedFunction
适用于： SharePoint Server 2010
上一次修改主题： 2015-03-09
在 Excel Services 应用程序 中设置用户定义的函数的属性。
Syntax
Set-SPExcelUserDefinedFunction [-Identity] <SPExcelUDFPipeBind> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-Assembly <String>] [-AssemblyLocation <GAC | LocalFile>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enable <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Set-SPExcelUserDefinedFunction cmdlet 设置用户定义函数程序集的属性。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 |
指定要更新的 SPExcelUserDefinedFunction 对象。 键入的值必须为代码程序集的有效名称（例如，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 对象的实例。 |
Assembly |
可选 |
System.String |
指定程序集的强类型名称。该名称在用户定义的函数列表中必须唯一，并且长度不得超过 4096 个字母数字字符。 键入的值必须是由字母数字字符组成的字符串；例如，SampleCompany.SampleApplication.SampleUdf、C:\UDFs\SampleUdf.dll 或 \\MyNetworkServer\UDFs\SampleUdf.dll。 |
AssemblyLocation |
可选 |
Microsoft.Office.Excel.Server.AssemblyLocation |
指定程序集的存储位置。 键入的值必须为以下项之一：GAC 或 LocalFile。 |
AssignmentCollection |
可选 |
Microsoft.SharePoint.PowerShell.SPAssignmentCollection |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。 备注 在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。 |
Confirm |
可选 |
System.Management.Automation.SwitchParameter |
在执行命令之前提示您确认。有关详细信息，请键入以下命令：get-help about_commonparameters |
Description |
可选 |
System.String |
指定用户定义的函数的显示说明。该名称的长度不得超过 4096 个字母数字字符。 键入的值必须是由字母数字字符组成的字符串；例如，“这是用于整合报告的用户定义的函数”。 |
Enable |
可选 |
System.Management.Automation.SwitchParameter |
激活用户定义的函数以用于 Excel Services 应用程序。 |
WhatIf |
可选 |
System.Management.Automation.SwitchParameter |
显示一条描述命令作用的消息，而不执行命令。有关详细信息，请键入以下命令：get-help about_commonparameters |
输入类型
返回类型
Example
--------------示例 1--------------
Set-SPExcelUserDefinedFunction -ExcelServiceApplication "My Excel Service" -Identity SampleCompany.SampleApplication.SampleUdf -Description "This is the new description for the sample UDF"
此示例将用户定义的函数 (UDF) 的说明更改为名为 My Excel Service 的 Excel Services 应用程序 Web 服务应用程序 的 UDF SampleCompany.SampleApplication.SampleUdf 文件。
--------------示例 2--------------
Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $false
此示例禁用名为 My Excel Service 的 Excel Services 应用程序 中的示例 UDF SampleCompany.SampleApplication.SampleUdf 文件。
See Also
Reference
Get-SPExcelUserDefinedFunction
New-SPExcelUserDefinedFunction
Remove-SPExcelUserDefinedFunction