Partager via

  • Article

Utilitaire sqlps

L'utilitaire sqlps démarre une session PowerShell avec les applets de commande et le fournisseur PowerShell pour SQL Server chargés et inscrits. Vous pouvez entrer des commandes ou des scripts PowerShell qui utilisent les composants PowerShell SQL Server pour travailler avec des instances de SQL Server et leurs objets.

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 sqlps doit masquer la bannière de copyright lorsqu'il démarre.

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

  • -NoProfile
    Spécifie que 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 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 fournie à 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 que sqlps doit exécuter. 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 sqlps doit lire l'entrée de l'entrée standard.

  • script_block [ -argsargument_array ]
    Spécifie un bloc de commandes PowerShell à exécuter, bloc qui doit figurer entre accolades : {}. Script_block peut être spécifié uniquement lorsque sqlps est appelé à partir de PowerShell ou de 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 sqlps.

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

Notes

L'utilitaire sqlps démarre l'environnement PowerShell (PowerShell.exe) avec les composants logiciels enfichables PowerShell SQL Server chargés et inscrits. Les composants logiciels enfichables PowerShell SQL Server sont les suivants :

  • 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 l'applet de commande Invoke-Sqlcmd.

Vous pouvez utiliser 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, sqlps s'exécute avec le niveau Restreint de la stratégie d'exécution de scripts. Ce paramètre empêche l'exécution de tout script PowerShell. Vous pouvez utiliser l'applet de commande Set-ExecutionPolicy pour activer l'exécution de scripts signés uniquement 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 (en anglais).

Exemples

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

sqlps -NoLogo

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

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

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

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