Partager via


Set-SPExcelFileLocation

Définit les propriétés d'un emplacement de fichier approuvé pour l'application Excel Services.

Syntaxe

Default (Par défaut)

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

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Address

Applicable : SharePoint Server 2010, SharePoint Server 2013

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AssignmentCollection

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-AutomaticVolatileFunctionCacheLifetime

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ChartAndImageSizeMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ChartRenderDurationMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

Durée maximale (en secondes) consacrée au rendu d’un graphique unique.

Valeurs valides : -1 (aucune limite) ; de 1 à 2073600 (24 jours).

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ConcurrentDataRequestsPerSessionMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : SharePoint Server 2010, SharePoint Server 2013

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DefaultWorkbookCalcMode

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:DefaultWorkbookCalcMode
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Description

Applicable : SharePoint Server 2010, SharePoint Server 2013

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

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-DisplayGranularExtDataErrors

Applicable : SharePoint Server 2010, SharePoint Server 2013

Affiche des messages d’erreur granulaires pour les échecs de données externes à cet emplacement.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ExcelServiceApplication

Applicable : SharePoint Server 2010, SharePoint Server 2013

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 (par exemple, MyExcelService1) ou instance d’un objet SPExcelServiceApplication valide.

Propriétés du paramètre

Type:SPExcelServiceApplicationPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-ExternalDataAllowed

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:AllowExternalData
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Identity

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:SPExcelFileLocationPipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IncludeChildren

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-LocationType

Applicable : SharePoint Server 2010, SharePoint Server 2013

Le type d’emplacement. LocationType indique comment Excel Services Application récupère les fichiers à partir de l’emplacement spécifié dans Adresse. La valeur par défaut est SharePoint.

Le type doit être l’un des suivants : SharePoint, UNC ou HTTP.

Propriétés du paramètre

Type:LocationType
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ManualExtDataCacheLifetime

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-NewWorkbookSessionTimeout

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-PeriodicExtDataCacheLifetime

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RequestDurationMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-RESTExternalDataAllowed

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SessionTimeout

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ShortSessionTimeout

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-UdfsAllowed

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WarnOnDataRefresh

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Server 2010, SharePoint Server 2013

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WorkbookSizeMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

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.

Propriétés du paramètre

Type:Int32
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.