Condividi tramite


Get-SPExcelUserDefinedFunction

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

Sintassi

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

Descrizione

Il cmdlet Get-SPExcelUserDefinedFunction legge una funzione definita dall'utente e le relative proprietà oppure restituisce la raccolta di funzioni definite dall'utente per un'applicazione del servizio Web applicazione Excel Services. Excel Services'applicazione usa solo funzioni definite dall'utente incluse 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 1 --------------

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

In questo esempio viene visualizzata la funzione definita dall'utente denominata SampleCompany.SampleApplication.SampleUdf dall'elenco di funzioni definite dall'utente che si trova nell'applicazione del servizio Web applicazione Excel Services denominata MyExcelService.

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

Get-SPExcelServiceApplication | Get-SPExcelUserDefinedFunction | format-list

In questo esempio vengono visualizzate tutte le funzioni definite dall'utente per ogni Excel Services'applicazione del servizio Web applicazione nella farm e quindi vengono visualizzati i risultati in un elenco.

Parametri

-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

-ExcelServiceApplication

Specifica la Excel Services'applicazione del servizio Web applicazione 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 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

-Identity

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.

Type:SPExcelUDFPipeBind
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013