New-SPExcelUserDefinedFunction

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2010, SharePoint Server 2013

Aggiunge una nuova funzione definita dall'utente all'applicazione Excel Services.

Sintassi

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

Descrizione

Il New-SPExcelUserDefinedFunction cmdlet aggiunge una funzione definita dall'utente a un'applicazione del servizio Web applicazione Excel Services. Excel Services'applicazione usa solo funzioni definite dall'utente che hanno una voce nell'elenco delle funzioni definite dall'utente. Le funzioni definite dall'utente sono assembly di codice gestito che possono essere chiamati da una cartella di lavoro dell'applicazione Excel Services usando la sintassi standard Excel Services formula application. Gli assembly sono in grado di eseguire azioni logiche personalizzate o di altro tipo, ad esempio l'aggiornamento dei dati. I cmdlet di Windows PowerShell operano sulle voci dell'elenco delle funzioni definite dall'utente ma non sugli assembly.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO------------------

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

In questo esempio viene aggiunto il file SampleComany.SampleApplication.SampleUdf a ogni Excel Services'applicazione del servizio Web Application nella farm.

L'assembly di funzioni definite dall'utente viene distribuito alla Global Assembly Cache (GAC).

Parametri

-Assembly

Specifica il nome fortemente tipizzato dell'assembly. Il nome deve essere univoco nell'elenco delle funzioni definite dall'utente. La lunghezza del nome può essere al massimo 4096 caratteri alfanumerici.

Il tipo deve essere una stringa di caratteri alfanumerici, ad esempio:

-- 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

Specifica la posizione in cui l'assembly viene archiviato. Il valore predefinito è GAC.

Il tipo deve essere uno dei seguenti valori: GAC o 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

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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

Specifica una descrizione per la funzione definita dall'utente. Il nome può contenere al massimo 4096 caratteri alfanumerici. Il valore predefinito è una stringa vuota.

Il tipo deve essere una stringa valida di caratteri alfanumerici, ad esempio "Funzione definita dall'utente per i report di consolidamento".

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

Attiva la funzione definita dall'utente da usare con Excel Services'applicazione. Il valore predefinito è 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

Specifica la Excel Services'applicazione del servizio Web applicazione che contiene l'elenco di funzioni definite dall'utente.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh; un nome valido di un'applicazione del servizio Web applicazione Excel Services nella farm (ad esempio MyExcelService1) o un'istanza di un oggetto SPExcelServiceApplication valido.

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

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: 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