Set-SPExcelUserDefinedFunction
Define as propriedades de uma função definida pelo usuário no Aplicativo de Serviços do Excel.
Sintaxe
Default (Padrão)
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 uma assemblagem de função definida pelo utilizador.
Serviços do Excel Aplicação utiliza apenas funções definidas pelo utilizador que têm uma entrada na lista de funções definidas pelo utilizador.
As funções definidas pelo utilizador são assemblagens de código geridas que podem ser chamadas a partir de um livro da Aplicação Serviços do Excel através da sintaxe padrão Serviços do Excel fórmula da Aplicação.
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 função definida pelo utilizador (UDF) para o ficheiro UDF SampleCompany.SampleApplication.SampleUdf para a aplicação do serviço Web Serviços do Excel com o nome O Meu Serviço Excel.
EXEMPLO 2
Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $false
Este exemplo desativa o ficheiro UDF SampleCompany.SampleApplication.SampleUdf de exemplo a partir da Aplicação Serviços do Excel com o nome O Meu Serviço do Excel.
Parâmetros
-Assembly
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o nome fortemente tipado do assembly. O nome tem de ser exclusivo na lista de funções definidas pelo utilizador e não pode ter mais de 4096 carateres alfanuméricos de comprimento.
O tipo deve ser uma cadeia de caracteres alfanuméricos; por exemplo, SampleCompany.SampleApplication.SampleUdf, C:\UDFs\SampleUdf.dll ou \\MyNetworkServer\UDFs\SampleUdf.dll.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AssemblyLocation
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o local em que o assembly é armazenado.
O tipo deve ser um dos seguintes: GAC ou LocalFile.
Propriedades do parâmetro
| Tipo: | AssemblyLocation |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AssignmentCollection
Aplicável: SharePoint Server 2010, SharePoint Server 2013
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.
Propriedades do parâmetro
| Tipo: | SPAssignmentCollection |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Solicita sua confirmação antes de executar o comando.
Para saber mais, digite o seguinte comando: get-help about_commonparameters
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Description
Aplicável: SharePoint Server 2010, SharePoint Server 2013
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.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Enable
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Ativa a função definida pelo utilizador para utilização com Serviços do Excel Aplicação.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ExcelServiceApplication
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o Serviços do Excel aplicação do serviço Web da Aplicação que contém o objeto de lista SPExcelUserDefinedFunction.
O tipo tem de ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de uma aplicação de serviço Web da Aplicação Serviços do Excel no farm (por exemplo, MyExcelService1); ou uma instância de um objeto SPExcelServiceApplication válido.
Propriedades do parâmetro
| Tipo: | SPExcelServiceApplicationPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: SharePoint Server 2010, SharePoint Server 2013
Especifica o objeto SPExcelUserDefinedFunction a ser atualizado.
O tipo tem de ser um nome válido da assemblagem de código; por exemplo, SampleCompany.SampleApplication.SampleUdf; ou uma instância de um objeto SPExcelUDF válido.
Propriedades do parâmetro
| Tipo: | SPExcelUDFPipeBind |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: SharePoint Server 2010, SharePoint Server 2013
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
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.