Set-SPExcelFileLocation
Définit les propriétés d'un emplacement de fichier approuvé pour l'application Excel Services.
Syntax
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>]
Description
L’applet Set-SPExcelFileLocation
de commande définit les propriétés d’un emplacement à partir duquel Excel Services Application charge des classeurs.
Excel Services Application charge uniquement les classeurs stockés dans un emplacement de fichier approuvé.
Les propriétés des emplacements de fichiers approuvés contrôlent la façon dont les classeurs peuvent être utilisés lorsqu’ils sont chargés sur Excel Services Application.
Excel Services Application applique toujours les propriétés définies par l’emplacement de fichier approuvé à partir duquel un classeur a été chargé.
Les propriétés utilisées par l’emplacement de fichiers approuvé sont déterminées par comparaison du chemin d’accès au fichier du classeur au paramètre Address de l’emplacement de fichiers approuvé.
Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.
Exemples
--------------EXEMPLE 1--------------
Get-SPExcelFileLocation -ExcelServiceApplication "My Excel Service" | where { $_.externaldataallowed -eq "DclAndEmbedded"} | Set-SPExcelFileLocation -ExernalDataAllowed Dcl
Cet exemple obtient chaque emplacement de fichier approuvé pour l’application de service Web Excel Services Application nommée Mon service Excel, qui permet le chargement des connexions de données à partir de fichiers de classeur et spécifie que les emplacements doivent utiliser une bibliothèque de connexions de données pour charger des connexions de données.
--------------EXEMPLE 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."
Cet exemple montre comment modifier la description de l’emplacement de fichier par défaut pour chaque application de service web Excel Services Application dans la batterie de serveurs.
Paramètres
-AbortOnRefreshOnOpenFail
Spécifie que le chargement d’un fichier Excel Services Application échoue automatiquement si une opération d’actualisation automatique des données échoue lors de l’ouverture du fichier. Le chargement échoue seulement si les conditions suivantes sont vérifiées :
- L’utilisateur dispose d’autorisations en lecture seule sur le fichier Excel Services Application. -- Le fichier du classeur a des connexions de données qui sont automatiquement actualisées à l’ouverture du fichier Excel.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Address
System.String
Spécifie un dossier web ou un répertoire de fichiers à partir duquel Excel Services Application pouvez charger des classeurs.
Le type doit être une URL valide, au format https://myPortal/myTeam; ou un chemin UNC valide dans le formulaire, \\server_name\folder_name
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AssignmentCollection
Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.
Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global.
Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment
, un scénario d’insuffisance de mémoire peut se produire.
Type: | SPAssignmentCollection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AutomaticVolatileFunctionCacheLifetime
Spécifie 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 comprennent :
-1, calcule une fois au chargement du classeur
0, calcule toujours
entre 1 et 2073600, en cache entre 1 seconde et 24 jours
Le type doit être les entiers -1 ou 0, ou une valeur entière comprise entre 1 et 2073600.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartAndImageSizeMax
Spécifie la taille maximale, en mégaoctets, d’un graphique ou d’une image qu’un utilisateur peut ouvrir. La valeur par défaut est 1.
Le type doit être un entier valide supérieur à 0.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ChartRenderDurationMax
Durée maximale (en secondes) consacrée au rendu d’un graphique unique.
Valeurs valides : -1 (aucune limite) ; de 1 à 2073600 (24 jours).
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ConcurrentDataRequestsPerSessionMax
Spécifie 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. L’étendue de ce paramètre est le serveur logique. La valeur par défaut est 5.
Le type doit être un entier positif.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Confirm
Vous demande une confirmation avant d’exécuter la commande.
Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-DefaultWorkbookCalcMode
Spécifie le mode de calcul des classeurs. Tous les paramètres sauf File écrasent les paramètres de classeur. Si ce paramètre est modifié, il est appliqué à toutes les nouvelles sessions sur Excel Services Application lorsque le cache des propriétés ConfigDB est actualisé. Le paramètre par défaut est File.
Le type doit être l’un des suivants : File, Manual, Auto ou AutoDataTables.
Type: | DefaultWorkbookCalcMode |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Description
Spécifie une description conviviale du nouvel emplacement de fichiers.
Le type doit être une chaîne, par exemple, « Ceci est l’emplacement de fichiers des rapports de ventes mensuels ».
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-DisplayGranularExtDataErrors
Affiche des messages d’erreur granulaires pour les échecs de données externes à cet emplacement.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExcelServiceApplication
Spécifie l’application de service web Excel Services Application qui contient l’objet de liste SPExcelFileLocation.
Le type doit être un GUID valide, au format 12345678-90ab-cdef-1234-567890bcdefgh ; nom valide d’une application de service Web Excel Services Application dans la batterie de serveurs (par exemple, MyExcelService1) ou instance d’un objet SPExcelServiceApplication valide.
Type: | SPExcelServiceApplicationPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ExternalDataAllowed
Spécifie le type d’accès aux données externes autorisé pour les classeurs : Aucun spécifie que l’actualisation des données est désactivée. Dcl spécifie que les données sont actualisées seulement lorsqu’un fichier de connexions d’une bibliothèque de connexions de données approuvée est utilisé. DclandEmbedded spécifie qu’une bibliothèque de connexions de données peut être utilisée, mais n’est pas obligatoire. L’étendue de ce paramètre est l’emplacement approuvé.
La valeur par défaut est None.
Le type doit être un des suivants : None, Dcl ou DclAndEmbedded.
Type: | AllowExternalData |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-Identity
Spécifie l’objet FileLocation à mettre à jour. Le nom doit être unique dans la liste des emplacements de fichiers.
Le type doit être un GUID valide, au format 12345678-90ab-cdef-1234-567890bcdefgh ; chaîne valide identifiant l’emplacement du fichier, au format https://myPortal/myTeam; chaîne valide identifiant le chemin d’accès, au format C:\folder_name ; ou instance d’un objet SPExcelFileLocation valide.
Type: | SPExcelFileLocationPipeBind |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-IncludeChildren
Indique que les URL, répertoires et bibliothèques subordonnés sont approuvés. Par exemple, si l’emplacement du fichier approuvé est https://portalet que IncludeChildren a la valeur true, il https://portal/subSite est également approuvé, tout comme toute sous-URL sous l’URL spécifiée dans Adresse.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-LocationType
Le type d’emplacement. LocationType indique comment Excel Services Application récupère les fichiers à partir de cet emplacement spécifié dans Adresse. La valeur par défaut est SharePoint.
Le type doit être l’un des suivants : SharePoint, UNC ou HTTP.
Type: | LocationType |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ManualExtDataCacheLifetime
Spécifie la durée, en secondes, pendant laquelle Excel Services Application attend avant d’émettre à nouveau une demande de données externes manuelle ou lancée par l’utilisateur. Pendant ce laps de temps, les résultats de la demande de données externes précédente peuvent être renvoyés d’un cache de données externes.
Les valeurs valides sont les suivantes :
-1 Ne jamais actualiser après la première requête
1 à 2073600 Caches de 1 seconde à 24 jours.
La valeur par défaut est 300.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-NewWorkbookSessionTimeout
Spécifie la durée, en secondes, pendant laquelle une session d’un nouveau classeur non enregistré reste active sur Excel Services Application sans activité de l’utilisateur. La valeur par défaut est 1800. Les valeurs valides sont les suivantes :
-1, la session n’expire jamais
0, la session expire à la fin d’une demande unique
1 à 2073600, rester actif 1 seconde à 24 jours.
Le type doit être -1, 0 ou un entier compris entre 1 et 2073600.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-PeriodicExtDataCacheLifetime
Spécifie la durée, en secondes, pendant laquelle Excel Services Application attend avant d’émettre à nouveau une demande de données externes ouverte ou périodique (c’est-à-dire automatique). Pendant ce laps de temps, les résultats de la demande de données externes précédente peuvent être renvoyés d’un cache de données externes. La valeur -1 spécifie qu’aucune actualisation n’intervient après la première demande.
Le type doit être -1, 0 ou un entier compris entre 1 et 2073600.
La valeur par défaut est 300.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RequestDurationMax
Spécifie la durée maximale, en secondes, d’une demande unique dans une session. Une fois ce délai passé, la demande expire.
Le type doit être -1 (illimité) ou un entier compris entre 1 et 2073600.
La valeur par défaut est 300.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-RESTExternalDataAllowed
Spécifie si les demandes de l’API (Application Programming Interface) REST (Representational State Transfer) sont autorisées pour actualiser les connexions de données externes.
Le paramètre RESTExternalDataAllowed n’a aucun effet si le paramètre External DataAllowed est défini sur None.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-SessionTimeout
Spécifie la durée, en secondes, pendant laquelle une session reste active sur Excel Services Application sans activité de l’utilisateur. La valeur par défaut est 300 secondes. La valeur par défaut est 300. Les valeurs valides sont les suivantes :
-1, la session n’expire jamais
0, la session expire à la fin d’une demande unique
entre 1 et 2073600, reste active entre 1 seconde et 24 jours.
Le type doit être -1, 0 ou un entier compris entre 1 et 2073600.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-ShortSessionTimeout
Spécifie le temps, en secondes, dont l’utilisateur dispose pour effectuer la première interaction avec une feuille de calcul. Une fois ce délai expiré, si l’utilisateur n’est pas actif, la session est fermée. La valeur doit toujours être inférieure à SessionTimeout. Si la valeur de ShortSessionTimeout est supérieure ou égale à SessionTimeout, une erreur est renvoyée. La valeur par défaut est 200.
Le type doit être -1 ou un entier compris entre 1 et 2073600.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-UdfsAllowed
Spécifie que les fonctions définies par l’utilisateur peuvent être appelées par les classeurs chargés à partir de l’emplacement de fichiers approuvé spécifié dans Address.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WarnOnDataRefresh
Spécifie que l’utilisateur reçoit un avertissement à la première actualisation des données sur le classeur. La valeur par défaut est True.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WhatIf
Affiche un message qui explique l’effet de la commande au lieu de l’exécuter.
Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-WorkbookSizeMax
Spécifie la taille maximale, en mégaoctets, d’un classeur qu’un utilisateur peut charger. La valeur par défaut est 10.
Le type doit être une valeur entière comprise entre 1 et 2000.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |