New-SPExcelUserDefinedFunction
Si applica a: SharePoint Server 2010
Ultima modifica dell'argomento: 2015-03-09
Aggiunge una nuova funzione definita dall'utente all'applicazione Excel Services.
Syntax
New-SPExcelUserDefinedFunction -Assembly <String> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AssemblyLocation <GAC | LocalFile>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enable <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet New-SPExcelUserDefinedFunction aggiunge una funzione definita dall'utente a un'applicazione di servizio Web dell'applicazione Excel Services. L'applicazione Excel Services utilizza solo le funzioni presenti nell'elenco delle funzioni definite dall'utente. Le funzioni definite dall'utente sono assembly di codice gestito che è possibile chiamare da una cartella di lavoro dell'applicazione Excel Services utilizzando la sintassi delle formule standard dell'applicazione Excel Services. 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 indicazioni sulle autorizzazioni e per informazioni aggiornate su questo cmdlet, vedere la documentazione online (https://go.microsoft.com/fwlink/?LinkId=163185).
Parameters
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
Assembly |
Obbligatorio |
System.String |
Specifica il nome fortemente tipizzato dell'assembly. Il nome deve essere univoco nell'elenco delle funzioni definite dall'utente e può contenere al massimo 4096 caratteri alfanumerici. Il tipo deve essere una stringa di caratteri alfanumerici, ad esempio: -- SocietàEsempio.ApplicazioneEsempio.UdfEsempio -- C:\UDF\UdfEsempio.dll -- \\ServerRete\UDF\UdfEsempio.dll |
ExcelServiceApplication |
Obbligatorio |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind |
Specifica l'applicazione di servizio Web dell'applicazione Excel Services contenente l'elenco delle funzioni definite dall'utente. Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un'applicazione di servizio Web dell'applicazione Excel Services presente nella farm, ad esempio ServizioExcel1, o un'istanza di un oggetto SPExcelServiceApplication valido. |
AssemblyLocation |
Facoltativo |
Microsoft.Office.Excel.Server.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. |
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. |
Confirm |
Facoltativo |
System.Management.Automation.SwitchParameter |
Visualizza una richiesta di conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters |
Description |
Facoltativo |
System.String |
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". |
Enable |
Facoltativo |
System.Management.Automation.SwitchParameter |
Attiva la funzione definita dall'utente per l'utilizzo con l'applicazione Excel Services. Il valore predefinito è True. |
WhatIf |
Facoltativo |
System.Management.Automation.SwitchParameter |
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters |
Tipi di input
Tipi restituiti
Example
--------------ESEMPIO 1--------------
New-SPExcelUserDefinedFunction -ExcelServiceApplication "MyExcelService" -Assembly "SampleCompany.SampleApplication.SampleUdf" -AssemblyLocation GAC
In questo esempio viene aggiunto il file SampleComany.SampleApplication.SampleUdf all'applicazione di servizio Web dell'applicazione Excel Services denominata MyExcelService come nuova funzione definita dall'utente.
L'assembly di funzioni definite dall'utente viene distribuito alla Global Assembly Cache (GAC).
--------------ESEMPIO 2--------------
Get-SPExcelServiceApplication | New-SPExcelUserDefinedFunction -Assembly "SampleCompany.SampleApplication.SampleUdf" -AssemblyLocation GAC
In questo esempio viene aggiunto il file SampleComany.SampleApplication.SampleUdf a ogni applicazione di servizio Web dell'applicazione Excel Services della farm.
L'assembly di funzioni definite dall'utente viene distribuito alla Global Assembly Cache (GAC).