SQLPS-Hilfsprogramm

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsSQL-Datenbank in Microsoft Fabric

Das Hilfsprogramm sqlps startet eine Windows PowerShell-Sitzung, bei der der SQL Server PowerShell-Anbieter und die Cmdlets geladen und registriert sind. Sie können PowerShell-Befehle oder -Skripte eingeben, die die SQL Server PowerShell-Komponenten verwenden, um mit SQL Server-Instanzen und deren Objekten zu arbeiten.

Wichtig

Diese Funktion wird in einer zukünftigen Version von SQL Serverentfernt. Nutzen Sie diese Funktionen bei Neuentwicklungen nicht mehr, und planen Sie die Änderung von Anwendungen, die diese Funktion zurzeit verwenden. Verwenden Sie stattdessen das PowerShell-Modul sqlps. Weitere Informationen zum sqlps -Modul finden Sie unter Importieren des SQLPS-Moduls.

Syntax

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

Argumente

Gibt an, dass beim Start des Hilfsprogramms sqlps der Urheberrechtshinweis ausgeblendet wird.

-NoExit

Gibt an, dass das Hilfsprogramm sqlps weiter ausgeführt wird, nachdem die Startbefehle abgeschlossen wurden.

-NoProfile

Gibt an, dass das Hilfsprogramm sqlps kein Benutzerprofil lädt. In Benutzerprofilen werden häufig verwendete Aliase, Funktionen und Variablen zur Verwendung in mehreren PowerShell-Sitzungen aufgezeichnet.

-OutPutFormat { Text | XML }

Gibt an, dass die SQLPS-Hilfsprogrammausgabe entweder als Textzeichenfolgen (Text) oder in einem serialisierten CLIXML-Format (XML) formatiert ist.

-InPutFormat { Text | XML }

Gibt an, dass die Eingabe in das Hilfsprogramm sqlps entweder als Textzeichenfolgen (Text) oder in einem serialisierten CLIXML-Format (XML) formatiert ist.

-Befehl

Gibt den Befehl an, der vom Hilfsprogramm sqlps ausgeführt werden soll. Das sqlps-Dienstprogramm führt den Befehl aus und wird dann beendet, sofern nicht auch -NoExit angegeben ist. Geben Sie nach -Command keine weiteren Schalter an. Sie werden als Befehlsparameter gelesen.

-

-Command- Gibt an, dass das Sqlps-Hilfsprogramm die Eingabe aus der Standardeingabe liest.

script_block [ -argsargument_array ]

Gibt einen Block von PowerShell-Befehlen an, die ausgeführt werden sollen. Der Block muss in geschweifte Klammern ({}) eingeschlossen werden. Script_block kann nur angegeben werden, wenn das Hilfsprogramm sqlps über PowerShell oder über eine andere Sitzung des Hilfsprogramms sqlps aufgerufen wird. Argument_array ist ein Array von PowerShell-Variablen, das die Argumente für die PowerShell-Befehle in script_blockenthält.

String [ command_parameters ]

Gibt eine Zeichenfolge an, die die auszuführenden PowerShell-Befehle enthält. Verwenden Sie das Format "{<command>}". Die Anführungszeichen geben eine Zeichenfolge an, und der Aufrufoperator (&) bewirkt, dass das Sqlps-Hilfsprogramm den Befehl (<command>) ausführt.

[ -? | -Hilfe ]

Zeigt eine Syntaxzusammenfassung der Optionen des Hilfsprogramms sqlps an.

Bemerkungen

Das Hilfsprogramm sqlps startet die PowerShell-Umgebung („PowerShell.exe“) und lädt das SQL Server PowerShell-Modul. Das Modul, das auch sqlps heißt, lädt und registriert diese SQL Server PowerShell-Snap-Ins:

  • Microsoft.SqlServer.Management.PSProvider.dll

    Implementiert den SQL Server PowerShell-Anbieter und zugeordnete Cmdlets, z. B. Encode-SqlName und Decode-SqlName.

  • Microsoft.SqlServer.Management.PSSnapin.dll

    Implementiert die Cmdlets Invoke-Sqlcmd und Invoke-PolicyEvaluation .

Sie können das Sqlps-Hilfsprogramm verwenden, um die folgenden Aufgaben auszuführen:

  • Interaktives Ausführen von PowerShell-Befehlen

  • Ausführen von PowerShell-Skriptdateien

  • Ausführen von SQL Server-Cmdlets

  • Verwenden Sie die SQL Server-Anbieterpfade, um in der Hierarchie von SQL Server-Objekten zu navigieren.

Standardmäßig ist für die Ausführung des Hilfsprogramms sqlps die Skriptausführungsrichtlinie auf Restrictedfestgelegt. Dadurch wird die Ausführung von PowerShell-Skripts verhindert. Mit dem Cmdlet Set-ExecutionPolicy können Sie die Ausführung signierter Skripts oder beliebiger anderer Skripts ermöglichen. Führen Sie nur Skripts aus vertrauenswürdigen Quellen aus, und sichern Sie alle Eingabe- und Ausgabedateien, indem Sie die geeigneten NTFS-Berechtigungen verwenden. Weitere Informationen zum Aktivieren von PowerShell-Skripts finden Sie unter Ausführen der Windows PowerShell-Skripts.

Die Version des sqlps-Hilfsprogramms in SQL Server 2008 (10.0.x) und SQL Server 2008 R2 (10.50.x) wurde als Windows PowerShell 1.0-Mini-Shell implementiert. Minishells haben bestimmte Einschränkungen, z. B. dass Benutzer keine Anderen Snap-Ins als die von der Minishell geladenen Snap-Ins laden können. Diese Einschränkungen gelten nicht für sql Server 2012 (11.x) und höhere Versionen des Hilfsprogramms, die geändert wurden, um das SQLPS-Modul zu verwenden.

Beispiele

sqlps -NoLogo

B. Ausführen eines SQL Server PowerShell-Skripts von der Eingabeaufforderung

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

C. Ausführen eines SQL Server PowerShell-Skripts von der Eingabeaufforderung und weitere Ausführung nach Abschluss des Skripts

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

Verwandte Inhalte

  • Last updated on