Partager via


Utiliser les applets de commande du moteur de base de données

Les applets de commande Windows PowerShell sont des commandes à fonction unique qui ont généralement une convention de nommage verbe-nom, telle que Get-Help ou Set-MachineName. Le fournisseur SQL Server pour Windows PowerShell fournit des applets de commande spécifiques à SQL Server.

Applets de commande du moteur de base de données

SQL Server implémente un petit nombre d’applets de commande pour le moteur de base de données. Ces applets de commande sont principalement utilisées pour exécuter des scripts Transact-SQL existants à partir de nouveaux scripts PowerShell, évaluer des stratégies de gestion basées sur des stratégies et aider à spécifier des identificateurs SQL Server dans les chemins du fournisseur SQL Server.

La plupart des scripts Windows PowerShell fonctionnent avec le moteur de base de données à l’aide du fournisseur SQL Server PowerShell et des modèles objet de facilité de gestion SQL Server. Pour plus d’informations, consultez sql Server PowerShell.

Obtenir de l'aide sur les cmdlets

Dans l’environnement Windows PowerShell, l’applet de commande Get-Help fournit des informations d’aide pour chaque applet de commande. Get-Help retourne des informations telles que la syntaxe, les définitions de paramètres, les types d’entrée et de sortie, ainsi qu’une description de l’action effectuée par l’applet de commande. Pour en savoir plus, voir Get Help SQL Server PowerShell.

Noms de paramètres partiels

Vous n’avez pas besoin de spécifier l’intégralité du nom d’un paramètre d’applet de commande. Vous devez uniquement spécifier suffisamment de nom pour le séparer de manière unique des autres paramètres pris en charge par l’applet de commande. Par exemple, ces exemples montrent trois façons de spécifier le paramètre Invoke-Sqlcmd -QueryTimeout :

Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryTimeout 3  
Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryTime 3  
Invoke-Sqlcmd -Query "SELECT @@VERSION;" -QueryT 3  

Tâches d’applet de commande du moteur de base de données

Description de la tâche Sujet
Décrit l’utilisation d’Invoke-Sqlcmd pour exécuter des scripts ou des commandes sqlcmd qui contiennent des instructions Transact-SQL ou XQuery. Il peut accepter l’entrée sqlcmd comme paramètre d’entrée de chaîne de caractères ou comme nom d’un fichier de script à ouvrir. Invoke-Sqlcmd, applet de commande
Décrit l’utilisation de Invoke-PolicyEvaluation pour signaler si un ensemble cible d’objets SQL Server est conforme aux conditions définies dans les stratégies de gestion basées sur des stratégies. Si vous le souhaitez, le cmdlet peut être utilisé pour reconfigurer toutes les options modifiables dans les objets cibles qui ne respectent pas les conditions de la stratégie. Invoke-PolicyEvaluation (applet de commande)
Décrit l'utilisation de Encode-Sqlname et Decode-Sqlname pour gérer les identificateurs SQL Server qui contiennent des caractères non pris en charge dans les chemins d'accès Windows PowerShell. Encoder et décoder des identificateurs SQL Server
Décrit l'utilisation de Convert-UrnToPath pour convertir un Nom de Ressource Uniforme (URN) de l’objet de gestion SQL Server en chemin d’accès équivalent du fournisseur SQL Server. Convertir des URN en chemins de fournisseur SQL Server

Voir aussi

Fournisseur SQL Server PowerShell
SQL Server PowerShell
Vue d’ensemble des applets de commande PowerShell pour les groupes de disponibilité AlwaysOn (SQL Server)