Set-SPExcelServiceApplication

Définit les propriétés globales d'une application Excel Services.

Syntax

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>]
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

L’applet Set-ExcelServiceApplication de commande modifie les propriétés d’exécution globales pour Excel Services Application. Les modifications apportées aux propriétés à l’aide de cette applet de commande affectent tous les ordinateurs de la batterie de serveurs qui exécutent une instance de l’application de service Web Excel Services Application spécifiée.

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

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

Cet exemple montre comment définir la Excel Services Application pour permettre à chaque utilisateur d’ouvrir au plus 10 sessions à la fois sur un serveur d’applications principal qui s’exécute Excel Services Application.

--------------EXEMPLE 2--------------

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

Cet exemple définit le nombre maximal d’octets privés de mémoire sur l’ordinateur sur une valeur de -1, ce qui indique que Excel Services Application consommera 50 % des ressources mémoire disponibles.

Paramètres

-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

-CachingOfUnusedFilesEnable

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.

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

-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

-CrossDomainAccessAllowed

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.

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

-EncryptedUserConnectionRequired

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.

Type:EncryptedConnectionMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-ExternalDataConnectionLifetime

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.

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

-FileAccessMethod

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.

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

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

-LoadBalancingScheme

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.

Type:LoadBalancingScheme
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-MemoryCacheThreshold

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.

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

-PrivateBytesMax

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.

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

-SessionsPerUserMax

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.

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

-SiteCollectionAnonymousSessionsMax

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.

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

-TerminateProcessOnAccessViolation

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

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

-ThrottleAccessViolationsPerSiteCollection

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.

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

-UnattendedAccountApplicationId

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.

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

-UnattendedServiceAccount

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 d’informations d’identification Windows.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013

-UnusedObjectAgeMax

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.

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

-UseEffectiveUserName

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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

-WorkbookCache

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

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

-WorkbookCacheSizeMax

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.

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

-WorkbookModelUsageTracker

{{Fill WorkbookModelUsageTracker Description}}

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013