Set-SPExcelServiceApplication
Si applica a: SharePoint Server 2010
Ultima modifica dell'argomento: 2015-03-09
Imposta le proprietà globali per Excel Services in Microsoft SharePoint Server 2010.
Syntax
Set-SPExcelServiceApplication [[-Identity] <SPExcelServiceApplicationPipeBind>] [-AssignmentCollection <SPAssignmentCollection>] [-CachingOfUnusedFilesEnable <SwitchParameter>] [-Confirm [<SwitchParameter>]] [-CrossDomainAccessAllowed <SwitchParameter>] [-EncryptedUserConnectionRequired <None | Connection>] [-ExternalDataConnectionLifetime <Int32>] [-FileAccessMethod <UseImpersonation | UseFileAccessAccount>] [-LoadBalancingScheme <WorkbookUrl | RoundRobin | Local>] [-MemoryCacheThreshold <Int32>] [-PrivateBytesMax <Int32>] [-SessionsPerUserMax <Int32>] [-SiteCollectionAnonymousSessionsMax <Int32>] [-TerminateProcessOnAccessViolation <SwitchParameter>] [-ThrottleAccessViolationsPerSiteCollection <Int32>] [-UnattendedAccountApplicationId <String>] [-UnusedObjectAgeMax <Int32>] [-WhatIf [<SwitchParameter>]] [-WorkbookCache <String>] [-WorkbookCacheSizeMax <Int32>]
Descrizione dettagliata
Il cmdlet Set-ExcelServiceApplication consente di modificare le proprietà globali di runtime per Excel Services. Le modifiche apportate alle proprietà mediante questo cmdlet hanno effetto su tutti i computer della farm che eseguono un'istanza dell'applicazione Excel Services specificata.
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 |
Facoltativo |
Microsoft.Office.Excel.Server.Cmdlet.SPExcelServiceApplicationPipeBind |
Specifica l'oggetto SPExcelServiceApplication da aggiornare. 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. |
ApplicationPool |
Facoltativo |
Microsoft.SharePoint.PowerShell.SPIisWebServiceApplicationPoolPipeBind |
Specifica il pool di applicazioni IIS esistente come nome per l'applicazione Excel Services. Il tipo deve essere un'istanza valida di oggetto SPIisWebServiceApplicationPool valido. |
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. |
CachingOfUnusedFilesEnable |
Facoltativo |
System.Management.Automation.SwitchParameter |
Specifica che i file non più utilizzati da Excel Services possono rimanere nella cache per essere utilizzati in un secondo tempo. L'impostazione predefinita è True se il parametro non viene specificato nel comando. |
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 |
CrossDomainAccessAllowed |
Facoltativo |
System.Management.Automation.SwitchParameter |
Indica che è possibile richiedere e visualizzare le cartelle di lavoro e i file di connessione dati attendibili in web part o pagine che risiedono in altri domini HTTP. |
EncryptedUserConnectionRequired |
Facoltativo |
Microsoft.Office.Excel.Server.EncryptedConnectionMode |
Richiede l'uso della crittografia tra l'utente finale e il server Microsoft Excel. L'ambito di questa impostazione è il server logico. Il valore predefinito è None. Il tipo deve essere uno dei valori seguenti: None o Connection. |
ExternalDataConnectionLifetime |
Facoltativo |
System.Int32 |
Specifica il numero massimo di secondi per i quali una connessione dati esterna può rimanere aperta nel pool di connessioni. I valori validi sono i seguenti: -1 Nessun riciclaggio 1 to 2073600 Rimane attiva per un periodo da 1 secondo a 24 giorni. Il valore predefinito è 1800. |
FileAccessMethod |
Facoltativo |
Microsoft.Office.Excel.Server.FileAccessMethod |
Specifica il metodo di autenticazione utilizzato da Excel Services per recuperare i file. UseFileAccessAccount indica che tutte le cartelle di lavoro utilizzano sempre le credenziali dell'account di servizio che esegue Excel Services. UseImpersonation indica che Excel Services recupera i file delle cartelle di lavoro come se fosse l'utente a fare la richiesta. Il valore predefinito è UseImpersonation. Il tipo deve essere uno dei seguenti: UseImpersonation o UseFileAccessAccount. |
LoadBalancingScheme |
Facoltativo |
Microsoft.Office.Excel.Server.LoadBalancingScheme |
Specifica lo schema di bilanciamento del carico utilizzato dall'applicazione Excel Services per inviare richieste a computer Excel Services back-end. Il valore predefinito è WorkbookURL. Il tipo deve essere uno dei seguenti valori: RoundRobin, Local o WorkbookURL. |
MemoryCacheThreshold |
Facoltativo |
System.Int32 |
Specifica la percentuale del numero massimo di byte privati che è possibile allocare agli oggetti non attivi. Quando viene superata la soglia della cache di memoria, gli oggetti memorizzati nella cache attualmente non utilizzati vengono eliminati. Se il valore è impostato su 0, viene disattivata la memorizzazione nella cache degli oggetti non attivi. Il valore predefinito è 90. Il tipo deve essere un intero dell'intervallo da 0 a 95. |
PrivateBytesMax |
Facoltativo |
System.Int32 |
Specifica il numero massimo di byte privati, in megabyte, utilizzati da Excel Services. Se il valore è impostato su -1, il numero massimo di byte privati per impostazione predefinita sarà pari al 50% della memoria fisica del computer. I valori validi includono -1 (nessun limite) e qualsiasi numero intero positivo. Il valore predefinito è -1. Il tipo deve essere -1 o qualsiasi intero positivo. |
SessionsPerUserMax |
Facoltativo |
System.Int32 |
Specifica il numero massimo di sessioni consentite per un utente. Se un utente raggiunge il valore massimo, la sessione più datata viene eliminata all'avvio di una nuova sessione. I valori validi includono -1 (nessun limite) e qualsiasi numero intero positivo. Il valore predefinito è 25. Il tipo deve essere -1 o qualsiasi intero positivo. |
SiteCollectionAnonymousSessionsMax |
Facoltativo |
System.Int32 |
Specifica il numero massimo di sessioni anonime consentito per raccolta siti. Il valore 0 indica che non sono consentite sessioni anonime. I valori validi includono -1 (nessun limite), 0 (disattiva l'impostazione) o qualsiasi numero intero positivo. Il valore predefinito è 25. Il tipo deve essere -1, 0 o qualsiasi intero positivo. |
TerminateProcessOnAccessViolation |
Facoltativo |
System.Management.Automation.SwitchParameter |
Termina Excel Services quando si verifica una violazione di accesso durante il processo. |
ThrottleAccessViolationsPerSiteCollection |
Facoltativo |
System.Int32 |
Specifica che se una cartella di lavoro causa un errore di violazione di accesso in Excel Services, verrà bloccato il caricamento di tutti i file originati dalla raccolta siti di quella cartella di lavoro per il periodo di tempo specificato (in secondi). Le sessioni già in corso per i file della raccolta siti non sono interessate. I valori validi includono 0, per disattivare l'impostazione, e l'intervallo da 1 a 2073600 secondi (24 giorni). Il valore predefinito è 0. Il tipo deve essere un valore intero dell'intervallo da 0 a 2073600. |
UnattendedAccountApplicationId |
Facoltativo |
System.String |
Specifica l'ID applicazione utilizzato per la ricerca delle credenziali dell'account di servizio automatico nel servizio di archiviazione sicura specificato dal parametro UnattendedAccountSecureServiceAppName. Il servizio di archiviazione sicura viene contattato quando questo parametro è impostato e si verificano determinate situazioni di errore. I valori validi sono stringhe alfanumeriche contenenti al massimo 256 caratteri. Il valore predefinito è una stringa vuota. Il tipo deve essere una stringa valida di caratteri alfanumerici, ad esempio IDAccountServizioAutomatico. Nota L'account automatico è un singolo account utilizzato da tutte le cartelle di lavoro per aggiornare i dati ed è necessario quando per le connessioni delle cartelle di lavoro viene specificato il valore None per l'autenticazione o si utilizzano credenziali non Windows per aggiornare i dati. |
UnusedObjectAgeMax |
Facoltativo |
System.Int32 |
Specifica la durata massima, in minuti, dell'intervallo di tempo in cui gli oggetti attualmente non utilizzati in una sessione vengono conservati nella cache di memoria. Tra i valori validi sono inclusi -1 (nessuna impostazione) e un intero positivo dell'intervallo da 1 a 34560 minuti (24 giorni). Il valore predefinito è -1. Il tipo deve essere -1 o un intero dell'intervallo da 1 a 34560. |
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 |
WorkbookCache |
Facoltativo |
System.String |
Specifica la posizione nel file system locale della cache utilizzata per la memorizzazione delle cartelle di lavoro utilizzate da Excel Services. Se non viene specificato alcun valore, il valore predefinito è una sottodirectory della directory temporanea del sistema. Il tipo deve essere un percorso valido in uno dei formati seguenti: -- C:\nome_cartella -- \\nome_server\nome_cartella |
WorkbookCacheSizeMax |
Facoltativo |
System.Int32 |
Specifica la dimensione massima consentita, in megabyte, di una singola sessione. Il valore predefinito è 0. Il tipo deve essere un numero intero positivo. |
Tipi di input
Tipi restituiti
Example
--------------ESEMPIO 1--------------
Set-SPExcelServiceApplication ExcelServiceTestApplication -sessionsperusermax 10
In questo esempio viene impostata l'applicazione Excel Services denominata ExcelServiceTestApplication per consentire a ciascun utente di aprire non più di 10 sessioni alla volta su un server applicazioni back-end che esegue Excel Services.
--------------ESEMPIO 2--------------
Get-SPExcelServiceApplication | where{ $_.privatebytesmax -ne -1 } | Set-SPExcelServiceApplication -PrivateBytesMax -1
In questo esempio viene visualizzata ogni applicazione Excel Services eseguita nella farm che utilizza un valore specificato dall'utente per il numero massimo di byte privati di memoria nel computer, quindi tale valore viene impostato su -1 per indicare che Excel Services utilizzerà il 50% delle risorse di memoria disponibili.