Freigeben über

SQLPS-Hilfsprogramm

Gilt für:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-Datenbank in Microsoft Fabric

Das Hilfsprogramm sqlps startet eine Windows PowerShell-Sitzung mit geladenem und registriertem SQL Server PowerShell-Anbieter sowie geladenen und registrierten Cmdlets. Sie können PowerShell-Befehle oder -Skripts eingeben, die die SQL Server PowerShell-Komponenten verwenden, sodass Instanzen von SQL Server und ihre Objekte verwendet werden können.

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 die Copyrightinformationen ausgeblendet werden.

-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-Hilfsprogramm führt den Befehl aus und beendet den Befehl, es sei denn -NoExit , es wird ebenfalls angegeben. Geben Sie nach keinem anderen Schalter an -Command. 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