Set-SPExcelServiceApplication

Imposta le proprietà globali per l'applicazione Excel Services.

Sintassi

Set-SPExcelServiceApplication
   [[-Identity] <SPExcelServiceApplicationPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
   [-ExternalDataConnectionLifetime <Int32>]
   [-FileAccessMethod <FileAccessMethod>]
   [-LoadBalancingScheme <LoadBalancingScheme>]
   [-MemoryCacheThreshold <Int32>]
   [-PrivateBytesMax <Int32>]
   [-SessionsPerUserMax <Int32>]
   [-SiteCollectionAnonymousSessionsMax <Int32>]
   [-TerminateProcessOnAccessViolation]
   [-ThrottleAccessViolationsPerSiteCollection <Int32>]
   [-UnattendedAccountApplicationId <String>]
   [-UnusedObjectAgeMax <Int32>]
   [-WhatIf]
   [-WorkbookCache <String>]
   [-WorkbookCacheSizeMax <Int32>]
   [-UseEffectiveUserName]
   [-WorkbookModelUsageTracker <String>]
   [<CommonParameters>]
Set-SPExcelServiceApplication
   [[-Identity] <SPExcelServiceApplicationPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-CachingOfUnusedFilesEnable]
   [-Confirm]
   [-CrossDomainAccessAllowed]
   [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
   [-ExternalDataConnectionLifetime <Int32>]
   [-FileAccessMethod <FileAccessMethod>]
   [-LoadBalancingScheme <LoadBalancingScheme>]
   [-MemoryCacheThreshold <Int32>]
   [-PrivateBytesMax <Int32>]
   [-SessionsPerUserMax <Int32>]
   [-SiteCollectionAnonymousSessionsMax <Int32>]
   [-TerminateProcessOnAccessViolation]
   [-ThrottleAccessViolationsPerSiteCollection <Int32>]
   [-UnusedObjectAgeMax <Int32>]
   [-WhatIf]
   [-WorkbookCache <String>]
   [-WorkbookCacheSizeMax <Int32>]
   [-UnattendedServiceAccount <PSCredential>]
   [-UseEffectiveUserName]
   [-WorkbookModelUsageTracker <String>]
   [<CommonParameters>]

Descrizione

Il Set-ExcelServiceApplication cmdlet modifica le proprietà di runtime globali per Excel Services'applicazione. Le modifiche alle proprietà apportate tramite questo cmdlet influiscono su tutti i computer della farm che eseguono un'istanza dell'applicazione del servizio Web applicazione Excel Services specificata.

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

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -SessionsPerUserMax 10

In questo esempio viene impostata l'applicazione Excel Services per consentire a ogni utente di aprire non più di 10 sessioni contemporaneamente in un server applicazioni back-end che esegue Excel Services'applicazione.

---------------ESEMPIO 2 --------------

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1

In questo esempio il numero massimo di byte privati di memoria nel computer viene impostato sul valore -1, che indica che Excel Services'applicazione utilizzerà il 50% delle risorse di memoria disponibili.

Parametri

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-CachingOfUnusedFilesEnable

Specifica che i file non più usati da Excel Services'applicazione possono rimanere nella cache per un uso successivo. L'impostazione predefinita è True se il parametro non viene specificato nel comando.

Type:SwitchParameter
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-CrossDomainAccessAllowed

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.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-EncryptedUserConnectionRequired

Richiede l'uso della crittografia tra l'utente finale e il server che esegue Excel Services'applicazione. L'ambito di questa impostazione è il server logico. Il valore predefinito è None.

Il tipo deve essere uno dei seguenti valori: None o Connection.

Type:EncryptedConnectionMode
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ExternalDataConnectionLifetime

Specifica il numero massimo di secondi per i quali una connessione dati esterna può rimanere aperta nel pool di connessioni.

I valori validi sono:

-1 Nessun riciclaggio

Da 1 a 2073600 Resta attivo da 1 secondo a 24 giorni.

Il valore predefinito è 1800.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-FileAccessMethod

Specifica il metodo di autenticazione utilizzato Excel Services'applicazione per recuperare i file. UseFileAccessAccount specifica che tutte le cartelle di lavoro usano sempre le credenziali dell'account del servizio in esecuzione Excel Services'applicazione. UseImpersonation specifica che Excel Services'applicazione recupera i file della cartella di lavoro come utente che effettua la richiesta. Il valore predefinito è UseImpersonation.

Il tipo deve essere uno dei seguenti valori: UseImpersonation o UseFileAccessAccount.

Type:FileAccessMethod
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Identity

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 del servizio Web applicazione Excel Services nella farm (ad esempio MyExcelService1) o un'istanza di un oggetto SPExcelServiceApplication valido.

Type:SPExcelServiceApplicationPipeBind
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-LoadBalancingScheme

Specifica lo schema di bilanciamento del carico utilizzato dall'applicazione del servizio Web applicazione Excel Services per inviare richieste a diversi computer back-end Excel Services applicazioni. Il valore predefinito è WorkbookURL.

Il tipo deve essere uno dei seguenti valori: RoundRobin, Local o WorkbookURL.

Type:LoadBalancingScheme
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-MemoryCacheThreshold

Specifies the percentage of the maximum private bytes that can be allocated to inactive objects. When the memory cache threshold is exceeded, cached objects that are not currently in use are released. Setting this value to 0 disables caching of inactive objects. The default value is 90.

Il tipo deve essere un intero dell'intervallo da 0 a 95.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-PrivateBytesMax

Specifica il numero massimo di byte privati, in megabyte, utilizzati da Excel Services'applicazione. Se il valore è impostato su -1, il numero massimo di byte privati per impostazione predefinita sarà pari al 50% del 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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-SessionsPerUserMax

Specifies the maximum number of sessions allowed for a user. If a user reaches this maximum the oldest session is deleted when a new session is started. Valid values include -1 for no limit, and any positive integer. The default value is 25.

Il tipo deve essere -1 o qualsiasi intero positivo.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-SiteCollectionAnonymousSessionsMax

Specifies the maximum number of anonymous sessions allowed per site collection. A value of 0 specifies that no anonymous sessions are allowed. Valid values include -1 for no limit, 0 to disable the setting, or any positive integer. The default value is 25.

Il tipo deve essere -1, 0 o qualsiasi intero positivo.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-TerminateProcessOnAccessViolation

Termina Excel Services'applicazione quando si verifica una violazione di accesso nel processo.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ThrottleAccessViolationsPerSiteCollection

Specifica che se una cartella di lavoro causa un errore di violazione di accesso in Excel Services'applicazione, a tutti i file provenienti dalla raccolta siti della cartella di lavoro viene impedito il caricamento per il periodo 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.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UnattendedAccountApplicationId

Specifies that the application ID that is used to look up the unattended service account credentials from the secure storage service that is specified by the UnattendedAccountSecureServiceAppName parameter. The secure storage service is contacted when this parameter is set and specific error cases occur. Valid values are alphanumeric strings with a maximum of 256 characters. The default value is an empty string.

Il tipo deve essere una stringa valida di caratteri alfanumerici, ad esempio IDAccountServizioAutomatico.

The unattended account is a single account that all workbooks can use to refresh data. An unattended account is required when workbook connections specify None for authentication, or when any non-Windows credentials are used to refresh data.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UnattendedServiceAccount

L'account del servizio automatico è un singolo account che tutte le cartelle di lavoro possono usare per aggiornare i dati. Questo account è necessario per aggiornare i dati quando le connessioni della cartella di lavoro specificano "Usa l'account del servizio automatico" senza usare le credenziali di Windows.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013

-UnusedObjectAgeMax

Specifies the maximum amount of time, in minutes, that objects not currently used in a session are kept in the memory cache. Valid values include -1 for no maximum setting, and a positive integer in the range of 1 to 34560 minutes (24 days). The default value is -1.

Il tipo deve essere -1 o un intero dell'intervallo da 1 a 34560.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UseEffectiveUserName

La proprietà UseEffectiveUserName è un'alternativa alla delega di Windows per consentire agli utenti di accedere in modo sicuro ai dati di Analysis Services.

L'impostazione influirà solo sulle connessioni dati esterne in base alle connessioni alla cartella di lavoro di Analysis Services con l'impostazione di autenticazione "Usare l'account dell'utente autenticato".

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WorkbookCache

Specifica il percorso del file system locale della cache utilizzata per archiviare le cartelle di lavoro utilizzate da Excel Services'applicazione.

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:\folder_name -- \\server_name\folder_name

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WorkbookCacheSizeMax

Specifica la dimensione massima consentita, espressa in megabyte, per una singola sessione. Il valore predefinito è 0.

Il tipo deve essere un numero intero positivo.

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-WorkbookModelUsageTracker

{{Fill WorkbookModelUsageTracker Description}}

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013