New-SPExcelUserDefinedFunction
Ajoute une nouvelle fonction définie par l'utilisateur à l'application Excel Services.
Syntax
New-SPExcelUserDefinedFunction
-Assembly <String>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-AssemblyLocation <AssemblyLocation>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-Enable]
[-WhatIf]
[<CommonParameters>] Description
L’applet New-SPExcelUserDefinedFunction de commande ajoute une fonction définie par l’utilisateur à une application de service web Excel Services Application.
Excel Services Application utilise uniquement les fonctions définies par l’utilisateur qui ont une entrée dans la liste des fonctions définies par l’utilisateur.
Les fonctions définies par l’utilisateur sont des assemblys de code managé qui peuvent être appelés à partir d’un classeur Excel Services Application à l’aide de la syntaxe de formule standard Excel Services Application.
Les assemblys peuvent effectuer une logique personnalisée ou d’autres actions, comme l’actualisation des données.
Les applets de commande Windows PowerShell opèrent sur les entrées de la liste des fonctions définies par l’utilisateur et non sur les assemblys.
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------------------
Get-SPExcelServiceApplication | New-SPExcelUserDefinedFunction -Assembly "SampleCompany.SampleApplication.SampleUdf" -AssemblyLocation GACCet exemple ajoute le fichier SampleComany.SampleApplication.SampleUdf à chaque application de service web Excel Services Application dans la batterie de serveurs.
L’assembly de la fonction définie par l’utilisateur est déployé dans le Global Assembly Cache (GAC).
Paramètres
-Assembly
Spécifie le nom fortement typé de l’assembly. Le nom doit être unique dans la liste des fonctions définies par l’utilisateur. Le nom peut comporter un maximum de 4 096 caractères alphanumériques.
Le type doit être une chaîne de caractères alphanumériques, par exemple :
-- SampleCompany.SampleApplication.SampleUdf -- C:\UDFs\SampleUdf.dll -- \\MyNetworkServer\UDFs\SampleUdf.dll
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2010, SharePoint Server 2013 |
-AssemblyLocation
Spécifie l’emplacement de stockage de l’assembly. La valeur par défaut est GAC.
Le type doit être l’un des suivants : GAC ou LocalFile.
| Type: | AssemblyLocation |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-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 |
-Description
Spécifie une description conviviale de la fonction définie par l’utilisateur. Le nom peut contenir 4096 caractères alphanumériques 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 « Ceci est la fonction définie par l’utilisateur pour les rapports de consolidation ».
| 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 |
-Enable
Active la fonction définie par l’utilisateur pour une utilisation avec Excel Services Application. La valeur par défaut est True.
| 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 |
-ExcelServiceApplication
Spécifie l’application de service web Excel Services Application qui contient la liste des fonctions définies par l’utilisateur.
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: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| 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 |