Set-SPExcelFileLocation

Sintassi

Default (Impostazione predefinita)

Set-SPExcelFileLocation
    [-Identity] <SPExcelFileLocationPipeBind>
    -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
    [-AbortOnRefreshOnOpenFail]
    [-Address <String>]
    [-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-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl

ESEMPIO 2

Get-SPExcelServiceApplication | Get-SPExcelFileLocation | where {$_.Address -eq "https://"} | Set-SPExcelFileLocation -Description "This is the default trusted file location for Excel Services Application. It allows any file from anywhere in SharePoint to load."

Parametri

-AbortOnRefreshOnOpenFail

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica che il caricamento di un file dell'applicazione di Excel Services ha esito negativo 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 dell'applicazione Excel Services. -- il file della cartella di lavoro utilizza connessioni dati che vengono aggiornate automaticamente quando il file di Excel viene aperto.

Proprietà dei parametri

Set di parametri

-Address

Applicabile: SharePoint Server 2010, SharePoint Server 2013

System.String

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, 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.

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

Tempo massimo (in secondi) impiegato per il rendering di un singolo grafico.

Valori validi: -1 (nessun limite); da 1 a 2073600 (24 giorni).

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. Tutte le impostazioni tranne File hanno la precedenza sulle impostazioni delle cartelle di lavoro. Se questo parametro viene modificato, viene applicato a tutte le nuove sessioni nell'applicazione Excel Services quando la cache delle proprietà di ConfigDB viene aggiornata. 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: Nessuno specifica che l'aggiornamento dei dati è disabilitato. 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.

Proprietà dei parametri

Set di parametri

-Identity

Applicabile: SharePoint Server 2010, SharePoint Server 2013

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 identifica il percorso del file, nel formato https://myPortal/myTeam; una stringa valida che identifica il percorso, nel formato C:\folder_name; o un'istanza di un oggetto SPExcelFileLocation valido.

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, allora https://portal/subSite è attendibile, così come qualsiasi URL secondario nell'URL specificato in Indirizzo.

Proprietà dei parametri

Set di parametri

-LocationType

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Il tipo di posizione. LocationType indica in che modo l'applicazione Excel Services recupera i file dal percorso specificato in Indirizzo. 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 potrebbero essere restituiti da una cache dati esterni.

I valori validi sono:

-1 Non aggiornare mai dopo la prima query

Da 1 a 2073600 Cache da 1 secondo a 24 giorni.

Il valore predefinito è 300.

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 rimarrà attiva nell'applicazione Excel Services senza attività utente. Il valore predefinito è 1800. 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, rimangono attive da 1 secondo a 24 giorni.

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 tipo deve essere -1, 0 o un intero dell'intervallo da 1 a 2073600.

Il valore predefinito è 300.

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. 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.

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 alcun effetto se il parametro External DataAllowed è impostato su None.

Proprietà dei parametri

Set di parametri

-SessionTimeout

Applicabile: SharePoint Server 2010, SharePoint Server 2013

Specifica il tempo in secondi durante il quale una sessione rimarrà attiva nell'applicazione Excel Services senza attività da parte dell'utente. Il valore predefinito è 300 secondi. Il valore predefinito è 300. Tra i valori validi sono inclusi:

-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.

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 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.

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.

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