New-SPExcelFileLocation

 

Si applica a: SharePoint Server 2010

Ultima modifica dell'argomento: 2015-03-09

Aggiunge un nuovo percorso attendibile a Excel Services in Microsoft SharePoint Server 2010.

Syntax

New-SPExcelFileLocation -Address <String> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AbortOnRefreshOnOpenFail <SwitchParameter>] [-AssignmentCollection <SPAssignmentCollection>] [-AutomaticVolatileFunctionCacheLifetime <Int32>] [-ChartAndImageSizeMax <Int32>] [-ChartRenderDurationMax <Int32>] [-ConcurrentDataRequestsPerSessionMax <Int32>] [-Confirm [<SwitchParameter>]] [-DefaultWorkbookCalcMode <File | Manual | Auto | AutoDataTables>] [-Description <String>] [-DisplayGranularExtDataErrors <SwitchParameter>] [-ExternalDataAllowed <None | Dcl | DclAndEmbedded>] [-IncludeChildren <SwitchParameter>] [-LocationType <SharePoint | Unc | Http>] [-ManualExtDataCacheLifetime <Int32>] [-NewWorkbookSessionTimeout <Int32>] [-PeriodicExtDataCacheLifetime <Int32>] [-RequestDurationMax <Int32>] [-RESTExternalDataAllowed <SwitchParameter>] [-SessionTimeout <Int32>] [-ShortSessionTimeout <Int32>] [-UdfsAllowed <SwitchParameter>] [-WarnOnDataRefresh <SwitchParameter>] [-WhatIf [<SwitchParameter>]] [-WorkbookSizeMax <Int32>]

Descrizione dettagliata

Il cmdlet New-SPExcelFileLocation consente di aggiungere una nuova posizione all'elenco delle posizioni attendibili file in un'applicazione Excel Services. Excel Services carica solo le cartelle di lavoro archiviate in una posizione attendibile file. Le proprietà delle posizioni attendibili controllano il modo in cui le cartelle di lavoro possono essere utilizzate quando vengono caricate in Excel Services. Excel Services applica sempre le proprietà definite dalla posizione attendibile file da cui è stata caricata una cartella di lavoro. Le proprietà utilizzate dalla posizione attendibile file vengono determinate confrontando il percorso del file della cartella di lavoro con il parametro Address della posizione attendibile file.

La corrispondenza più lunga ha la precedenza. Ad esempio, se http://portal/sito/ e http://portal/sito/sito_secondario sono posizioni attendibili e si carica una cartella di lavoro dal sito secondario, l'applicazione utilizza le proprietà della posizione attendibile sito_secondario poiché è l'indirizzo corrispondente più lungo.

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

Address

Obbligatorio

System.String

Specifica una cartella Web o una directory di file da cui Excel Services può caricare le cartelle di lavoro.

Il tipo deve essere un URL valido, nel formato http://portal/Team o un percorso UNC valido nel formato \\nome_server\nome_cartella.

ExcelServiceApplication

Obbligatorio

Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind

Specifica l'applicazione Excel Services che contiene l'oggetto elenco SPExcelFileLocation.

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.

AbortOnRefreshOnOpenFail

Facoltativo

System.Management.Automation.SwitchParameter

Indica che il caricamento di un file Microsoft Excel viene automaticamente interrotto se un'operazione di aggiornamento automatico del file non riesce quando il file viene aperto. Il caricamento ha esito negativo solo se le seguenti condizioni sono vere:

- l'utente dispone di autorizzazioni Prodotti e tecnologie SharePoint di sola lettura per il file

- il file della cartella di lavoro utilizza connessioni dati che vengono aggiornate automaticamente quando si apre il file di Excel.

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.

AutomaticVolatileFunctionCacheLifetime

Facoltativo

System.Int32

Specifica il tempo massimo, in secondi, per cui un valore calcolato per una funzione volatile viene memorizzato nella cache per ricalcoli automatici. Tra i valori validi sono inclusi i seguenti:

-1 Esegue il calcolo una volta quando la cartella di lavoro viene caricata

0 Esegue sempre il calcolo

1 - 2073600 Memorizzati i dati nella cache per un periodo da 1 secondo a 24 giorni. Il valore intero predefinito è 300.

Il tipo deve essere l'intero -1 o 0 oppure un intero dell'intervallo da 1 a 2073600.

ChartAndImageSizeMax

Facoltativo

System.Int32

Specifica la dimensione massima, in megabyte, di un grafico o un'immagine che è possibile aprire. Il valore predefinito è 1.

Il tipo deve essere un intero valido maggiore di 0.

ConcurrentDataRequestsPerSessionMax

Facoltativo

System.Int32

Specifica il numero massimo di richieste di dati esterne che è possibile effettuare contemporaneamente in ciascuna sessione. Se in una sessione è necessario emettere un numero superiore di richieste, le richieste aggiuntive dovranno essere messe in coda. L'ambito di questa impostazione è il server logico. Il valore predefinito è 5.

Il tipo deve essere un numero intero positivo.

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

DefaultWorkbookCalcMode

Facoltativo

Microsoft.Office.Excel.Server.DefaultWorkbookCalcMode

Specifica la modalità di calcolo delle cartelle di lavoro. Le impostazioni diverse da File sostituiscono le impostazioni della cartella di lavoro. L'impostazione predefinita è File.

Il tipo deve essere uno dei seguenti valori: File, Manual, Auto o AutoDataTables.

Description

Facoltativo

System.String

Specifica una descrizione della nuova posizione file.

Il tipo deve essere una stringa valida, ad esempio il percorso dei file dei report mensili sulle vendite.

DisplayGranularExtDataErrors

Facoltativo

System.Management.Automation.SwitchParameter

Visualizza messaggi di errore dettagliati per errori di dati esterni per i file presenti in questo percorso.

ExternalDataAllowed

Facoltativo

Microsoft.Office.Excel.Server.AllowExternalData

Specifica il tipo di accesso ai dati esterni consentito per le cartelle di lavoro. None indica che l'aggiornamento dei dati è disattivato. Dcl indica che i dati vengono aggiornati solo se si utilizza un file di connessione in una raccolta di connessioni dati attendibili. DclandEmbedded indica che è possibile, ma non obbligatorio, utilizzare una raccolta di connessioni dati. L'ambito dell'impostazione è la posizione attendibile. Il valore predefinito è None.

Il tipo deve essere una delle impostazioni seguenti:

None

Dcl

DclAndEmbedded

IncludeChildren

Facoltativo

System.Management.Automation.SwitchParameter

Indica che gli URL, le directory e le raccolte subordinate sono attendibili. Ad esempio, se la posizione file attendibile è http://portal e IncludeChildren è impostato su true, anche http://portal/sito secondario è attendibile, così come tutti gli URL subordinati all'URL specificato in Address.

LocationType

Facoltativo

Microsoft.Office.Excel.Server.LocationType

Specifica il tipo di posizione. Il tipo di posizione indica in che modo Excel Services recupera i file dalla posizione specificata in Address. L'impostazione predefinita è il tipo SharePoint. Il valore predefinito è SharePoint.

Il tipo deve essere uno dei seguenti: SharePoint, UNC o HTTP.

ManualExtDataCacheLifetime

Facoltativo

System.Int32

Specifica il tempo, in secondi, atteso da Excel Services prima di emettere nuovamente una richiesta di dati esterni manuale o avviata dall'utente. Durante questo intervallo di tempo, i risultati della richiesta precedente di dati esterni possono essere restituiti da una cache dati esterni. Il valore predefinito è 300.

I valori validi sono esclusivamente quelli che seguono:

-1 I dati non vengono più aggiornati dopo la prima query. 1 to 2073600 Memorizza i dati nella cache per un periodo da 1 secondo a 24 giorni.

NewWorkbookSessionTimeout

Facoltativo

System.Int32

Specifica il tempo, in secondi, durante il quale una sessione per una cartella di lavoro nuova e non salvata rimane attiva in Excel Services senza attività dell'utente. I valori validi includono i seguenti:

-1 La sessione non scade mai.

0 La sessione scade al termine di una singola richiesta.

1 - 2073600 La sessione rimane attiva per un periodo da 1 secondo a 24 giorni. Il valore predefinito è 1800.

Il tipo deve essere -1, 0 o un intero dell'intervallo da 1 a 2073600.

PeriodicExtDataCacheLifetime

Facoltativo

System.Int32

Specifica il tempo, in secondi, di attesa di Excel Services prima di emettere nuovamente una richiesta dati esterni all'apertura o periodica (ovvero automatica). Durante questo intervallo di tempo, i risultati della richiesta precedente di dati esterni possono essere restituiti da una cache dati esterni. Il valore -1 specifica di non eseguire mai l'aggiornamento dopo la prima query. Il valore predefinito è 300.

Il tipo deve essere -1, 0 o un intero dell'intervallo da 1 a 2073600.

RequestDurationMax

Facoltativo

System.Int32

Specifica la durata massima, in secondi, di una singola richiesta in una sessione. Al termine di questo intervallo di tempo, si verifica il timeout della richiesta. Il valore predefinito è 300.

Il tipo deve essere -1 (nessun limite) o un intero dell'intervallo da 1 a 2073600.

RESTExternalDataAllowed

Facoltativo

System.Management.Automation.SwitchParameter

Specifica se per le richieste provenienti dall'API (Application Programming Interface) REST (Representational State Transfer) è consentito aggiornare le connessioni dati esterni. Il parametro RESTExternalDataAllowed non ha effetto se il parametro ExternalDataAllowed è impostato su None.

SessionTimeout

Facoltativo

System.Int32

Specifica il tempo, in secondi, durante il quale una sessione rimane attiva in Excel Services senza attività dell'utente. I valori validi includono i seguenti:

-1 La sessione non scade mai.

0 La sessione scade al termine di una singola richiesta.

1 - 2073600 La sessione rimane attiva per un periodo da 1 secondo a 24 giorni. Il valore predefinito è 300.

Il tipo deve essere -1, 0 o un intero dell'intervallo da 1 a 2073600.

ShortSessionTimeout

Facoltativo

System.Int32

Specifica il tempo, in secondi, entro il quale l'utente deve effettuare l'interazione iniziale con un foglio di calcolo. Al termine di questo intervallo di tempo, se l'utente non è attivo, la sessione viene chiusa. Il valore deve essere sempre inferiore a SessionTimeout. Se il valore ShortSessionTimeout è maggiore o uguale a SessionTimeout, viene restituito un errore. Il valore predefinito è 75.

Il tipo deve essere -1 o un intero dell'intervallo da 1 a 2073600.

UdfsAllowed

Facoltativo

System.Management.Automation.SwitchParameter

Specifica che le funzioni definite dall'utente possono essere chiamate dalle cartelle di lavoro caricate dalla posizione file attendibile specificata in Address.

Il valore predefinito è False.

WarnOnDataRefresh

Facoltativo

System.Management.Automation.SwitchParameter

Indica che viene visualizzato un avviso per l'utente quando i dati vengono aggiornati per la prima volta per la cartella di lavoro. Il valore predefinito è True.

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

WorkbookSizeMax

Facoltativo

System.Int32

Specifica la dimensione massima, in megabyte, di una cartella di lavoro che è possibile caricare. Il valore predefinito è 10.

Il tipo deve essere un valore intero dell'intervallo da 1 a 2000.

Tipi di input

Tipi restituiti

Example

--------------ESEMPIO 1--------------

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "http://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

In questo esempio viene aggiunta una nuova posizione attendibile file all'elenco delle posizioni attendibili nell'applicazione Excel Services denominata MyExcelService.

Nell'esempio viene consentito il caricamento delle cartelle di lavoro da qualsiasi elemento figlio o sottocartella che inizia con http://myPortal/myTeam. Tutte le cartelle di lavoro caricate da questa posizione devono avere dimensioni inferiori a 50 megabyte (MB). Per aggiornare i dati esterni, è possibile utilizzare le connessioni incorporate nei file delle cartelle di lavoro o archiviate in una raccolta di connessioni dati. Non verranno visualizzati messaggi di avviso per segnalare che una cartella di lavoro sta tentando di aggiornare i dati esterni.

--------------ESEMPIO 2--------------

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address http://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."

In questo esempio viene aggiunta una nuova posizione attendibile file all'elenco delle posizioni attendibili nell'applicazione Excel Services denominata MyExcelService con un indirizzo specifico e una descrizione.