Add-ecsfiletrustedlocation : opération Stsadm (Office SharePoint Server)
Mise à jour : 2008-02-14
Nom d’opération : Add-ecsfiletrustedlocation
Permet à un administrateur d’ajouter un fichier à la liste des emplacements approuvés.
Cette opération est équivalente au paramètre d’interface utilisateur Emplacement de la page Excel Services Ajouter un emplacement de fichier approuvé du site Web Administration de services partagés de SharePoint.
Syntaxe
stsadm -o add-ecsfiletrustedlocation
-ssp <nom de fournisseur SSP>
-location {URL | UNC}
-LocationType {SharePoint |UNC |HTTP}
-IncludeChildren {True | False}
[-SessionTimeout <durée en secondes>]
[-ShortSessionTimeout <durée en secondes>]
[-MaxRequestDuration <durée en secondes>]
[-MaxWorkbookSize <taille de fichier en Mo>]
[-MaxChartSize <taille en Mo>]
[-VolatileFunctionCacheLifetime <durée en secondes>]
[-DefaultWorkbookCalcMode {File | Manual | Auto | AutoDataTables}]
[-AllowExternalData {None | Dcl | DclAndEmbedded}]
[-WarnOnDataRefresh {True | False}]
[-StopOpenOnRefreshFailure {True | False}]
[-PeriodicCacheLifetime <durée en secondes>]
[-ManualCacheLifetime <durée en secondes>]
[-MaxConcurrentRequestsPerSession <nombre de demandes>]
[-AllowUdfs {True | False}]
[-Description <texte descriptif>]
Paramètres
Paramètre |
Valeur |
Obligatoire ? |
Description |
ssp |
Nom du fournisseur de services partagés valide, tel que « ServicesPartagés1 » |
Oui |
Nom du fournisseur SSP qui fournit les ressources pour les services de calcul Excel que vous souhaitez configurer. |
location |
Emplacement valide dans le dossier approuvé Les valeurs valides sont :
La longueur maximale est de 1 024 caractères. |
Oui |
Il s’agit de l’URL du répertoire approuvé. Le format de ce paramètre est déterminé par la valeur du paramètre locationtype pour un emplacement donné. |
locationtype |
L’un des types pris en charge suivants :
|
Oui |
Spécifie un type d’emplacement. La valeur de ce paramètre détermine la méthode d’authentification utilisée pour récupérer les classeurs. Si la valeur est SharePoint ou HTTP, la valeur du paramètre location est une URL valide. Si la valeur est UNC, la valeur du paramètre location est un UNC valide. Ce paramètre fonctionne conjointement avec le paramètre location. |
includechildren |
Une des valeurs suivantes :
|
Oui |
La valeur True indique que les sous-répertoires ou les bibliothèques enfants sont approuvés, tandis que la valeur False indique qu’ils ne le sont pas. |
sessionTimeout |
L’un des entiers valides suivants :
|
Non |
Durée maximale, en secondes, à compter de la fin de chaque demande, pendant laquelle une session des services de calcul Excel peut demeurer ouverte et inactive jusqu’à ce qu’elle expire. |
shortSessionTimeout |
L’un des entiers valides suivants :
|
Non |
Durée maximale, en secondes, pendant laquelle une session des services de calcul Excel peut demeurer ouverte et inactive avant une interaction de l’utilisateur et avant sa fermeture. La durée est mesurée à compter de la fin de la demande d’ouverture initiale. |
maxRequestDuration |
L’un des entiers valides suivants :
|
Non |
Durée maximale, en secondes, d’une demande unique dans une session. |
maxWorkbookSize |
Entier valide compris entre 1 et 2 000 |
Non |
Taille maximale, en mégaoctets (Mo), d’un classeur qui peut être ouvert par les services de calcul Excel. |
maxChartSize |
Entier valide compris entre 1 et 2147483647 |
Non |
Taille maximale, en Mo, d’un classeur qui peut être ouvert par les services de calcul Excel. |
volatileFunctionCacheLifetime |
L’un des entiers valides suivants :
|
Non |
Durée maximale, en secondes, de mise en cache d’une valeur calculée pour une fonction volatile à des fins de recalcul automatique. |
defaultWorkbookCalcMode |
Une des valeurs suivantes :
|
Non |
Mode de calcul de tous les classeurs. |
allowExternalData |
Une des valeurs suivantes :
|
Non |
Spécifie les types de connexions de données externes qui sont autorisées. |
warnOnDataRefresh |
Une des valeurs suivantes :
|
Non |
True : affiche une invite avant d’actualiser une source de données externe qui utilise l’identité de l’utilisateur. False : n’affiche pas d’invite avant d’actualiser une source de données externe. |
stopOpenOnRefreshFailure |
Une des valeurs suivantes :
|
Non |
True : arrête l’ouverture d’un classeur. Ce comportement se produit dans les circonstances suivantes : le classeur contient une connexion de données Actualisation à l’ouverture, or il ne peut pas être actualisé lors de son ouverture, et l’utilisateur ne dispose pas d’autorisations Ouvrir les éléments pour ce classeur. False : n’arrête pas l’ouverture d’un classeur. Pour plus d’informations sur les classeurs, voir Vue d’ensemble des aspects techniques d’Excel Services (https://go.microsoft.com/fwlink/?linkid=110301&clcid=0x40C) . |
periodicCacheLifetime |
L’un des entiers valides suivants :
|
Non |
Durée maximale, en secondes, pendant laquelle le système peut utiliser les résultats d’une requête de données externes. |
manualCacheLifetime |
L’un des entiers valides suivants :
|
Non |
Durée maximale, en secondes, pendant laquelle le système peut utiliser les résultats de requêtes de données externes manuelles explicites. |
maxConcurrentRequestsPerSession |
Entier valide compris entre 1 et 2147483647 |
Non |
Nombre maximal de requêtes de données externes simultanées par session. |
allowUdfs |
Une des valeurs suivantes :
|
Non |
True : indique que les fonctions définies par l’utilisateur peuvent être appelées à partir des classeurs situés à cet emplacement approuvé. False : indique que les fonctions définies par l’utilisateur ne peuvent pas être appelées à partir des classeurs situés à cet emplacement approuvé. |
description |
Valeur de chaîne valide, par exemple, « Ceci est un emplacement approuvé » |
Non |
Description facultative de l’emplacement approuvé. La longueur maximale est de 4 096 caractères. |
Remarques
Une liste d’emplacements approuvés permet aux services de calcul Excel de ne charger des fichiers qu’à partir des emplacements jugés sécurisés par l’administrateur. Cette liste permet de charger les fichiers qui sont explicitement chargés par un utilisateur (navigation et affichage dans le convertisseur), ainsi que ceux qui sont implicitement chargés lorsqu’un composant WebPart Excel Web Access réside sur un tableau de bord interactif.
Lorsqu’un fichier fait l’objet d’une vérification visant à déterminer s’il se trouve à un emplacement approuvé, celle-ci ne doit porter que sur le fichier ou l’URL initialement demandé. Ce fichier ou cette URL peut différer du fichier ou de l’URL demandé par l’utilisateur, car des redirections peuvent intervenir avant que ne soit déterminé le fichier ou l’URL à charger.
La liste des emplacements approuvés est stockée dans la base de données Fournisseur de services partagés et s’applique au serveur logique.
Voir aussi
Concepts
Ajouter un emplacement de fichier approuvé
Remove-ecsfiletrustedlocation