Articolo
02/17/2017

Get-SPExcelUserDefinedFunction

Si applica a: SharePoint Server 2010

Ultima modifica dell'argomento: 2015-03-09

Restituisce una funzione definita dall'utente o una raccolta di funzioni definite dall'utente.

Syntax

Get-SPExcelUserDefinedFunction [[-Identity] <SPExcelUDFPipeBind>] -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>]

Descrizione dettagliata

Il cmdlet Get-SPExcelUserDefinedFunction legge una funzione definita dall'utente con le relative proprietà o restituisce la raccolta di funzioni definite dall'utente per un'applicazione Excel Services. Excel Services utilizza solo le funzioni definite dall'utente contenute nell'elenco delle funzioni definite dall'utente. Tali funzioni sono assembly di codice gestito che è possibile chiamare da una cartella di lavoro Microsoft Excel utilizzando la sintassi della formula standard di Excel. Gli assembly sono in grado di eseguire azioni logiche personalizzate o di altro tipo, ad esempio l'aggiornamento dei dati. I cmdlet di PowerShell operano sulle voci dell'elenco delle funzioni definite dall'utente ma non sugli assembly.

Per le autorizzazioni e le informazioni più aggiornate su Windows PowerShell per SharePoint Server 2010, vedere i relativi articoli in TechNet all'indirizzo https://go.microsoft.com/fwlink/?linkid=163183\&clcid=0x410

Parameters

Parametro	Obbligatorio	Tipo	Descrizione
Identity	Facoltativo	Microsoft.Office.Excel.Server.Cmdlet.SPExcelUDFPipeBind	Specifica l'oggetto UserDefinedFunction da utilizzare. Se il parametro Identity non è specificato, il cmdlet restituisce tutte le funzioni presenti nell'elenco delle funzioni definite dall'utente. Il tipo deve essere un nome valido di assembly di codice, ad esempio SocietàEsempio.ApplicazioneEsempio.UdfEsempio, o un'istanza di un oggetto SPExcelUDF valido.
ExcelServiceApplication	Obbligatorio	Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind	Specifica l'applicazione Excel Services che contiene l'oggetto elenco SPExcelUserDefinedFunction. Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un'applicazione Excel Services presente nella farm, ad esempio ServizioExcel1, o un'istanza di un oggetto SPExcelServiceApplication valido.
AssignmentCollection	Facoltativo	Microsoft.SharePoint.PowerShell.SPAssignmentCollection	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. Nota 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.

Identity

Facoltativo

Microsoft.Office.Excel.Server.Cmdlet.SPExcelUDFPipeBind

Specifica l'oggetto UserDefinedFunction da utilizzare. Se il parametro Identity non è specificato, il cmdlet restituisce tutte le funzioni presenti nell'elenco delle funzioni definite dall'utente.

Il tipo deve essere un nome valido di assembly di codice, ad esempio SocietàEsempio.ApplicazioneEsempio.UdfEsempio, o un'istanza di un oggetto SPExcelUDF valido.

ExcelServiceApplication

Obbligatorio

Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind

Specifica l'applicazione Excel Services che contiene l'oggetto elenco SPExcelUserDefinedFunction.

Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un'applicazione Excel Services presente nella farm, ad esempio ServizioExcel1, o un'istanza di un oggetto SPExcelServiceApplication valido.

AssignmentCollection

Facoltativo

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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.

Nota

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.

Tipi di input

Tipi restituiti

Example

--------------ESEMPIO 1--------------

Get-SPExcelServiceApplication -Identity "MyExcelService" | Get-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf

In questo esempio viene visualizzata la funzione definita dall'utente SampleCompany.SampleApplication.SampleUdf presente nell'elenco delle funzioni definite dall'utente dell'applicazione Excel Services denominata MyExcelService.

--------------ESEMPIO 2--------------

Get-SPExcelServiceApplication | Get-SPExcelUserDefinedFunction | format-list

In questo esempio viene visualizzata ogni funzione definita dall'utente per ogni applicazione Excel Services della farm e i relativi risultati vengono riportati in un elenco.