sqlps (Hilfsprogramm)

Das sqlps Hilfsprogramm startet eine Windows PowerShell 2.0-Sitzung, in der der SQL Server PowerShell-Anbieter und -Cmdlets geladen und registriert werden. 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.

Syntax

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

Argumente

-KeinLogo
Gibt an, dass das Hilfsprogramm das sqlps Copyright-Banner ausblendet, wenn es gestartet wird.

-NoExit
Gibt an, dass das sqlps Dienstprogramm weiterläuft, nachdem die Startbefehle abgeschlossen wurden.

-NoProfile
Gibt an, dass das sqlps Hilfsprogramm 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 wird.

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

-Befehl
Gibt den Befehl an, mit dem das sqlps Hilfsprogramm ausgeführt werden soll. Das sqlps Hilfsprogramm führt den Befehl aus und beendet den Befehl, es sei denn, -NoExit ist ebenfalls angegeben. Geben Sie nach -Commandkeine anderen Schalter an, denn diese 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 sqlps Hilfsprogramm von PowerShell oder einer anderen sqlps Hilfsprogrammsitzung 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 ausführt.

[ -? | -Hilfe ]
Zeigt die Syntaxzusammenfassung der sqlps Hilfsoptionen an.

Bemerkungen

Das sqlps Hilfsprogramm startet die PowerShell-Umgebung (PowerShell.exe) und lädt das SQL Server PowerShell-Modul. Das Modul, auch benannt sqlps, 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 Folgendes 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 wird das sqlps Hilfsprogramm ausgeführt, wobei die Skriptausführungsrichtlinie auf "Eingeschränkt" festgelegt ist. 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 und SQL Server 2008 R2 wurde als Windows PowerShell 1.0-Minishell implementiert. Mini-Shells weisen bestimmte Einschränkungen auf; Benutzer können beispielsweise keine anderen als die von der Mini-Shell geladenen Snap-Ins laden. Diese Einschränkungen gelten nicht für die SQL Server 2012- und höheren Versionen des Hilfsprogramms, die geändert wurden, um das sqlps Modul zu verwenden.

Beispiele

Ein. Ausführen des Hilfsprogramms sqlps im interaktiven Standardmodus ohne Copyrightinformationen

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}"  

Siehe auch

Aktivieren oder Deaktivieren eines Servernetzwerkprotokolls
SQL Server-PowerShell