Install-SPDataConnectionFile

 

Sapplique à :SharePoint Server 2013 Enterprise

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

Installe le fichier de connexion de données fourni.

Install-SPDataConnectionFile [-Path] <String> [-AssignmentCollection <SPAssignmentCollection>] [-Category <String>] [-Confirm [<SwitchParameter>]] [-Overwrite <SwitchParameter>] [-WebAccessible <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

L’applet de commande Install-SPDataConnectionFile installe le fichier de connexion de données fourni. S’il existe, l’utilisateur est invité à remplacer le fichier existant.

Cette applet de commande ne crée pas de nouveau fichier. En revanche, elle crée un nouvel objet de fichier de connexion de données.

SharePoint Management Shell

 

Paramètre Obligatoire Type Description

chemin_accès

Requis

System.String

Spécifie le chemin d’accès complet au nom du fichier dans la banque de connexions de données.

Le type doit être le nom d’un fichier de connexion de données valide comme C:\foldername\myconnection.udcx.

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

Overwrite

Facultatif

System.Management.Automation.SwitchParameter

Remplace le fichier de connexion de données existant. La valeur par défaut est False.

WebAccessible

Facultatif

System.Management.Automation.SwitchParameter

Spécifie que le fichier de connexion de données universelle est accessible via le service web. Si la valeur est False, seul Forms Server 2013 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-----------------

Install-SPDataConnectionFile -Path .\folder\sample.udcx -Category "Install" -WebAccessible $true
".\folder\sample.udcx" | Install-SPDataConnectionFile -Category "Install" -Category "Category1"  -Overwrite $true

Cet exemple télécharge le fichier de connexion de données dans une catégorie spécifique.

Cette applet de commande équivaut au paramètre de l’interface utilisateur Télécharger un fichier de connexion de données qui se trouve sur la page Gérer les fichiers de connexion de données du site web Administration centrale de SharePoint.

Afficher: