Set-SPExcelUserDefinedFunction
Establece las propiedades de una función definida por el usuario en la aplicación de Servicios de Excel.
Sintaxis
Default (Es el valor predeterminado).
Set-SPExcelUserDefinedFunction
[-Identity] <SPExcelUDFPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-Assembly <String>]
[-AssemblyLocation <AssemblyLocation>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-Enable]
[-WhatIf]
[<CommonParameters>]
Description
El Set-SPExcelUserDefinedFunction cmdlet establece las propiedades de un ensamblado de función definido por el usuario.
Excel Services Application solo usa funciones definidas por el usuario que tienen una entrada en la lista de funciones definidas por el usuario.
Las funciones definidas por el usuario son ensamblados de código administrado a los que se puede llamar desde un libro de aplicación de Excel Services mediante la sintaxis de fórmula de aplicación Excel Services estándar.
Los ensamblados pueden realizar acciones lógicas personalizadas u otras, como actualizar datos.
Windows PowerShell cmdlets funcionan en las entradas de la lista de funciones definidas por el usuario y no funcionan en los ensamblados.
Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.
Ejemplos
EJEMPLO 1
Set-SPExcelUserDefinedFunction -ExcelServiceApplication "My Excel Service" -Identity SampleCompany.SampleApplication.SampleUdf -Description "This is the new description for the sample UDF"
En este ejemplo se cambia la descripción de la función definida por el usuario (UDF) al archivo UDF SampleCompany.SampleApplication.SampleUdf de la aplicación de servicio web de aplicación Excel Services denominada My Excel Service.
EJEMPLO 2
Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $false
En este ejemplo se deshabilita el archivo SAMPLECOMPANY.SampleApplication.SampleUdf de ejemplo de la aplicación Excel Services denominada My Excel Service.
Parámetros
-Assembly
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Especifica el nombre fuertemente tipado del ensamblado. El nombre debe ser único en la lista de funciones definidas por el usuario y no puede tener más de 4096 caracteres alfanuméricos de largo.
El tipo debe ser una cadena de caracteres alfanuméricos; por ejemplo, SampleCompany.SampleApplication.SampleUdf, C:\UDFs\SampleUdf.dll o \\MyNetworkServer\UDFs\SampleUdf.dll.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AssemblyLocation
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Especifica la ubicación donde se guarda el ensamblado.
El tipo debe ser uno de los siguientes: GAC o LocalFile.
Propiedades del parámetro
| Tipo: | AssemblyLocation |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-AssignmentCollection
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global.
Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.
Propiedades del parámetro
| Tipo: | SPAssignmentCollection |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Le pide confirmación antes de ejecutar el comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Description
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Especifica una descripción para mostrar para la función definida por el usuario. El nombre no puede tener más de 4096 caracteres alfanuméricos.
El tipo debe ser una cadena de caracteres alfanuméricos; por ejemplo, esta es la función definida por el usuario para los informes de consolidación.
Propiedades del parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Enable
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Activa la función definida por el usuario para su uso con Excel Services Application.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ExcelServiceApplication
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Especifica la aplicación de servicio web de aplicación Excel Services que contiene el objeto de lista SPExcelUserDefinedFunction.
El tipo debe ser un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh; un nombre válido de una aplicación de servicio web de aplicación de Excel Services en la granja de servidores (por ejemplo, MyExcelService1); o una instancia de un objeto SPExcelServiceApplication válido.
Propiedades del parámetro
| Tipo: | SPExcelServiceApplicationPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Identity
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Especifica el objeto SPExcelUserDefinedFunction que se va a actualizar.
El tipo debe ser un nombre válido del ensamblado de código; por ejemplo, SampleCompany.SampleApplication.SampleUdf; o una instancia de un objeto SPExcelUDF válido.
Propiedades del parámetro
| Tipo: | SPExcelUDFPipeBind |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Aplicable: SharePoint Server 2010, SharePoint Server 2013
Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.