Set-SPDataConnectionFile

 

Sapplique à :SharePoint Server 2013 Enterprise

Dernière rubrique modifiée :2015-03-09

Définit les propriétés d’un fichier de connexion de données.

Set-SPDataConnectionFile [-Identity] <SPDataConnectionFilePipeBind> [-AssignmentCollection <SPAssignmentCollection>] [-Category <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-DisplayName <String>] [-WebAccessible <String>] [-WhatIf [<SwitchParameter>]]

L’applet de commande Set-SPDataConnectionFile définit les propriétés du fichier de connexion de données spécifié dans le paramètre Identity.

SharePoint Management Shell

 

Paramètre Requis Type Description

Identity

Requis

Microsoft.Office.InfoPath.Server.Cmdlet.SPDataConnectionFilePipeBind

Spécifie le fichier de connexion de données à mettre à jour.

Le type doit correspondre à un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh, un nom valide de fichier de connexion de données (par exemple, DataConnectionFileName1.udcx) ou une instance d’objet SPDataConnectionFile valide.

AssignmentCollection

Facultatif

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

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.

RemarqueRemarque :
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.

Category

Facultatif

System.String

Définit une catégorie arbitraire sur le fichier, qui peut être utilisée pour regrouper les fichiers. Le nom de la catégorie peut comporter un maximum de 255 caractères.

Le type doit être une valeur de chaîne valide ; par exemple, Category1.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Vous demande confirmation avant d’exécuter la commande. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

Description

Facultatif

System.String

Définit la description du fichier de connexion de données. Le nom peut comporter un maximum de 4 096 caractères alphanumériques.

Le type doit être une chaîne valide comme Description de mon fichier de connexion de données universelle.

DisplayName

Facultatif

System.String

Spécifie le nom complet qui décrit le fichier de connexion de données. Il peut comporter jusqu’à 255 caractères.

Le type doit être une chaîne valide comme InfoPathUDC1.

WebAccessible

Facultatif

System.String

Spécifie que le fichier de connexion de données universelle est accessible via le service web. Si la valeur est False, seul le serveur de formulaires peut récupérer les fichiers de connexion de données universelle en interne. La valeur par défaut est False.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

--------------EXEMPLE-----------------

Set-SPDataConnectionFile -Identity "sample.udcx" -Category "Temp"

Cet exemple met à jour la valeur Category du fichier .udcx spécifié.

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

Set-SPDataConnectionFile -Identity "sample.udcx" -DisplayName "NewDisplayName"

Cet exemple met à jour la valeur DisplayName du fichier .udcx spécifié.

---------------EXEMPLE 3--------------

Sample.udcx" | Set-SPDataConnectionFile -Category "Temp"

Cet exemple met à jour la valeur Category du fichier .udcx spécifié.

---------------EXEMPLE 4--------------

Get-SPDataConnectionFile | where {$_.Category -eq "Category1"}  | Set-SPDataConnectionFile -Category "Category2"

Cet exemple met à jour la valeur Category de la collection de fichiers .udcx renvoyés par une requête utilisée par l’application de commande Get-SPDataConnectionFile.

Afficher: