New-SPExcelUserDefinedFunction

  • Referência
Módulo:
SharePointServer
Aplica-se a:
SharePoint Server 2010, SharePoint Server 2013

Adiciona uma nova função definida pelo usuário ao Aplicativo de Serviços do Excel.

Syntax

New-SPExcelUserDefinedFunction
   -Assembly <String>
   -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
   [-AssemblyLocation <AssemblyLocation>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-Description <String>]
   [-Enable]
   [-WhatIf]
   [<CommonParameters>]

Description

O New-SPExcelUserDefinedFunction cmdlet adiciona uma função definida pelo usuário a um aplicativo de serviço Web de aplicativo Serviços do Excel. Serviços do Excel Aplicativo usa apenas funções definidas pelo usuário que têm uma entrada na lista de funções definidas 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 na 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------------------

Get-SPExcelServiceApplication | New-SPExcelUserDefinedFunction -Assembly "SampleCompany.SampleApplication.SampleUdf" -AssemblyLocation GAC

Este exemplo adiciona o arquivo SampleComany.SampleApplication.SampleUdf a cada aplicativo de serviço Web de aplicativo Serviços do Excel no farm.

O assembly de função definida pelo usuário é implantado no GAC (cache de assembly global).

Parâmetros

-Assembly

Especifica o nome fortemente tipado do assembly. O nome deve ser exclusivo na lista de funções definidas pelo usuário. O nome pode ter, no máximo, 4096 caracteres alfanuméricos.

O tipo deve ser uma cadeia de caracteres alfanuméricos; por exemplo:

-- SampleCompany.SampleApplication.SampleUdf -- C:\UDFs\SampleUdf.dll -- \\MyNetworkServer\UDFs\SampleUdf.dll

Type:String
Position:Named
Default value:None
Required:True
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 valor padrão é GAC.

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 amigável para a função definida pelo usuário. O nome pode conter no máximo 4096 caracteres alfanuméricos. O valor padrão é uma cadeia de caracteres vazia.

O tipo deve ser uma cadeia válida 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. O valor padrão é True.

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 Serviços do Excel Aplicativo que contém a lista de funções definidas pelo usuário.

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

-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