Set-SPExcelUserDefinedFunction

Riferimento

Modulo:: SharePointServer

Si applica a:: SharePoint Server 2010, SharePoint Server 2013

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: $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

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

Condividi tramite