Configurer les paramètres d’administration d’Excel OnlineConfigure Excel Online administrative settings

Résumé : Configurez les paramètres d'administration pour les classeurs Excel affichés dans Excel Online.Summary: Configure administrative settings for Excel workbooks rendered in Excel Online.

Vous pouvez utiliser plusieurs paramètres pour personnaliser Excel Online. Ces paramètres vous aident à ajuster l'utilisation des ressources de votre batterie de serveurs Office Online Server et à appliquer certaines des stratégies de gouvernance de votre organisation.There are several settings that you can use to customize Excel Online. These settings help you adjust the resource usage of your Office Online Server farm and enforce some of your organization's governance policies.

Dans Office Online Server, la plupart de ces paramètres sont disponibles en tant que valeurs des cmdlets Microsoft PowerShell New-OfficeWebAppsFarm et Set-OfficeWebAppsFarm, tandis qu'une autre cmdlet (OfficeWebAppsExcelBIServer) configure l'accès aux serveurs SQL Server Analysis Services (SSAS) (notez qu'il s'agit d'un sous-ensemble des paramètres qui étaient disponibles dans Excel Services pour SharePoint Server 2013).In Office Online Server, most of these settings are available as parameters for the New-OfficeWebAppsFarm and Set-OfficeWebAppsFarm Microsoft PowerShell cmdlets, and there is an additional cmdlet (OfficeWebAppsExcelBIServer) that configures access to SQL Server Analysis Services (SSAS) servers. (Note that this is a subset of the settings that were available in Excel Services in SharePoint Server 2013.)

Voici ce que vous pouvez faire :Here's what you can do:

Empêcher le chargement d’un classeur dans Excel Online en cas d’échec de l’actualisation des donnéesPrevent a workbook from loading in Excel Online if data refresh fails

Par défaut, Excel Online ne charge pas de fichiers Excel si une opération d'actualisation automatique des données échoue quand quelqu'un ouvre le fichier. Cela empêche les utilisateurs de voir des informations obsolètes ou, éventuellement, des informations auxquelles ils ne doivent pas avoir accès.By default, Excel Online doesn't load Excel files if an automatic data refresh operation fails when someone opens the file. This helps prevent users from seeing out-of-date information or possibly information that they should not have access to.

Le chargement échoue uniquement dans les conditions suivantes :The load fails only in the following conditions:

  • L'utilisateur dispose d'autorisations en lecture seule pour le fichier dans SharePoint Server.The user has read-only permissions for the file in SharePoint Server.

  • Le classeur comporte des connexions de données qui sont automatiquement actualisées lorsque quelqu’un ouvre le classeur.There are data connections in the workbook file that are automatically refreshed when someone opens the workbook.

Syntaxe : Set-OfficeWebAppsFarm -ExcelAbortOnRefreshOnOpenFailSyntax: Set-OfficeWebAppsFarm -ExcelAbortOnRefreshOnOpenFail

Valeur par défaut : TrueDefault: True

Exemple :Example:


Set-OfficeWebAppsFarm -ExcelAbortOnRefreshOnOpenFail:$false

Définir la durée de mise en cache dans Excel Online pour les fonctions volatilesSet the Excel Online cache time for volatile functions

Vous pouvez spécifier la durée maximale, en secondes, de mise en cache d'une valeur calculée pour une fonction volatile à des fins de recalcul automatique. Les valeurs valides sont les suivantes :You can specify the maximum time, in seconds, that a computed value for a volatile function is cached for automatic recalculations. Valid values are:

  • -1 : calcule une fois au chargement du classeur-1: Calculates once when the workbook loads.

  • 0 : calcule toujours0: Always calculates.

  • entre 1 et 2073600 : mise en cache entre 1 seconde et 24 jours.1 to 2073600: Caches 1 second to 24 days.

La valeur doit être un nombre entier compris entre -1 et 2073600.The value must be an integer from -1 to 2073600.

Syntaxe : Set-OfficeWebAppsFarm -ExcelAutomaticVolativeFunctionCacheLifetimeSyntax: Set-OfficeWebAppsFarm -ExcelAutomaticVolativeFunctionCacheLifetime

Valeur par défaut : 300Default: 300

Exemple :Example:


Set-OfficeWebAppsFarm -ExcelAutomaticVolativeFunctionCacheLifetime:500

Définir le nombre de demandes de données par session dans Excel OnlineSet the number of Excel Online data requests per session

Vous pouvez spécifier le nombre maximal de demandes de données externes simultanées autorisé par session. Si une session doit publier plus de demandes que le nombre autorisé, les demandes supplémentaires sont mises en attente. Ce paramètre s’applique au serveur logique. La valeur doit être un entier positif.You can specify the maximum number of concurrent external data requests allowed in each session. If a session must issue more than this number of requests, additional requests are queued. The scope of this setting is the logical server. The value must be a positive integer.

Syntaxe : Set-OfficeWebAppsFarm -ExcelConcurrentDataRequestsPerSessionMaxSyntax: Set-OfficeWebAppsFarm -ExcelConcurrentDataRequestsPerSessionMax

Valeur par défaut : 5Default: 5

Exemple :Example:

Set-OfficeWebAppsFarm -ExcelConcurrentDataRequestsPerSessionMax:10

Définir le mode de calcul du classeur Excel OnlineSet the Excel Online workbook calculation mode

Vous pouvez spécifier le mode de calcul des classeurs affichés dans Excel Online. Les valeurs disponibles sont : File, Manual, Auto et AutoDataTables (automatique sauf pour les tables de données). Tout paramètre autre que File écrase les paramètres du classeur.You can specify the calculation mode of workbooks rendered in Excel Online. The available values are: File, Manual, Auto, and AutoDataTables (automatic except data tables). Settings other than File override the workbook settings.

Syntaxe : Set-OfficeWebAppsFarm -ExcelDefaultWorkbookCalcModeSyntax: Set-OfficeWebAppsFarm -ExcelDefaultWorkbookCalcMode

Valeur par défaut : FileDefault: File

Exemple :Example:

Set-OfficeWebAppsFarm -ExcelDefaultWorkbookCalcMode:Auto

Définir la taille maximale des images Excel OnlineSet the maximum Excel Online image size

Vous pouvez spécifier la taille maximale, en mégaoctets, d'un graphique ou d'une image pouvant être ouvert par Excel Online. La valeur doit être un entier supérieur à 0.You can specify the maximum size, in megabytes, of a chart or image that can be opened by Excel Online. The value must be an integer greater than 0.

Syntaxe : Set-OfficeWebAppsFarm -ExcelChartAndImagesSizeMaxSyntax: Set-OfficeWebAppsFarm -ExcelChartAndImagesSizeMax

Valeur par défaut : 1Default: 1

Exemple :Example:


Set-OfficeWebAppsFarm -ExcelChartAndImagesSizeMax:5

Configurer un serveur Analysis Services (modèle de données) pour Excel OnlineConfigure an Analysis Services (data model) server for Excel Online

Vous pouvez configurer des serveurs Analysis Services pour les utiliser avec Excel Online à l'aide de la cmdlet OfficeWebAppsExcelBIServer :You can configure Analysis Services servers to work with Excel Online by using the OfficeWebAppsExcelBIServer cmdlets:

  • Nouvelle OfficeWebAppsExcelBIServer Ajoute un emplacement de serveur Analysis Services à la liste verte pour Excel. Services de calcul dans Office Online Server pour les fonctionnalités BI avancées.New-OfficeWebAppsExcelBIServer Adds an Analysis Services server location to the Allow List for Excel Calculation Services in Office Online Server for advanced BI functionality.

  • Get-OfficeWebAppsExcelBIServer Obtient les serveurs Analysis Services de la liste verte.Get-OfficeWebAppsExcelBIServer Gets the Analysis Services servers in the Allow List.

  • Remove-OfficeWebAppsExcelBIServer Supprime un serveur de la liste verte.Remove-OfficeWebAppsExcelBIServer Removes a server from the Allow List.

Pour utiliser cette fonctionnalité, vous devez également configurer chaque ordinateur dans votre batterie de serveurs Office Online Server en tant qu' administrateur Analysis Services.To use this feature, you must also configure each computer in your Office Online Server farm as an Analysis Services administrator.

Les cmdlets New et Remove utilisent la valeur du paramètre -ServerID, qui est le nom du serveur Analysis Services à ajouter ou supprimer.The New and Remove cmdlets take a parameter of -ServerID, which is the server name of the Analysis Services server that you want to add or remove.

Exemples :Examples:


New-OfficeWebAppsExcelBIServer -ServerID "SSAS01"
Remove-OfficeWebAppsExcelBIServer -ServerID "SSAS01"

Les applets de commande OfficeWebAppsExcelBIServer prennent également en charge les paramètres communs.The OfficeWebAppsExcelBIServer cmdlets also support common parameters.

Configurer l’option EffectiveUserName de Analysis Services dans Excel OnlineConfigure Analysis Services EffectiveUserName in Excel Online

EffectiveUserName est une propriété de chaîne de connexion SQL Server Analysis Services contenant le nom de l'utilisateur qui accède à un rapport. Dans Office Online Server, vous pouvez utiliser cette propriété en association avec Excel Online pour transférer l'identité de l'utilisateur qui affiche le rapport dans Analysis Services. L'identité par utilisateur est ainsi permise sans devoir configurer la délégation Kerberos contrainte.EffectiveUserName is a SQL Server Analysis Services connection string property that contains the name of the user who is accessing a report. In Office Online Server, you can use this property in conjunction with Excel Online to pass the identity of the user who is viewing the report to Analysis Services. This allows per-user identity without the need to configure Kerberos constrained delegation.

Pour activer cette option, vous devez utiliser la version SQL Server 2016 de SQL Server Management Studio. La source de données elle-même peut utiliser une version antérieure de Analysis Services.To enable this option, you need to use the SQL Server 2016 version of SQL Server Management Studio. The actual data source can be in an earlier version of Analysis Services.

Pour configurer cette option, vous devez effectuer les opérations suivantes :To configure this option, you have to do the following:

  • Configurer chaque ordinateur dans votre batterie de serveurs Office Online Server en tant qu' administrateur Analysis Services.Configure each computer in your Office Online Server farm as an Analysis Services administrator.

  • Utilisez PowerShell pour activer l'option EffectiveUserName dans Excel Online (décrite ci-dessous).Use PowerShell to enable EffectiveUserName in Excel Online (described below).

La cmdlet Set-OfficeWebAppsFarm permet d'activer ou de désactiver l'option EffectiveUserName dans Excel Online.The Set-OfficeWebAppsFarm is used to enable or disable EffectiveUserName in Excel Online.

Pour activer l'option EffectiveUserName dans Excel Online, exécutez la commande suivante :To enable EffectiveUserName in Excel Online, run the following command:

Set-OfficeWebAppsFarm -ExcelUseEffectiveUserName:$True

Pour désactiver l'option EffectiveUserName dans Excel Online, exécutez la commande suivante :To disable EffectiveUserName in Excel Online, run the following command:

Set-OfficeWebAppsFarm -ExcelUseEffectiveUserName:$False

Utilisation de classeurs volumineuxWorking with large workbooks

Lorsque vous ouvrez un classeur dans Excel Online, il existe un délai d'une minute avant que Excel Online expire et échoue à charger le classeur. Parfois, ce délai peut ne pas suffire pour charger des classeurs volumineux. Si vous rencontrez des difficultés pour charger des classeurs volumineux, vous pouvez régler la valeur du délai d'expiration.When opening a workbook in Excel Online, there is a time limit of one minute before Excel Online will time out and fail to load the workbook. Occasionally, this time limit may not be enough to load large workbooks. If you run into problems loading large workbooks, you can adjust the timeout value.

Pour modifier la valeur du délai, vous devez mettre à jour le fichier settings.xml sur chaque ordinateur exécutant Office Online Server. (Ce fichier est généralement situé sur C:\ProgramData\Microsoft\OfficeWebApps\Data\FarmState\settings.xml.)To change the timeout value, you must update the settings.xml file on each computer running Office Online Server. (This file is normally located at C:\ProgramData\Microsoft\OfficeWebApps\Data\FarmState\settings.xml.)

Ajoutez la valeur suivante dans le fichier settings.xml, où TimeoutValue est la valeur du délai en millisecondes :Add the following value to the settings.xml file, where TimeoutValue is the timeout value in milliseconds:

<Setting Name="FBDirectReadTimeoutInMilliseconds" DataType="System.Int32">
    <StringValue>TimeoutValue</StringValue>
</Setting>

Notez qu'une valeur de délai de 0 crée un délai d'expiration indéfini. Ce n'est pas recommandé car cela accroît le risque d'attaque par déni de service.Note that a timeout value of 0 will make the timeout indefinite. This is not recommended as it increases the risk of a denial-of-service attack.