New-SPExcelFileLocation

Sintassi

Default (Impostazione predefinita)

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

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

ESEMPIO 2

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

Parametri

-AbortOnRefreshOnOpenFail

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica che il caricamento di un file di applicazione di Excel Services non riesce automaticamente se un'operazione di aggiornamento automatico dei dati 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 per il file di Prodotti e tecnologie SharePoint.
• Il file della cartella di lavoro dispone di connessioni dati che vengono aggiornate automaticamente all'apertura del file dell'applicazione Excel Services.

Proprietà dei parametri

Set di parametri

-Address

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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

Il tipo deve essere un URL valido nel formato https://myPortal/myTeam; oppure un percorso UNC valido nel formato \\server_name\folder_name

Proprietà dei parametri

Set di parametri

-AssignmentCollection

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-AutomaticVolatileFunctionCacheLifetime

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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 il caricamento della 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.

Proprietà dei parametri

Set di parametri

-ChartAndImageSizeMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-ChartRenderDurationMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

{{Fill ChartRenderDurationMax Description}}

Proprietà dei parametri

Set di parametri

-ConcurrentDataRequestsPerSessionMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-Confirm

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Set di parametri

-DefaultWorkbookCalcMode

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-Description

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-DisplayGranularExtDataErrors

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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

Proprietà dei parametri

Set di parametri

-ExcelServiceApplication

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica l'applicazione del servizio Web dell'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 del servizio Web di Excel Services nella farm, ad esempio MyExcelService1 oppure un'istanza di un oggetto SPExcelServiceApplication valido.

Proprietà dei parametri

Set di parametri

-ExternalDataAllowed

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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

Proprietà dei parametri

Set di parametri

-IncludeChildren

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Indica che gli URL, le directory e le raccolte subordinate sono attendibili. Ad esempio, se il percorso file attendibile è https://portal e IncludeChildren è true, https://portal/subSite anche questo è attendibile, così come qualsiasi URL subordinato all'URL specificato in Address.

Proprietà dei parametri

Set di parametri

-LocationType

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il tipo di posizione. Il tipo di percorso indica il modo in cui l'applicazione Excel Services 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.

Proprietà dei parametri

Set di parametri

-ManualExtDataCacheLifetime

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il tempo, in secondi, che l'applicazione Excel Services attende 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. Da 1 a 2073600 Memorizza i dati nella cache per un intervallo di tempo compreso tra 1 secondo e 24 giorni.

Proprietà dei parametri

Set di parametri

-NewWorkbookSessionTimeout

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il tempo, in secondi, durante il quale una sessione per una nuova cartella di lavoro non salvata rimane attiva nell'applicazione Excel Services senza alcuna attività da parte dell'utente. Tra i valori validi sono inclusi:

-1 La sessione non scade mai.

0: la sessione scade al termine 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.

Proprietà dei parametri

Set di parametri

-PeriodicExtDataCacheLifetime

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il tempo, in secondi, che l'applicazione Excel Services attende prima di emettere nuovamente una richiesta di dati esterni aperta o periodica, ossia 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.

Proprietà dei parametri

Set di parametri

-RequestDurationMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica la durata massima, in secondi, di una singola richiesta in una sessione. Trascorso questo periodo, la richiesta scade. Il valore predefinito è 300.

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

Proprietà dei parametri

Set di parametri

-RESTExternalDataAllowed

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-SessionTimeout

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il tempo, in secondi, in cui una sessione rimane attiva nell'applicazione Excel Services senza attività utente. Tra i valori validi sono inclusi:

-1 La sessione non scade mai.

0 la sessione scade al termine 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.

Proprietà dei parametri

Set di parametri

-ShortSessionTimeout

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-UdfsAllowed

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-WarnOnDataRefresh

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

-WhatIf

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Set di parametri

-WorkbookSizeMax

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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.

Proprietà dei parametri

Set di parametri

CommonParameters