sqlps (utilitaire)

Article
03/08/2017

L’utilitaire sqlps démarre une session Windows PowerShell 2.0 avec les SQL Server fournisseur PowerShell et les applets de commande chargées et inscrites. Vous pouvez entrer des scripts ou des commandes PowerShell qui utilisent les composants SQL Server PowerShell pour travailler avec des instances de SQL Server et leurs objets.

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server. Évitez d'utiliser cette fonctionnalité dans de nouveaux travaux de développement, et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Utilisez plutôt le module sqlps PowerShell. Pour plus d’informations sur le sqlps module, consultez Importer le module SQLPS.

Syntaxe

  
      sqlps   
[ [ [ -NoLogo ][ -NoExit ][ -NoProfile ]  
    [ -OutPutFormat { Text | XML } ] [ -InPutFormat { Text | XML } ]  
  ]  
  [ -Command { -  
             | script_block [ -argsargument_array ]  
             | string [ command_parameters ]  
             }  
  ]  
]  
[ -? | -Help ]

Arguments

-NoLogo
Spécifie que l'utilitaire sqlps doit masquer la bannière de copyright lorsqu'il démarre.

-NoExit
Spécifie que l'utilitaire sqlps doit poursuivre son exécution après le lancement des commandes de démarrage.

-NoProfile
Spécifie que l'utilitaire sqlps ne doit pas charger de profil utilisateur. Les profils utilisateur enregistrent des alias, fonctions et variables fréquemment utilisés en vue de leur utilisation au cours de différentes sessions PowerShell.

-OutPutFormat { Text | XML }
Spécifie que la sortie de l’utilitaire sqlps doit être mise en forme en tant que chaînes de texte (Texte) ou au format CLIXML sérialisé (XML).

-InPutFormat { Text | XML }
Spécifie que l’entrée dans l’utilitaire sqlps est mise en forme sous forme de chaînes de texte (Texte) ou au format CLIXML sérialisé (XML).

-Command
Spécifie la commande de l'utilitaire sqlps à utiliser. L’utilitaire sqlps exécute la commande, puis se ferme, sauf si -NoExit est également spécifié. Ne spécifiez pas d’autres commutateurs après -Command, car ils seront lus comme des paramètres de commande.

-
-Command- spécifie que l’utilitaire sqlps lit l’entrée à partir de l’entrée standard.

script_block [ -argsargument_array ]
Spécifie un bloc de commandes PowerShell à exécuter ; le bloc doit être placé entre des accolades : {}. Script_block ne peut être spécifié que lorsque l’utilitaire sqlps est appelé à partir de PowerShell ou d’une autre sqlps session de l’utilitaire. argument_array est un tableau de variables PowerShell contenant les arguments pour les commandes PowerShell de script_block.

string [ command_parameters ]
Spécifie une chaîne qui contient les commandes PowerShell à exécuter. Utilisez le format « &{command} ». Les guillemets indiquent une chaîne, et l’opérateur invoke (&) entraîne l’exécution de la commande par l’utilitaire sqlps .

[ -? | -Help ]
Affiche le récapitulatif de la syntaxe des options de l'utilitaire sqlps.

Remarques

L’utilitaire sqlps démarre l’environnement PowerShell (PowerShell.exe) et charge le module PowerShell SQL Server. Le module, également nommé sqlps, charge et inscrit ces SQL Server composants logiciels enfichables PowerShell :

Microsoft.SqlServer.Management.PSProvider.dll

Implémente le fournisseur SQL Server PowerShell et les applets de commande associées, comme Encode-SqlName et Decode-SqlName.
Microsoft.SqlServer.Management.PSSnapin.dll

Implémente les applets de commande Invoke-Sqlcmd et Invoke-PolicyEvaluation .

Vous pouvez recourir à l'utilitaire sqlps pour effectuer les opérations suivantes :

exécuter des commandes PowerShell de façon interactive ;
exécuter des fichiers script PowerShell ;
Exécutez les applets de commande SQL Server.
Utilisez les chemins du fournisseur SQL Server pour parcourir la hiérarchie des objets SQL Server.

Par défaut, l’utilitaire s’exécute sqlps avec la stratégie d’exécution de scripts définie sur Restreint. Cela empêche l'exécution de scripts PowerShell. Vous pouvez utiliser l’applet de commande Set-ExecutionPolicy pour activer l’exécution de scripts signés ou de tout type de script. Exécutez uniquement des scripts provenant de sources fiables et sécurisez tous les fichiers d'entrée et de sortie en utilisant les autorisations NTFS appropriées. Pour plus d'informations sur l'activation de scripts PowerShell, consultez Exécution de scripts Windows PowerShell.

La version de l’utilitaire sqlps dans SQL Server 2008 et SQL Server 2008 R2 a été implémentée en tant que mini-shell Windows PowerShell 1.0. Les mini-shells comportent certaines restrictions, comme le fait de ne pas autoriser les utilisateurs à charger des composants logiciels enfichables autres que ceux chargés par le mini-shell. Ces restrictions ne s’appliquent pas aux versions SQL Server 2012 et ultérieures de l’utilitaire, qui ont été modifiées pour utiliser le sqlps module.

Exemples

sqlps -NoLogo

B. Exécution d'un script SQL Server PowerShell à partir de l'invite de commandes

sqlps -Command "&{.\MyFolder.MyScript.ps1}"

C. Exécution d'un script SQL Server PowerShell à partir de l'invite de commandes et poursuite de l'exécution une fois le script terminé

sqlps -NoExit -Command "&{.\MyFolder.MyScript.ps1}"

Voir aussi

Activer ou désactiver un protocole réseau de serveur
SQL Server PowerShell

Partager via