Set-SPExcelUserDefinedFunction
Si applica a: SharePoint Server 2010
Ultima modifica dell'argomento: 2015-03-09
Imposta le proprietà di una funzione definita dall'utente in Excel Services in Microsoft SharePoint Server 2010.
Syntax
Set-SPExcelUserDefinedFunction [-Identity] <SPExcelUDFPipeBind> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-Assembly <String>] [-AssemblyLocation <GAC | LocalFile>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Enable <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet Set-SPExcelUserDefinedFunction consente di impostare le proprietà di un assembly di funzioni definite dall'utente. Excel Services utilizza solo funzioni definite dall'utente per le quali è presente una voce 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 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 Windows 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 |
Obbligatorio |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelUDFPipeBind |
Specifica l'oggetto SPExcelUserDefinedFunction da aggiornare. 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. |
Assembly |
Facoltativo |
System.String |
Specifica il nome fortemente tipizzato dell'assembly. Il nome deve essere univoco nell'elenco delle funzioni definite dall'utente e non può essere lungo più di 4096 caratteri alfanumerici. Il tipo deve essere una stringa di caratteri alfanumerici, ad esempio SocietàEsempio.ApplicazioneEsempio.UdfEsempio, C:\UDF\UdfEsempio.dll o \\ServerRete\UDF\UdfEsempio.dll. |
AssemblyLocation |
Facoltativo |
Microsoft.Office.Excel.Server.AssemblyLocation |
Specifica la posizione in cui l'assembly viene archiviato. 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 visualizzata per la funzione definita dall'utente. La lunghezza del nome non può superare i 4096 caratteri alfanumerici. Il tipo deve essere una stringa 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 Excel Services. |
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--------------
Set-SPExcelUserDefinedFunction -ExcelServiceApplication "My Excel Service" -Identity SampleCompany.SampleApplication.SampleUdf -Description "This is the new description for the sample UDF"
In questo esempio viene modificata la descrizione della funzione definita dall'utente (UDF) nel file UDF SampleCompany.SampleApplication.SampleUdf
per l'applicazione Excel Services denominata My Excel Service
.
--------------ESEMPIO 2--------------
Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $false
In questo esempio viene disattivato il file UDF SampleCompany.SampleApplication.SampleUdf
di esempio nell'applicazione Excel Services denominata My Excel Service
.