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 du runtime global pour Excel Services Application. Les modifications apportées aux propriétés qui sont apportées à l’aide de cette applet de commande affectent toutes les machines 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 l’Excel Services Application permettant à chaque utilisateur d’ouvrir pas plus de 10 sessions à la fois sur un serveur d’applications back-end 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

- Identité

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

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:1
Default value:None
Accept pipeline input:True
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

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

-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
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
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 Restez actif 1 seconde à 24 jours.

La valeur par défaut est 1800.

Type:Int32
Position:Named
Default value:None
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 de classeur en tant qu’utilisateur qui effectue la requête. 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
Accept pipeline input:False
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 back-end. 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-MemoryCacheThreshold

Specifies the percentage of the maximum private bytes that can be allocated to inactive objects. When the memory cache threshold is exceeded, cached objects that are not currently in use are released. Setting this value to 0 disables caching of inactive objects. The default value is 90.

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

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

-SessionsPerUserMax

Specifies the maximum number of sessions allowed for a user. If a user reaches this maximum the oldest session is deleted when a new session is started. Valid values include -1 for no limit, and any positive integer. The default value is 25.

Le type doit être -1 ou tout 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

-SiteCollectionAnonymousSessionsMax

Specifies the maximum number of anonymous sessions allowed per site collection. A value of 0 specifies that no anonymous sessions are allowed. Valid values include -1 for no limit, 0 to disable the setting, or any positive integer. The default value is 25.

Le type doit être -1, 0 ou tout 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

-TerminateProcessOnAccessViolation

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

Type:SwitchParameter
Position:Named
Default value:None
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, tous les fichiers provenant de la collection de sites de ce classeur ne peuvent pas être chargés 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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013

-UnattendedAccountApplicationId

Specifies that the application ID that is used to look up the unattended service account credentials from the secure storage service that is specified by the UnattendedAccountSecureServiceAppName parameter. The secure storage service is contacted when this parameter is set and specific error cases occur. Valid values are alphanumeric strings with a maximum of 256 characters. The default value is an empty string.

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

The unattended account is a single account that all workbooks can use to refresh data. An unattended account is required when workbook connections specify None for authentication, or when any non-Windows credentials are used to refresh data.

Type:String
Position:Named
Default value:None
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 les informations d’identification Windows.

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

-UnusedObjectAgeMax

Specifies the maximum amount of time, in minutes, that objects not currently used in a session are kept in the memory cache. Valid values include -1 for no maximum setting, and a positive integer in the range of 1 to 34560 minutes (24 days). The default value is -1.

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

Type:Int32
Position:Named
Default value:None
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.

Ce paramètre impacte 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
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
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
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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2013