Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
Le fournisseur SQL Server pour Windows PowerShell présente la hiérarchie des objets SQL Server dans des chemins d'accès semblables aux chemins d'accès de système de fichiers. Vous pouvez utiliser les chemins d’accès pour localiser un objet, puis utiliser des méthodes à partir des modèles SMO (SQL Server Management Object) pour effectuer des actions sur les objets.
Remarque
Il existe deux modules SQL Server PowerShell : SqlServer et SQLPS.
Le module SqlServer est le module PowerShell actuel à utiliser.
Le module SQLPS fait partie de l’installation de SQL Server (à des fins de compatibilité descendante), mais il n’est plus mis à jour.
Le module SqlServer contient les versions mises à jour des applets de commande disponibles dans SQLPS ainsi que de nouvelles applets de commande pour prendre en charge les dernières fonctionnalités SQL.
Installez le module SqlServer à partir de PowerShell Gallery.
Pour plus d’informations, consultez SQL Server PowerShell.
Avantages du fournisseur PowerShell SQL Server
Les chemins implémentés par le fournisseur SQL Server permettent d’examiner facilement et de manière interactive tous les objets dans une instance de SQL Server. Vous pouvez parcourir les chemins d'accès à l'aide d'alias Windows PowerShell semblables aux commandes que vous utilisez généralement pour parcourir les chemins d'accès du système de fichiers.
Hiérarchie PowerShell SQL Server
Les produits dont les données ou modèles objets peuvent être représentés dans une hiérarchie utilisent des fournisseurs Windows PowerShell pour exposer les hiérarchies. La hiérarchie est exposée à l’aide d’un lecteur et d’une structure de chemin d’accès similaire au système de fichiers Windows.
Chaque fournisseur Windows PowerShell implémente un ou plusieurs lecteurs. Chaque lecteur est le nœud racine d'une hiérarchie d'objets connexes. Le fournisseur SQL Server implémente un lecteur SQLSERVER. Le fournisseur définit également un ensemble de dossiers principaux pour le lecteur SQLSERVER. Chaque dossier et ses sous-dossiers représentent les objets accessibles à l’aide d’un modèle objet de gestion SQL Server. Lorsque vous vous concentrez sur un sous-dossier dans un chemin d’accès commençant par l’un de ces dossiers principaux, vous pouvez utiliser les méthodes du modèle objet associé pour effectuer des actions sur l’objet représenté par le nœud. Les dossiers Windows PowerShell implémentés par le fournisseur SQL Server sont répertoriés dans le tableau suivant :
| Dossier | Espace de noms du modèle objet SQL Server | Objets |
|---|---|---|
SQLSERVER:\SQL |
Microsoft.SqlServer.Management.Smo Microsoft.SqlServer.Management.Smo.Agent Microsoft.SqlServer.Management.Smo.Broker Microsoft.SqlServer.Management.Smo.Mail |
Objets de base de données, tels que les tables, les vues et les procédures stockées. |
SQLSERVER:\SQLPolicy |
Microsoft.SqlServer.Management.Dmf Microsoft.SqlServer.Management.Facets |
Objets de la Gestion basée sur des stratégies, tels que les stratégies et les facettes. |
SQLSERVER:\SQLRegistration |
Microsoft.SqlServer.Management.RegisteredServers | Objets de serveurs inscrits, tels que des groupes de serveurs et des serveurs inscrits. |
SQLSERVER:\DataCollection |
Microsoft.SqlServer.Management.Collector | Objets du collecteur de données tels que les jeux d'éléments de collecte et magasins de configuration. |
SQLSERVER:\SSIS |
Microsoft.SqlServer.Management.IntegrationServices | Objets SSIS tels que des projets, des packages et des environnements. |
SQLSERVER:\XEvent |
Microsoft.SqlServer.Management.XEvent | Événements étendus SQL Server |
SQLSERVER:\DatabaseXEvent |
Microsoft.SqlServer.Management.XEventDbScoped | Événements étendus SQL Server |
SQLSERVER:\SQLAS |
Microsoft.AnalysisServices | Analysis Services tels que des cubes, des agrégations et des dimensions. |
Par exemple, vous pouvez utiliser le dossier SQLSERVER :\SQL pour démarrer des chemins représentant n’importe quel objet pris en charge par le modèle objet SMO. Le début d’un chemin SQLSERVER:\SQL est SQLSERVER:\SQL\ComputerName\InstanceName. Les nœuds après le nom de l'instance alternent entre des collections d'objets (comme Bases de données ou Vues) et des noms d'objets (comme AdventureWorks2022). Les schémas ne sont pas représentés en tant que classes d'objets. Lorsque vous spécifiez le nœud pour un objet de niveau supérieur dans un schéma, tel qu’une table ou une vue, vous devez spécifier le nom d’objet au format SchemaName.ObjectName.
L'exemple suivant montre le chemin de la table Fournisseur dans le schéma Achat de la base de données AdventureWorks2022 dans une instance par défaut du moteur de base de données sur l'ordinateur local :
SQLSERVER:\SQL\localhost\DEFAULT\Databases\AdventureWorks2022\Tables\Purchasing.Vendor
Pour plus d’informations sur la hiérarchie du modèle objet SMO, consultez /sql/relational-databases/server-management-objects-smo/smo-object-model-diagram.
Les nœuds de collection dans un chemin d'accès sont associés à une classe de collection dans le modèle objet associé. Les nœuds de noms d’objets sont associés à une classe d’objet dans le modèle objet associé, comme indiqué dans le tableau suivant :
| Chemin | Classe SMO |
|---|---|
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases |
Microsoft.SqlServer.Management.Smo.DatabaseCollection> |
SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks2022 |
Microsoft.SqlServer.Management.Smo.Database> |
Tâches du fournisseur SQL Server
| Description de la tâche | Article |
|---|---|
| Décrit comment utiliser des applets de commande Windows PowerShell pour parcourir les nœuds dans un chemin d’accès et, pour chaque nœud, obtenir une liste des objets sur ce nœud. | Parcourir les chemins SQL Server PowerShell |
| Décrit comment utiliser les méthodes et propriétés SMO pour signaler et effectuer un travail sur l’objet qu’un nœud représente dans un chemin d’accès. Explique également comment obtenir la liste des méthodes et des propriétés SMO pour ce nœud. | Utiliser des chemins SQL Server PowerShell |
| Décrit la conversion d’un nom de ressource uniforme (URN) SMO en chemin d’accès du fournisseur SQL Server. | Convert-UrnToPath |
| Décrit comment ouvrir des connexions d’authentification SQL Server à l’aide du fournisseur SQL Server. Par défaut, le fournisseur utilise les connexions d’authentification Windows effectuées à l’aide des informations d’identification du compte Windows exécutant la session Windows PowerShell. | Gérer l’authentification dans le moteur de base de données PowerShell |