Remove-SPExcelUserDefinedFunction
Si applica a: SharePoint Server 2010
Ultima modifica dell'argomento: 2015-03-09
Rimuove una funzione definita dall'utente da Excel Services in Microsoft SharePoint Server 2010.
Syntax
Remove-SPExcelUserDefinedFunction [-Identity] <SPExcelUDFPipeBind> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Descrizione dettagliata
Il cmdlet Remove-SPExcelUserDefinedFunction consente di rimuovere una funzione dall'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 |
Facoltativo |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelUDFPipeBind |
Specifica l'oggetto SPExcelUserDefinedFunction da rimuovere. 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'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 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. |
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 |
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--------------
Remove-SPExcelUserDefinedFunction -ExcelServiceApplication "My Excel Service" -Identity "SampleCompany.SampleApplication.SampleUdf"
In questo esempio viene rimossa la funzione SampleCompany.SampleApplication.SampleUdf dall'elenco delle funzioni definite dall'utente dell'applicazione Excel Services denominata MyExcelService.
--------------ESEMPIO 2--------------
Get-SPExcelServiceApplication | Remove-SPExcelUserDefinedFunction -Identity "SampleCompany.SampleApplication.SampleUdf"
In questo esempio viene rimossa la funzione SampleCompany.SampleApplication.SampleUdf dall'elenco delle funzioni definite dall'utente per tutte le applicazioni Excel Services della farm.