New-SPExcelServiceApplication
Crée une instance d'application Excel Services.
Syntax
New-SPExcelServiceApplication
-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
[-Name <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CachingOfUnusedFilesEnable]
[-Confirm]
[-CrossDomainAccessAllowed]
[-Default]
[-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>]
New-SPExcelServiceApplication
-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
[-Name <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-CachingOfUnusedFilesEnable]
[-Confirm]
[-CrossDomainAccessAllowed]
[-Default]
[-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 New-SPExcelServiceApplication
de commande crée une application de service web Excel Services Application avec de nouveaux paramètres.
Après avoir créé une application de service web Excel Services Application, vous pouvez utiliser l’applet Set-SPExcelServiceApplication
de commande pour modifier les paramètres globaux de la nouvelle application.
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------------------
New-SPExcelServiceApplication -Name "MyExcelService" -ApplicationPool "SharePoint Services"
Cet exemple crée une instance de Excel Services Application avec le nom d’affichage MyExcelService.
------------------EXEMPLE 2------------------
New-SPExcelServiceApplication -Name "My Excel Service" -ApplicationPool "SharePoint Services" -SessionsPerUserMax 5
Cet exemple crée une instance de Excel Services Application avec le nom d’affichage My Excel Service et n’autorise que cinq sessions par utilisateur pour chaque ordinateur serveur d’applications principal exécutant Excel Services Application.
Paramètres
-ApplicationPool
Spécifie le pool d’applications IIS existant dans lequel exécuter le service Web pour la nouvelle application Excel Service.
Le type doit être un objet SPIisWebServiceApplicationPool valide.
Type: | SPIisWebServiceApplicationPoolPipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-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 |
-Default
Spécifie que le proxy de cette application de service est ajouté au groupe de proxys par défaut de la batterie de serveurs.
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 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 |
-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 principaux qui exécutent les services de calcul Excel. 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 |
-Name
Spécifie un nom convivial pour la nouvelle application de service web Excel Services Application. Le nom que vous utilisez doit être le nom unique d’une application de service web Excel Services Application qui se trouve dans cette batterie de serveurs. Il doit comporter 128 caractères au maximum. La valeur par défaut est Service_numofapplications+1.
Le type doit être une chaîne valide ; par exemple, MyExcelServiceApp1.
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 |
-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 |
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 un utilisateur 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 qui proviennent 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 que l’ID d’application utilisé pour rechercher les informations d’identification du compte de service sans assistance à partir du service de banque d’informations sécurisée spécifié par UnattendedAccountSecureServiceAppName. Le service de magasin sécurisé est contacté lorsque ce paramètre est défini et que des cas d’erreur spécifiques se produisent. 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
{{Fill UnattendedServiceAccount Description}}
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2010, 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
{{Fill UseEffectiveUserName Description}}
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 |
-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 un sous-répertoire dans le répertoire temporaire 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 2010, SharePoint Server 2013 |