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 utilisent généralement une convention d'affectation des noms « verbe-nom », par exemple 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, 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 travaillent avec le Moteur de base de données en utilisant le fournisseur PowerShell SQL Server et les modèles d'objet 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. Get-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 plus d'informations, consultez Obtenir de l'aide sur 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 de l'applet de commande Invoke-Sqlcmd pour exécuter des scripts sqlcmd ou des commandes 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 de l'applet de commande Invoke-PolicyEvaluation pour indiquer si un jeu d'objets SQL Server cible est conforme ou non aux conditions définies dans les stratégies de gestion basée 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 d'accès de fournisseur SQL Server

Voir aussi

Concepts

Fournisseur PowerShell SQL Server

SQL Server PowerShell

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