Set-SPExcelUserDefinedFunction
Imposta le proprietà di una funzione definita dall'utente nell'applicazione Excel Services.
Sintassi
Default (impostazione predefinita).
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: $false
In questo esempio viene disabilitato il file SampleCompany.SampleApplication.SampleUdf di esempio della funzione definita dall'applicazione Excel Services denominata My Excel Service.
Parametri
-Assembly
Applicabile: SharePoint Server 2010, SharePoint Server 2013
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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AssemblyLocation
Applicabile: SharePoint Server 2010, SharePoint Server 2013
Specifica la posizione in cui l'assembly viene archiviato.
Il tipo deve essere uno dei seguenti valori: GAC o LocalFile.
Proprietà dei parametri
| Tipo: | AssemblyLocation |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AssignmentCollection
Applicabile: SharePoint Server 2010, SharePoint Server 2013
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.
Proprietà dei parametri
| Tipo: | SPAssignmentCollection |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: SharePoint Server 2010, SharePoint Server 2013
Richiede la conferma prima di eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Description
Applicabile: SharePoint Server 2010, SharePoint Server 2013
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".
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Enable
Applicabile: SharePoint Server 2010, SharePoint Server 2013
Attiva la funzione definita dall'utente da usare con Excel Services'applicazione.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ExcelServiceApplication
Applicabile: SharePoint Server 2010, SharePoint Server 2013
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.
Proprietà dei parametri
| Tipo: | SPExcelServiceApplicationPipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Identity
Applicabile: SharePoint Server 2010, SharePoint Server 2013
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.
Proprietà dei parametri
| Tipo: | SPExcelUDFPipeBind |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: SharePoint Server 2010, SharePoint Server 2013
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.