Set-SPExcelUserDefinedFunction
Define as propriedades de uma função definida pelo usuário no Aplicativo de Serviços do Excel.
Syntax
Set-SPExcelUserDefinedFunction
[-Identity] <SPExcelUDFPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-Assembly <String>]
[-AssemblyLocation <AssemblyLocation>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-Enable]
[-WhatIf]
[<CommonParameters>] Description
O Set-SPExcelUserDefinedFunction cmdlet define as propriedades de um assembly de função definido pelo usuário.
Serviços do Excel Aplicativo usa apenas funções definidas pelo usuário que têm uma entrada na lista de funções definida pelo usuário.
As funções definidas pelo usuário são assemblies de código gerenciados que podem ser chamados de uma pasta de trabalho Serviços do Excel Aplicativo usando a sintaxe padrão Serviços do Excel fórmula do aplicativo.
Os assemblies podem executar ações lógicas personalizadas ou outras ações, como atualizar dados.
Os cmdlets do Windows PowerShell operam nas entradas da lista de funções definidas pelo usuário, e não nos assemblies.
Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.
Exemplos
------------EXEMPLO 1----------------
Set-SPExcelUserDefinedFunction -ExcelServiceApplication "My Excel Service" -Identity SampleCompany.SampleApplication.SampleUdf -Description "This is the new description for the sample UDF"Este exemplo altera a descrição da UDF (função definida pelo usuário) para o arquivo UDF SampleCompany.SampleApplication.SampleUdf para o aplicativo de serviço Web de aplicativo Serviços do Excel chamado My Excel Service.
------------EXEMPLO 2----------------
Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $falseEste exemplo desabilita o exemplo de arquivo UDF SampleCompany.SampleApplication.SampleUdf do aplicativo Serviços do Excel chamado My Excel Service.
Parâmetros
-Assembly
Especifica o nome fortemente tipado do assembly. O nome deve ser exclusivo na lista de funções definidas pelo usuário e não pode ter mais de 4.096 caracteres alfanuméricos.
O tipo deve ser uma cadeia de caracteres alfanuméricos; por exemplo, SampleCompany.SampleApplication.SampleUdf, C:\UDFs\SampleUdf.dll ou \\MyNetworkServer\UDFs\SampleUdf.dll.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AssemblyLocation
Especifica o local em que o assembly é armazenado.
O tipo deve ser um dos seguintes: GAC ou LocalFile.
| Type: | AssemblyLocation |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AssignmentCollection
Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.
Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global.
Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Confirm
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Description
Especifica uma descrição de exibição para a função definida pelo usuário. O nome não pode ter mais de 4096 caracteres alfanuméricos.
O tipo deve ser uma cadeia de caracteres alfanuméricos; por exemplo, a função definida pelo usuário para a consolidação de relatórios.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Enable
Ativa a função definida pelo usuário para uso com Serviços do Excel Aplicativo.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExcelServiceApplication
Especifica o aplicativo de serviço Web de aplicativo Serviços do Excel que contém o objeto de lista SPExcelUserDefinedFunction.
O tipo deve ser um GUID válido, no formulário 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de um aplicativo de serviço Web de aplicativo Serviços do Excel no farm (por exemplo, MyExcelService1); ou uma instância de um objeto SPExcelServiceApplication válido.
| Type: | SPExcelServiceApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Identity
Especifica o objeto SPExcelUserDefinedFunction a ser atualizado.
O tipo deve ser um nome válido do assembly de código; por exemplo, SampleCompany.SampleApplication.SampleUdf; ou uma instância de um objeto SPExcelUDF válido.
| Type: | SPExcelUDFPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WhatIf
Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |