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.