New-SPExcelUserDefinedFunction
Aggiunge una nuova funzione definita dall'utente all'applicazione Excel Services.
Sintassi
Default (impostazione predefinita).
New-SPExcelUserDefinedFunction
-Assembly <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AssemblyLocation <AssemblyLocation>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-Enable]
[-WhatIf]
[<CommonParameters>]
Descrizione
Il New-SPExcelUserDefinedFunction cmdlet aggiunge una funzione definita dall'utente a un'applicazione del servizio Web applicazione Excel Services.
Excel Services'applicazione usa solo funzioni definite dall'utente che hanno una voce nell'elenco delle 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
Get-SPExcelServiceApplication | New-SPExcelUserDefinedFunction -Assembly "SampleCompany.SampleApplication.SampleUdf" -AssemblyLocation GAC
In questo esempio viene aggiunto il file SampleComany.SampleApplication.SampleUdf a ogni Excel Services'applicazione del servizio Web Application nella farm.
L'assembly di funzioni definite dall'utente viene distribuito alla Global Assembly Cache (GAC).
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. La lunghezza del nome può essere al massimo 4096 caratteri alfanumerici.
Il tipo deve essere una stringa di caratteri alfanumerici, ad esempio:
-- SampleCompany.SampleApplication.SampleUdf -- C:\UDFs\SampleUdf.dll -- \\MyNetworkServer\UDFs\SampleUdf.dll
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | True |
| 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 valore predefinito è GAC.
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 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".
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. Il valore predefinito è True.
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'elenco di funzioni definite dall'utente.
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 |
-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.