Set-SPExcelServiceApplication

Syntaxe

ExistingTargetApplicationParameterSet

Set-SPExcelServiceApplication
    [[-Identity] <SPExcelServiceApplicationPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnattendedAccountApplicationId <String>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

NewTargetApplicationParameterSet

Set-SPExcelServiceApplication
    [[-Identity] <SPExcelServiceApplicationPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-CachingOfUnusedFilesEnable]
    [-Confirm]
    [-CrossDomainAccessAllowed]
    [-EncryptedUserConnectionRequired <EncryptedConnectionMode>]
    [-ExternalDataConnectionLifetime <Int32>]
    [-FileAccessMethod <FileAccessMethod>]
    [-LoadBalancingScheme <LoadBalancingScheme>]
    [-MemoryCacheThreshold <Int32>]
    [-PrivateBytesMax <Int32>]
    [-SessionsPerUserMax <Int32>]
    [-SiteCollectionAnonymousSessionsMax <Int32>]
    [-TerminateProcessOnAccessViolation]
    [-ThrottleAccessViolationsPerSiteCollection <Int32>]
    [-UnusedObjectAgeMax <Int32>]
    [-WhatIf]
    [-WorkbookCache <String>]
    [-WorkbookCacheSizeMax <Int32>]
    [-UnattendedServiceAccount <PSCredential>]
    [-UseEffectiveUserName]
    [-WorkbookModelUsageTracker <String>]
    [<CommonParameters>]

Description

Exemples

EXEMPLE 1

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -SessionsPerUserMax 10

EXEMPLE 2

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'Excel Services Application Web Service Application'}
Set-SPExcelServiceApplication -Identity $sa -PrivateBytesMax -1

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

-CachingOfUnusedFilesEnable

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie que les fichiers qui ne sont plus utilisés par Excel Services Application peuvent rester dans le cache pour une utilisation ultérieure. La valeur par défaut est true lorsque le paramètre n’est pas spécifié sur la commande.

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

-CrossDomainAccessAllowed

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie que les classeurs et fichiers de connexions de données approuvés peuvent être requis et rendus par des composants WebPart ou des pages qui résident dans d’autres domaines HTTP.

Propriétés du paramètre

Jeux de paramètres

-EncryptedUserConnectionRequired

Applicable : SharePoint Server 2010, SharePoint Server 2013

Nécessite que le chiffrement soit utilisé entre l’utilisateur final et le serveur exécutant Excel Services Application. Ce paramètre s'applique au serveur logique. La valeur par défaut est None.

Le type doit être un des suivants : None ou Connection.

Propriétés du paramètre

Jeux de paramètres

-ExternalDataConnectionLifetime

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le nombre maximal de secondes pendant lesquelles une connexion de données externes peut rester ouverte dans le pool de connexion.

Les valeurs valides sont les suivantes :

-1 Ne jamais recycler

1 à 2073600 Rester actif 1 seconde à 24 jours.

La valeur par défaut est 1800.

Propriétés du paramètre

Jeux de paramètres

-FileAccessMethod

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie la méthode d’authentification que Excel Services Application utilise pour récupérer des fichiers. UseFileAccessAccount spécifie que tous les classeurs utilisent toujours les informations d’identification du compte de service exécutant Excel Services Application. UseImpersonation spécifie que Excel Services Application récupère les fichiers du classeur en tant qu’utilisateur qui effectue la demande. La valeur par défaut est UseImpersonation.

Le type doit être l’un des suivants : UseImpersonation ou UseFileAccessAccount.

Propriétés du paramètre

Jeux de paramètres

-Identity

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie l’objet SPExcelServiceApplication à mettre à jour.

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

-LoadBalancingScheme

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le schéma d’équilibrage de charge utilisé par l’application de service Web Excel Services Application pour envoyer des demandes à différents ordinateurs Excel Services Application principaux. La valeur par défaut est WorkbookURL.

Le type doit être l’un des suivants : RoundRobin, Local ou WorkbookURL.

Propriétés du paramètre

Jeux de paramètres

-MemoryCacheThreshold

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le pourcentage du maximum d’octets privés qui peut être alloué aux objets inactifs. Lorsque le seuil de mémoire cache est dépassé, les objets du cache qui ne sont pas utilisés sont sortis. Définissez cette valeur sur 0 pour désactiver la mise en cache des objets inactifs. La valeur par défaut est 90.

Le type doit être un entier compris entre 0 et 95.

Propriétés du paramètre

Jeux de paramètres

-PrivateBytesMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le nombre maximal d’octets privés, en mégaoctets, qui sont utilisés par Excel Services Application. Défini sur -1, le maximum correspond par défaut à 50 pour cent de la mémoire physique de l’ordinateur. Les valeurs valides comprennent -1 pour illimité et tout entier positif. La valeur par défaut est -1.

