New-SPExcelFileLocation

Syntaxe

Default (Par défaut)

New-SPExcelFileLocation
    -Address <String>
    -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
    [-AbortOnRefreshOnOpenFail]
    [-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

Exemples

EXEMPLE 1

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address "https://myPortal/myTeam" -includechildren -locationType SharePoint -description "This is my team's site on myPortal." -workbooksizemax 50 -externaldataallowed DclAndEmbedded -WarnOnDataRefresh:$false

EXEMPLE 2

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelFileLocation -address https://myPortal/myTeam/managers -locationType SharePoint -description "This is the manager's subsite for myTeam."

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 de produit et de technologies SharePoint en lecture seule sur le fichier.
• Le fichier de classeur a des connexions de données qui sont actualisées automatiquement lorsque le fichier Excel Services Application est ouvert.

Propriétés du paramètre

Jeux de paramètres

-Address

Applicable : SharePoint Server 2010, SharePoint Server 2013

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

Jeux de paramètres

-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

Jeux de paramètres

-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 le chargement du classeur.

0 Calcule toujours.

1 à 2073600 Caches de 1 seconde à 24 jours. La valeur entière par défaut est 300.

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

Jeux de paramètres

-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

Jeux de paramètres

-ChartRenderDurationMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

{{Fill ChartRenderDurationMax Description}}

Propriétés du paramètre

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

-DefaultWorkbookCalcMode

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le mode de calcul des classeurs. Tout paramètre autre que File écrase les paramètres du classeur. 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

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

-ExternalDataAllowed

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le type d’accès aux données externes autorisé pour les classeurs. None 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 l’un des paramètres suivants :

Aucun

Dcl

DclAndEmbedded

Propriétés du paramètre

Jeux de paramètres

-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://portal et IncludeChildren a la valeur true, https://portal/subSite est également approuvé, tout comme toute URL subordonnée à l’URL spécifiée dans Adresse.

Propriétés du paramètre

Jeux de paramètres

-LocationType

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le type d’emplacement. Le type d’emplacement indique comment Excel Services Application récupère les fichiers à partir de l’emplacement spécifié dans Adresse. Le paramètre par défaut est le type SharePoint. 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

Jeux de paramètres

-ManualExtDataCacheLifetime

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie la durée, en secondes, pendant laquelle Excel Services Application attend avant de réexécurer une demande de données externes manuelle ou initiée par l’utilisateur. Pendant cette période, les résultats de la demande de données externe précédente peuvent être retournés à partir d’un cache de données externe. La valeur par défaut est 300.

Les valeurs valides sont l’un des éléments suivants :

-1 Ne jamais actualiser après la première requête.1 à 2073600 - Met en cache 1 seconde à 24 jours.

Propriétés du paramètre

Jeux de paramètres

-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. Les valeurs valides sont les suivantes :

-1 La session n’expire jamais.

0 La session expire à la fin d’une seule requête.

1 à 2073600 Reste actif 1 seconde à 24 jours. La valeur par défaut est 1800.

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

Propriétés du paramètre

Jeux de paramètres

-PeriodicExtDataCacheLifetime

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie la durée, en secondes, pendant laquelle Excel Services Application attend avant d’envoyer à nouveau une demande de données externes ouverte ou périodique (c’est-à-dire automatique). Pendant cette période, les résultats de la demande de données externe précédente peuvent être retournés à partir d’un cache de données externe. La valeur -1 spécifie qu’il ne faut jamais actualiser après la première requête. La valeur par défaut est 300.

Le type doit être -1, 0 ou entier dans la plage de 1 à 2073600.

Propriétés du paramètre

Jeux de paramètres

-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 écoulé, la requête expire. La valeur par défaut est 300.

Le type doit être -1 (illimité) ou un entier compris entre 1 et 2073600.

Propriétés du paramètre

Jeux de paramètres

-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 ExternalDataAllowed est défini sur None.

Propriétés du paramètre

Jeux de paramètres

-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. Les valeurs valides sont les suivantes :

-1 La session n’expire jamais.

0 session expire à la fin d’une seule requête.

1 à 2073600 Reste actif 1 seconde à 24 jours. La valeur par défaut est 300.

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

Propriétés du paramètre

Jeux de paramètres

-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 temps écoulé, 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

Jeux de paramètres

-UdfsAllowed

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie que les fonctions définies par l’utilisateur peuvent être appelées par des classeurs chargés à partir de l’emplacement de fichier approuvé spécifié dans Adresse.

La valeur par défaut est False.

Propriétés du paramètre

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

-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

Jeux de paramètres

CommonParameters