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

Les applets de commande Windows PowerShell sont des commandes à fonction unique qui utilisent généralement une convention d’affectation des noms de type « verbe-nom », par exemple Get-Help ou Set-MachineName. Le fournisseur de 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, pour évaluer les stratégies de gestion basée sur des stratégies et pour aider à spécifier des identificateurs SQL Server dans les chemins d'accès de fournisseur SQL Server.

La plupart des scripts Windows PowerShell fonctionnent avec le moteur de base de données à l’aide du fournisseur PowerShell SQL Server 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 applets de commande

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

Noms de paramètres partiels

Il n'est pas nécessaire de spécifier le nom entier d'un paramètre d'applet de commande. Il vous suffit de spécifier une partie suffisante du nom pour le distinguer des autres paramètres pris en charge par l'applet de commande. Ces exemples montrent trois façons différentes 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	Rubrique
Décrit l’utilisation d’Invoke-Sqlcmd pour exécuter des scripts ou des commandes sqlcmd qui contiennent des instructions Transact-SQL ou XQuery. Elle peut accepter l’entrée sqlcmd sous la forme d’un paramètre d’entrée de chaîne de caractères ou sous la forme du nom d’un fichier de script à ouvrir.	Invoke-Sqlcmd, applet de commande
Décrit l’utilisation d’Invoke-PolicyEvaluation pour indiquer 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. Vous pouvez éventuellement utiliser cette applet de commande pour reconfigurer toutes les options définissables dans les objets cibles qui ne sont pas conformes aux conditions des stratégies.	Invoke-PolicyEvaluation (applet de commande)
Décrit l'utilisation des applets de commande 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 l'applet de commande Convert-UrnToPath pour convertir l'URN (Uniform Resource Locator) d'un objet de gestion de SQL Server dans son équivalent de chemin d'accès au 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)