Set-SPExcelUserDefinedFunction
Définit les propriétés d'une fonction définie par l'utilisateur dans l'application Excel Services.
Syntaxe
Default (Par défaut)
Set-SPExcelUserDefinedFunction
[-Identity] <SPExcelUDFPipeBind>
-ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
[-Assembly <String>]
[-AssemblyLocation <AssemblyLocation>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-Description <String>]
[-Enable]
[-WhatIf]
[<CommonParameters>]
Description
L’applet Set-SPExcelUserDefinedFunction de commande définit les propriétés d’un assembly de fonction défini par l’utilisateur.
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 1
Set-SPExcelUserDefinedFunction -ExcelServiceApplication "My Excel Service" -Identity SampleCompany.SampleApplication.SampleUdf -Description "This is the new description for the sample UDF"
Cet exemple modifie la description de la fonction définie par l’utilisateur (UDF) en fichier UDF SampleCompany.SampleApplication.SampleUdf pour l’application de service Web Excel Services Application nommée My Excel Service.
EXEMPLE 2
Get-SPExcelServiceApplication "My Excel Service" | Set-SPExcelUserDefinedFunction -Identity SampleCompany.SampleApplication.SampleUdf -Enable: $false
Cet exemple montre comment désactiver l’exemple de fichier UDF SampleCompany.SampleApplication.SampleUdf du Excel Services Application nommé My Excel Service.
Paramètres
-Assembly
Applicable : SharePoint Server 2010, SharePoint Server 2013
Spécifie le nom fortement typé de l’assembly. Le nom doit être unique dans la liste des fonctions définies par l’utilisateur et ne peut pas comporter plus 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 ou \\MyNetworkServer\UDFs\SampleUdf.dll.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AssemblyLocation
Applicable : SharePoint Server 2010, SharePoint Server 2013
Spécifie l’emplacement de stockage de l’assembly.
Le type doit être l’un des suivants : GAC ou LocalFile.
Propriétés du paramètre
| Type: | AssemblyLocation |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-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
| Type: | SPAssignmentCollection |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-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
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Description
Applicable : SharePoint Server 2010, SharePoint Server 2013
Spécifie la description de la fonction définie par l’utilisateur. Le nom ne peut pas dépasser 4096 caractères alphanumériques.
Le type doit être une chaîne de caractères alphanumériques, par exemple, « Ceci est la fonction définie par l’utilisateur pour les rapports de consolidation ».
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Enable
Applicable : SharePoint Server 2010, SharePoint Server 2013
Active la fonction définie par l’utilisateur pour une utilisation avec Excel Services Application.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ExcelServiceApplication
Applicable : SharePoint Server 2010, SharePoint Server 2013
Spécifie l’application de service web Excel Services Application qui contient l’objet de liste SPExcelUserDefinedFunction.
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
| Type: | SPExcelServiceApplicationPipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Identity
Applicable : SharePoint Server 2010, SharePoint Server 2013
Spécifie l’objet SPExcelUserDefinedFunction à mettre à jour.
Le type doit être un nom valide de l’assembly de code ; par exemple, SampleCompany.SampleApplication.SampleUdf ; ou un instance d’un objet SPExcelUDF valide.
Propriétés du paramètre
| Type: | SPExcelUDFPipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-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
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.