Le type doit être -1 ou tout entier positif.

Propriétés du paramètre

Jeux de paramètres

-SessionsPerUserMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le nombre maximal de sessions autorisé pour un utilisateur. Si ce dernier atteint ce maximum, la session la plus ancienne est supprimée au démarrage d’une nouvelle session. Les valeurs valides comprennent -1 pour illimité et tout entier positif. La valeur par défaut est 25.

Le type doit être -1 ou tout entier positif.

Propriétés du paramètre

Jeux de paramètres

-SiteCollectionAnonymousSessionsMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le nombre maximum de sessions anonymes autorisées par collection de sites. Une valeur égale à zéro spécifie qu’aucune session anonyme n’est autorisée. Les valeurs valides comprennent -1 pour illimité, 0 pour désactiver le paramètre ou tout entier positif. La valeur par défaut est 25.

Le type doit être -1, 0 ou tout entier positif.

Propriétés du paramètre

Jeux de paramètres

-TerminateProcessOnAccessViolation

Applicable : SharePoint Server 2010, SharePoint Server 2013

Se termine Excel Services Application lorsqu’une violation d’accès se produit dans le processus.

Propriétés du paramètre

Jeux de paramètres

-ThrottleAccessViolationsPerSiteCollection

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie que si un classeur provoque une erreur de violation d’accès sur Excel Services Application, le chargement de tous les fichiers provenant de la collection de sites de ce classeur est bloqué pendant la période spécifiée (en secondes). Les sessions existantes des fichiers de cette collection de sites ne sont pas affectées. Les valeurs valides comprennent 0 pour désactiver le paramètre et entre 1 et 2073600 secondes (24 jours). La valeur par défaut est 0.

Le type doit être une valeur entière comprise entre 1 et 2073600.

Propriétés du paramètre

Jeux de paramètres

-UnattendedAccountApplicationId

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie l’ID d’application utilisé pour rechercher les informations d’identification du compte de service automatisé tiré du service de stockage sécurisé qui est spécifié par le paramètre UnattendedAccountSecureServiceAppName. Le service de stockage sécurisé est contacté lorsque ce paramètre est défini et que des cas d’erreurs spécifiques surviennent. Les valeurs valides sont des chaînes alphanumériques de 256 caractères maximum. La valeur par défaut est une chaîne vide.

Le type doit être une chaîne valide de caractères alphanumériques, par exemple, UnattendedServiceAccountID.

Le compte autonome est un compte unique que tous les classeurs peuvent utiliser pour actualiser les données. Ce compte est requis lorsque les connexions de classeur spécifient None pour l’authentification ou lorsque des informations d’identification non Windows sont utilisées pour actualiser les données.

Propriétés du paramètre

Jeux de paramètres

-UnattendedServiceAccount

Applicable : SharePoint Server 2013

Le compte de service sans assistance est un compte unique que tous les classeurs peuvent utiliser pour actualiser les données. Ce compte est nécessaire pour actualiser les données lorsque les connexions de classeur spécifient « Utiliser le compte de service sans assistance » sans utiliser les informations d’identification Windows.

Propriétés du paramètre

Jeux de paramètres

-UnusedObjectAgeMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie la durée maximale, en minutes, pendant laquelle les objets qui ne sont pas utilisés dans une session sont conservés dans la mémoire cache. Les valeurs valides comprennent -1 pour aucun paramètre maximum et un entier positif compris entre 1 et 34560 minutes (24 jours). La valeur par défaut est -1.

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

Propriétés du paramètre

Jeux de paramètres

-UseEffectiveUserName

Applicable : SharePoint Server 2013

La propriété UseEffectiveUserName est une alternative à la délégation Windows pour permettre aux utilisateurs d’accéder en toute sécurité aux données Analysis Services.

Le paramètre affecte uniquement les connexions de données externes basées sur les connexions de classeur Analysis Services avec un paramètre d’authentification « Utiliser le compte de l’utilisateur authentifié ».

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

-WorkbookCache

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie l’emplacement du système de fichiers local du cache utilisé pour stocker les classeurs utilisés par Excel Services Application.

Si aucune valeur n’est spécifiée, la valeur par défaut est alors un sous-répertoire du répertoire temporaire du système.

Le type doit être un chemin d’accès valide dans l’un des formats suivants :

-- C :\folder_name -- \\server_name\folder_name

Propriétés du paramètre

Jeux de paramètres

-WorkbookCacheSizeMax

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie la taille maximale autorisée, en mégaoctets, d’une session individuelle. La valeur par défaut est 0.

Le type doit être tout entier positif.

Propriétés du paramètre

Jeux de paramètres

-WorkbookModelUsageTracker

Applicable : SharePoint Server 2013

{{Fill WorkbookModelUsageTracker Description}}

Propriétés du paramètre

Jeux de paramètres

CommonParameters