sqlps (utilitaire)sqlps Utility

Cette rubrique s’applique à : OuiSQL ServerOuibase de données SQL AzureOuiAzure SQL Data Warehouse Oui Parallel Data WarehouseTHIS TOPIC APPLIES TO: yesSQL ServeryesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

L’utilitaire sqlps démarre une session Windows PowerShell avec le fournisseur PowerShell SQL ServerSQL Server et les applets de commande chargés et inscrits.The sqlps utility starts a Windows PowerShell session with the SQL ServerSQL Server PowerShell provider and cmdlets loaded and registered. Vous pouvez entrer des scripts ou des commandes PowerShell qui utilisent les composants SQL ServerSQL Server PowerShell pour travailler avec des instances de SQL ServerSQL Server et leurs objets.You can enter PowerShell commands or scripts that use the SQL ServerSQL Server PowerShell components to work with instances of SQL ServerSQL Server and their objects.

Important

Cette fonctionnalité sera supprimée dans une prochaine version de Microsoft SQL Server.This feature will be removed in a future version of 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é.Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Utilisez à la place le module PowerShell sqlps. Use the sqlps PowerShell module instead. Pour plus d’informations sur le module sqlps , consultez Import the SQLPS Module.For more information about the sqlps module, see Import the SQLPS Module.

SyntaxeSyntax


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

ArgumentsArguments

-NoLogo-NoLogo
Spécifie que l’utilitaire sqlps doit masquer la bannière de copyright quand il démarre.Specifies that the sqlps utility hide the copyright banner when it starts.

-NoExit-NoExit
Spécifie que l’utilitaire sqlps doit poursuivre son exécution après le lancement des commandes de démarrage.Specifies that the sqlps utility continue running after the startup commands have completed.

-NoProfile-NoProfile
Spécifie que l’utilitaire sqlps ne doit pas charger de profil utilisateur.Specifies that the sqlps utility not load a user profile. 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.User profiles record commonly used aliases, functions, and variables for use across PowerShell sessions.

-OutPutFormat { Text | XML }-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 format CLIXML sérialisé (XML).Specifies that the sqlps utility output be formatted as either text strings (Text) or in a serialized CLIXML format (XML).

-InPutFormat { Text | XML }-InPutFormat { Text | XML }
Spécifie que l’entrée de l’utilitaire sqlps est mise en forme en tant que chaînes de texte (Text) ou format CLIXML sérialisé (XML).Specifies that input to the sqlps utility is formatted as either text strings (Text) or in a serialized CLIXML format (XML).

-Command-Command
Spécifie la commande que l’utilitaire sqlps doit exécuter.Specifies the command for the sqlps utility to run. L’utilitaire sqlps exécute la commande, puis se ferme, sauf si -NoExit est également spécifié.The sqlps utility runs the command and then exits, unless -NoExit is also specified. Ne spécifiez pas d’autres commutateurs après -Command, car ils seront lus comme des paramètres de commande.Do not specify any other switches after -Command, they will be read as command parameters.


-Command- spécifie que l’utilitaire sqlps doit lire l’entrée à partir de l’entrée standard.-Command- specifies that the sqlps utility read the input from the standard input.

script_block [ -argsargument_array ]script_block [ -argsargument_array ]
Spécifie un bloc de commandes PowerShell à exécuter ; le bloc doit être placé entre des accolades : {}.Specifies a block of PowerShell commands to run, the block must be enclosed in braces: {}. Script_block peut uniquement être spécifié quand l’utilitaire sqlps est appelé depuis PowerShell ou une autre session de l’utilitaire sqlps .Script_block can only be specified when the sqlps utility is called from either PowerShell or another sqlps utility session. argument_array est un tableau de variables PowerShell contenant les arguments pour les commandes PowerShell de script_block.The argument_array is an array of PowerShell variables containing the arguments for the PowerShell commands in the script_block.

string [ command_parameters ]string [ command_parameters ]
Spécifie une chaîne qui contient les commandes PowerShell à exécuter.Specifies a string that contains the PowerShell commands to be run. Utilisez le format "&{command}".Use the 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.The quotation marks indicate a string, and the invoke operator (&) causes the sqlps utility to run the command.

[ -?[ -? | -Help ] | -Help ]
Affiche le résumé de la syntaxe des options de l’utilitaire sqlps .Shows the syntax summary of the sqlps utility options.

