Share via


Utilitaire sqlps

L'utilitaire sqlps démarre une session Windows PowerShell 2.0 avec les applets de commande et le fournisseur SQL Server PowerShell chargés et inscrits. 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 module sqlps, consultez Importer le module SQLPS.

Syntaxe

sqlps 
[ [ [ -NoLogo ][ -NoExit ][ -NoProfile ]
    [ -OutPutFormat { Text | XML } ] [ -InPutFormat { Text | XML } ]
  ]
  [ -Command { -
             | script_block [ -args argument_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 (Text) ou sous un format CLIXML sérialisé (XML).

  • -InPutFormat { Text | XML }
    Spécifie que l'entrée de l'utilitaire sqlps doit être mise en forme en tant que chaînes de texte (Text) ou sous un 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 indiqué. 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 doit lire l'entrée de l'entrée standard.

  • script_block [ -argsargument_array ]
    Spécifie un bloc de commandes PowerShell à exécuter ; le bloc doit être placé entre accolades : {}. Script_block peut être spécifié uniquement quand l'utilitaire sqlps est appelé depuis PowerShell ou une autre session de l'utilitaire sqlps. 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 d'appel (&) 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.

Notes

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

  • Microsoft.SqlServer.Management.PSProvider.dll

    Implémente le fournisseur PowerShell pour SQL Server 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écuter des applets de commande SQL Server ;

  • utiliser les chemins d'accès du fournisseur SQL Server pour naviguer dans la hiérarchie des objets SQL Server.

Par défaut, l'utilitaire sqlps s'exécute avec le niveau Restricted de la stratégie d'exécution de scripts. Cela empêche l'exécution de scripts PowerShell. Vous pouvez utiliser l'applet de commande Set-ExecutionPolicy pour activer l'exécution des scripts signés, ou de tous les scripts. 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 à la version SQL Server 2012 de l'utilitaire, qui a été modifiée pour utiliser le module sqlps.

Exemples

A. Exécution de l'utilitaire sqlps en mode interactif par défaut, sans bannière de copyright

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

Concepts

Activer ou désactiver un protocole réseau de serveur

SQL Server PowerShell