Set-SPExcelFileLocation
Si applica a: SharePoint Server 2010
Ultima modifica dell'argomento: 2015-03-09
Imposta le proprietà di un percorso attendibile file per Excel Services in Microsoft SharePoint Server 2010.
Syntax
Set-SPExcelFileLocation [-Identity] <SPExcelFileLocationPipeBind> -ExcelServiceApplication <SPExcelServiceApplicationPipeBind> [-AbortOnRefreshOnOpenFail <SwitchParameter>] [-Address <String>] [-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 Set-SPExcelFileLocation consente di impostare le proprietà di una posizione da cui Excel Services carica le cartelle di lavoro. Excel Services carica solo le cartelle di lavoro archiviate in una posizione attendibile file. Le proprietà delle posizioni attendibili file controllano in che modo possono essere utilizzate le cartelle di lavoro 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 sono determinate in base al confronto del percorso del file della cartella di lavoro con il parametro Address della posizione attendibile file.
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 |
|---|---|---|---|
Identity |
Required |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelFileLocationPipeBind |
Specifica l'oggetto FileLocation da aggiornare. Il nome deve essere univoco nell'elenco delle posizioni file. Il tipo deve essere un GUID valido, nel formato 12345678-90ab-cdef-1234-567890bcdefgh, una stringa valida che identifichi la posizione file, nel formato http://portal/Team, una stringa valida che identifichi il percorso, nel formato C:\nome_cartella, o un'istanza di un oggetto SPExcelFileLocation valido. |
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 delle autorizzazioni di sola lettura di Windows SharePoint per il file Excel -- il file della cartella di lavoro utilizza connessioni dati che vengono aggiornate automaticamente quando il file di Excel viene aperto. |
Address |
Facoltativo |
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 |
|
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, memorizzazione nella cache per un periodo da 1 secondo a 24 giorni 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. Tutte le impostazioni tranne File hanno la precedenza sulle impostazioni delle cartelle di lavoro. Se questo parametro viene modificato, la modifica verrà applicata a tutte le nuove sessioni in Excel Services quando la cache delle proprietà ConfigDB viene aggiornata. L'impostazione predefinita è File. Il tipo deve essere uno dei seguenti: 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 uno dei seguenti: None, Dcl o 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/subSite è attendibile, così come tutti gli URL secondari dell'URL specificato in Address. |
LocationType |
Facoltativo |
Microsoft.Office.Excel.Server.LocationType |
Il tipo di posizione. LocationType indica in che modo Excel Services recupera i file dalla posizione specificata in Address. Il valore predefinito è SharePoint. Il tipo deve essere uno dei seguenti valori: 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 potrebbero essere restituiti da una cache dati esterni. I valori validi sono i seguenti: -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. Il valore predefinito è 300. |
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. Il valore predefinito è 1800. I valori validi includono i seguenti: -1, la sessione non scade mai 0, la sessione scade al termine di una singola richiesta 1 to 2073600, la sessione rimane attiva per un periodo da 1 secondo a 24 giorni. 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 di 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 tipo deve essere -1, 0 o un intero dell'intervallo da 1 a 2073600. Il valore predefinito è 300. |
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 tipo deve essere -1 (nessun limite) o un intero dell'intervallo da 1 a 2073600. Il valore predefinito è 300. |
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 External DataAllowed è impostato su None. |
SessionTimeout |
Facoltativo |
System.Int32 |
Specifica il tempo, in secondi, in cui una sessione rimane attiva in Excel Services senza attività dell'utente. L'impostazione predefinita è 300 secondi, il valore predefinito è 300. I valori validi includono i seguenti: -1, la sessione non scade mai 0, la sessione scade al termine di una singola richiesta 1 to 2073600, la sessione rimane attiva per un periodo da 1 secondo a 24 giorni. 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 eseguire 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. |
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-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl
In questo esempio viene utilizzata ogni posizione file attendibile per l'applicazione Excel Services denominata My Excel Service che consente alle connessioni dati di eseguire il caricamento dai file delle cartelle di lavoro e si specifica che le posizioni devono utilizzare una raccolta di connessioni dati per caricare le connessioni dati.
--------------ESEMPIO 2--------------
Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "http://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services. It allows any file from anywhere in SharePoint to load."
In questo esempio viene modificata la descrizione della posizione file predefinita per ogni applicazione Excel Services nella farm.