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 les 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 My Excel Service, qui permet aux connexions de données de se charger à 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 modifie la description de l’emplacement de fichier par défaut pour chaque Excel Services Application application de service Web dans la batterie de serveurs.

Paramètres

- Identité

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, sous la forme 12345678-90ab-cdef-1234-567890bcdefgh; une chaîne valide identifiant l’emplacement du fichier, dans le formulaire https://myPortal/myTeam; une chaîne valide identifiant le chemin d’accès, sous la forme C:\folder_name; ou une instance d’un objet SPExcelFileLocation valide.

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

-AbortOnRefreshOnOpenFail

Spécifie que le chargement d’un fichier Excel Services Application échoue automatiquement en cas d’échec d’une opération d’actualisation automatique des données 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-Adresse

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, dans le formulaire https://myPortal/myTeam; ou un chemin UNC valide sous forme, \\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

-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

-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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ConcurrentDataRequestsPerSessionMax

Specifies 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 must be queued. The scope of this setting is the logical server. The default value is 5.

Le type doit être un entier positif.

Type:Int32
Position:Named
Default value:None
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
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
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
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
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, sous la forme 12345678-90ab-cdef-1234-567890bcdefgh; un nom valide d’une Excel Services Application application de service Web dans la batterie de serveurs (par exemple, MyExcelService1) ou une instance d’un objet SPExcelServiceApplication valide.

Type:SPExcelServiceApplicationPipeBind
Position:Named
Default value:None
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 ne 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
Accept pipeline input:False
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://portal, et includeChildren est vrai, il https://portal/subSite est également approuvé, tout comme tout sous-FICHIER sous l’URL spécifiée dans l’adresse.

Type:SwitchParameter
Position:Named
Default value:None
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 Address. 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
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 de réexécuter une demande de données externe manuelle ou initié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 aucune actualisation 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
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 pour un classeur nouveau, 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, restez 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
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 de réexécuter 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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ShortSessionTimeout

Specifies the time, in seconds, that a user has to make the initial interaction with a spreadsheet. After this time has elapsed, if the user is not active, then the session is closed. The value must always be less than SessionTimeout. If the ShortSessionTimeout value is greater than or equal to SessionTimeout, an error is returned. The default value is 75.

Le type doit être -1 ou un entier compris entre 1 et 2073600.

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