New-SPExcelFileLocation
Aggiunge un nuovo percorso attendibile all'applicazione Excel Services.
Sintassi
New-SPExcelFileLocation
-Address <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AbortOnRefreshOnOpenFail]
[-AssignmentCollection <SPAssignmentCollection>]
[-AutomaticVolatileFunctionCacheLifetime <Int32>]
[-ChartAndImageSizeMax <Int32>]
[-ConcurrentDataRequestsPerSessionMax <Int32>]
[-Confirm]
[-DefaultWorkbookCalcMode <DefaultWorkbookCalcMode>]
[-Description <String>]
[-DisplayGranularExtDataErrors]
[-ExternalDataAllowed <AllowExternalData>]
[-IncludeChildren]
[-LocationType <LocationType>]
[-ManualExtDataCacheLifetime <Int32>]
[-NewWorkbookSessionTimeout <Int32>]
[-PeriodicExtDataCacheLifetime <Int32>]
[-RequestDurationMax <Int32>]
[-RESTExternalDataAllowed]
[-SessionTimeout <Int32>]
[-ShortSessionTimeout <Int32>]
[-UdfsAllowed]
[-WarnOnDataRefresh]
[-WhatIf]
[-WorkbookSizeMax <Int32>]
[-ChartRenderDurationMax <Int32>]
[<CommonParameters>] Descrizione
Il New-SPExcelFileLocation cmdlet aggiunge un nuovo percorso all'elenco di percorsi di file attendibili in un'applicazione del servizio Web applicazione Excel Services.
Excel Services'applicazione carica solo le cartelle di lavoro archiviate in un percorso di file attendibile.
Le proprietà dei percorsi di file attendibili controllano il modo in cui le cartelle di lavoro possono essere usate quando caricate in Excel Services'applicazione.
Excel Services'applicazione applica sempre le proprietà definite dal percorso del file attendibile 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 https://portal/site/ e https://portal/site/subsite sono percorsi attendibili e si carica una cartella di lavoro dal sito secondario, l'applicazione usa le proprietà del percorso attendibile del sito secondario perché ha l'indirizzo corrispondente più lungo.
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------------------
Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$falseIn questo esempio viene aggiunto un nuovo percorso di file attendibile all'elenco dei percorsi di file attendibili presenti nell'applicazione del servizio Web applicazione Excel Services denominata MyExcelService.
In questo esempio le cartelle di lavoro vengono caricate da qualsiasi cartella figlio o sottocartella che inizia con https://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 https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."In questo esempio viene aggiunto un nuovo percorso di file attendibile all'elenco dei percorsi di file attendibili presenti nell'applicazione del servizio Web applicazione Excel Services denominata MyExcelService con un indirizzo e una descrizione specificati.
Parametri
-AbortOnRefreshOnOpenFail
Specifica che il caricamento di un file dell'applicazione Excel Services ha esito negativo automaticamente se un'operazione di aggiornamento automatico dei dati non riesce all'apertura del file. Il caricamento ha esito negativo solo se le seguenti condizioni sono vere:
- L'utente dispone delle autorizzazioni di sola lettura del prodotto e delle tecnologie SharePoint per il file.
- Il file della cartella di lavoro include connessioni dati che vengono aggiornate automaticamente quando viene aperto il file dell'applicazione Excel Services.
| 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 |
-Address
Specifica una cartella Web o una directory di file da cui Excel Services'applicazione può caricare cartelle di lavoro.
Il tipo deve essere un URL valido nel formato https://myPortal/myTeamoppure un percorso UNC valido nel formato \\server_name\folder_name
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-AutomaticVolatileFunctionCacheLifetime
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:
-1 Calcola una volta quando viene caricata la cartella di lavoro.
0 Calcola sempre.
Da 1 a 2073600 Cache 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartAndImageSizeMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartRenderDurationMax
{{Fill ChartRenderDurationMax Description}}
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ConcurrentDataRequestsPerSessionMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-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.
| Type: | DefaultWorkbookCalcMode |
| 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 della nuova posizione file.
Il tipo deve essere una stringa valida, ad esempio il percorso dei file dei report mensili sulle vendite.
| 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 |
-DisplayGranularExtDataErrors
Visualizza messaggi di errore dettagliati per errori di dati esterni per i file presenti in questo percorso.
| 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 il Excel Services'applicazione del servizio Web applicazione 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 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 |
-ExternalDataAllowed
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:
Nessuno
Dcl
DclAndEmbedded
| Type: | AllowExternalData |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-IncludeChildren
Indica che gli URL, le directory e le raccolte subordinate sono attendibili. Ad esempio, se il percorso del file attendibile è https://portal e IncludeChildren è true, https://portal/subSite è considerato attendibile, così come qualsiasi URL subordinato all'URL specificato in Address.
| 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 |
-LocationType
Specifica il tipo di posizione. Il tipo di percorso indica come Excel Services'applicazione recupera i file dal percorso specificato in Indirizzo. L'impostazione predefinita è il tipo SharePoint. Il valore predefinito è SharePoint.
Il tipo deve essere uno dei seguenti: SharePoint, UNC o HTTP.
| Type: | LocationType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ManualExtDataCacheLifetime
Specifica il tempo, in secondi, che Excel Services'applicazione attende prima che eseguire di nuovo una richiesta di dati esterna 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. Da 1 a 2073600 Memorizza i dati nella cache per un intervallo di tempo compreso tra 1 secondo e 24 giorni.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-NewWorkbookSessionTimeout
Specifica il tempo, in secondi, in cui una sessione per una nuova cartella di lavoro non salvata rimane attiva in Excel Services'applicazione senza attività utente. Tra i valori validi sono inclusi:
-1 La sessione non scade mai.
0 La sessione scade alla fine di una singola richiesta.
Da 1 a 2073600 Rimane attivo 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-PeriodicExtDataCacheLifetime
Specifica il tempo, espresso in secondi, che Excel Services'applicazione attende prima di eseguire nuovamente una richiesta di dati esterni on-open 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RequestDurationMax
Specifica la durata massima, in secondi, di una singola richiesta in una sessione. Al termine di questo intervallo di tempo, la richiesta scade. Il valore predefinito è 300.
Il tipo deve essere -1 (nessun limite) o un intero dell'intervallo da 1 a 2073600.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RESTExternalDataAllowed
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.
| 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 |
-SessionTimeout
Specifica il tempo, in secondi, in cui una sessione rimane attiva in Excel Services'applicazione senza attività utente. Tra i valori validi sono inclusi:
-1 La sessione non scade mai.
0 sessione scade alla fine di una singola richiesta.
Da 1 a 2073600 Rimane attivo 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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ShortSessionTimeout
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UdfsAllowed
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.
| 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 |
-WarnOnDataRefresh
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.
| 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 |
-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 |
-WorkbookSizeMax
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.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per