Notes Remarks

L’utilitaire sqlps démarre l’environnement PowerShell (PowerShell.exe) et charge le module SQL ServerSQL Server PowerShell.The sqlps utility starts the PowerShell environment (PowerShell.exe) and loads the SQL ServerSQL Server PowerShell module. Le module, également nommé sqlps, charge et inscrit ces composants logiciels enfichables SQL ServerSQL Server PowerShell :The module, also named sqlps, loads and registers these SQL ServerSQL Server PowerShell snap-ins:

  • Microsoft.SqlServer.Management.PSProvider.dllMicrosoft.SqlServer.Management.PSProvider.dll

    Implémente le fournisseur PowerShell pour SQL ServerSQL Server et les applets de commande associées, comme Encode-SqlName et Decode-SqlName.Implements the SQL ServerSQL Server PowerShell provider and associated cmdlets such as Encode-SqlName and Decode-SqlName.

  • Microsoft.SqlServer.Management.PSSnapin.dllMicrosoft.SqlServer.Management.PSSnapin.dll

    Implémente les applets de commande Invoke-Sqlcmd et Invoke-PolicyEvaluation .Implements the Invoke-Sqlcmd and Invoke-PolicyEvaluation cmdlets.

    Vous pouvez recourir à l’utilitaire sqlps pour effectuer les opérations suivantes :You can use the sqlps utility to do the following:

  • exécuter des commandes PowerShell de façon interactive ;Interactively run PowerShell commands.

  • exécuter des fichiers script PowerShell ;Run PowerShell script files.

  • exécuter des applets de commande SQL ServerSQL Server ;Run SQL ServerSQL Server cmdlets.

  • utiliser les chemins d'accès du fournisseur SQL ServerSQL Server pour naviguer dans la hiérarchie des objets SQL ServerSQL Server ;Use the SQL ServerSQL Server provider paths to navigate through the hierarchy of SQL ServerSQL Server objects.

    Par défaut, l’utilitaire sqlps s’exécute avec le niveau de stratégie d’exécution de scripts défini sur Restreint.By default, the sqlps utility runs with the scripting execution policy set to Restricted. Cela empêche l'exécution de scripts PowerShell.This prevents running any PowerShell scripts. Vous pouvez utiliser l’applet de commande Set-ExecutionPolicy pour activer l’exécution de scripts signés ou de tout type de script.You can use the Set-ExecutionPolicy cmdlet to enable running signed scripts, or any 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.Only run scripts from trusted sources, and secure all input and output files by using the appropriate NTFS permissions. Pour plus d'informations sur l'activation de scripts PowerShell, consultez Exécution de scripts Windows PowerShell.For more information about enabling PowerShell scripts, see Running Windows PowerShell Scripts.

    La version de l’utilitaire sqlps dans SQL Server 2008SQL Server 2008 et SQL Server 2008 R2SQL Server 2008 R2 a été implémentée en tant que mini-shell Windows PowerShell 1.0.The version of the sqlps utility in SQL Server 2008SQL Server 2008 and SQL Server 2008 R2SQL Server 2008 R2 was implemented as a Windows PowerShell 1.0 mini-shell. 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.Mini-shells have certain restrictions, such as not allowing users to load snap-ins other than those loaded by the mini-shell. Ces restrictions ne s'appliquent pas à la version SQL Server 2012 (11.x)SQL Server 2012 (11.x) et aux versions ultérieures de l'utilitaire, qui ont été modifiées pour utiliser le module sqlps .These restrictions do not apply to the SQL Server 2012 (11.x)SQL Server 2012 (11.x) and higher versions of the utility, which have been changed to use the sqlps module.

ExemplesExamples

A. Exécuter l’utilitaire sqlps en mode interactif par défaut, sans bannière de copyrightA. Run the sqlps utility in default, interactive mode without the copyright banner

sqlps -NoLogo  

B. Exécuter un script SQL Server PowerShell à partir de l’invite de commandesB. Run a SQL Server PowerShell script from the command prompt

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

C. Exécuter un script SQL Server PowerShell à partir de l’invite de commandes et poursuivre l’exécution une fois le script terminéC. Run a SQL Server PowerShell script from the command prompt, and keep running after the script completes

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

Voir aussiSee Also

Activer ou désactiver un protocole réseau de serveur Enable or Disable a Server Network Protocol
SQL Server PowerShellSQL Server PowerShell