Partager via


New-SPExcelDataProvider

Ajoute un nouveau fournisseur de données approuvé à l'application Excel Services.

Syntaxe

Default (Par défaut)

New-SPExcelDataProvider
    -ExcelServiceApplication <SPExcelServiceApplicationPipeBind>
    -ProviderId <String>
    -ProviderType <DataProviderType>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-Description <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

L’applet New-SPExcelDataProvider de commande ajoute un fournisseur de données à la liste des fournisseurs de données sécurisés dans une application de service web Excel Services Application. Excel Services Application actualise les connexions de données externes uniquement si le fournisseur de données d’une connexion figure dans la liste des fournisseurs de données sécurisés. Excel Services Application inclut un ensemble de fournisseurs de données courants dans cette liste. Par conséquent, l’utilisation d’applets de commande pour modifier les fournisseurs de données approuvés est généralement réservée aux scénarios de connexions de données personnalisés.

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

Get-SPExcelServiceApplication -identity "MyExcelService" | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"

Cet exemple ajoute un nouveau fournisseur de données OLEDB personnalisé à la liste des fournisseurs de données sécurisés pour l’application de service Web Excel Services Application nommée MyExcelService.

EXEMPLE 2

Get-SPExcelServiceApplication | New-SPExcelDataProvider -providerID "CustomOLEDB" -ProviderType OleDb -description "This is a custom OLEDB provider"

Cet exemple ajoute un nouveau fournisseur de données OLEDB personnalisé à la liste des fournisseurs de données sécurisés pour toutes les applications de service web Excel Services Application de la batterie de serveurs.

Paramètres

-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 une description conviviale du nouveau fournisseur de données.

Le type doit être une chaîne valide, par exemple, « Ceci est un fournisseur OLEDB personnalisé ».

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

-ExcelServiceApplication

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie l’application de service web Excel Services Application qui contient l’objet de liste SPExcelDataProvider.

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

-ProviderId

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le nom du fournisseur. Cet ID doit être présent dans les chaînes de connexion générées par ce fournisseur et l’ID doit être unique pour le type de fournisseur.

Le type doit correspondre à un nom de fournisseur valide, par exemple, CustomOLEDB.

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:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ProviderType

Applicable : SharePoint Server 2010, SharePoint Server 2013

Spécifie le type de fournisseur de données pris en charge à ajouter à la liste des fournisseurs approuvés.

Le type doit être l’un des suivants : OleDb, Odbc ou OdbcDsn.

Propriétés du paramètre

Type:DataProviderType
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:False
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.