Set-SPExcelUserDefinedFunction
Imposta le proprietà di una funzione definita dall'utente nell'applicazione Excel Services.
Sintassi
Set-SPExcelUserDefinedFunction
[-Identity] <SPExcelUDFPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-Assembly <String>]
[-AssemblyLocation <AssemblyLocation>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-Enable]
[-WhatIf]
[<CommonParameters>] Descrizione
Il Set-SPExcelUserDefinedFunction cmdlet imposta le proprietà di un assembly di funzioni definito dall'utente.
Excel Services'applicazione usa solo funzioni definite dall'utente che hanno una voce nell'elenco di 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 --------------
Set-SPExcelUserDefinedFunction -ExcelServiceApplication "My Excel Service" -Identity SampleCompany.SampleApplication.SampleUdf -Description "This is the new description for the sample UDF"In questo esempio la descrizione della funzione definita dall'utente viene modificata nel file UDF SampleCompany.SampleApplication.SampleUdf per l'applicazione del servizio Web applicazione Excel Services denominata My Excel Service.
---------------ESEMPIO 2 --------------
Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $falseIn questo esempio viene disabilitato il file SampleCompany.SampleApplication.SampleUdf di esempio della funzione definita dall'applicazione Excel Services denominata My Excel Service.
Parametri
-Assembly
Specifica il nome fortemente tipizzato dell'assembly. Il nome deve essere univoco nell'elenco delle funzioni definite dall'utente e non può contenere 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AssemblyLocation
Specifica la posizione in cui l'assembly viene archiviato.
Il tipo deve essere uno dei seguenti valori: GAC o LocalFile.
| Type: | AssemblyLocation |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-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 |
-Confirm
Richiede la conferma prima di eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Description
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".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Enable
Attiva la funzione definita dall'utente da usare con Excel Services'applicazione.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 SPExcelUserDefinedFunction da aggiornare.
Il tipo deve essere un nome valido dell'assembly di codice; Ad esempio, SampleCompany.SampleApplication.SampleUdf; o un'istanza di un oggetto SPExcelUDF valido.
| Type: | SPExcelUDFPipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WhatIf
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
Commenti e suggerimenti
Presto disponibile: nel corso del 2024 verranno dismessi i problemi di GitHub come meccanismo di feedback per il contenuto e verranno sostituiti con un nuovo sistema di feedback. Per altre informazioni, vedere: https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per