sqlps (Hilfsprogramm)

Das sqlps Hilfsprogramm startet eine Windows PowerShell 2.0-Sitzung mit geladenen und registrierten SQL Server PowerShell-Anbieter und -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.

Syntax

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

Argumente

-NoLogo
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 wird.

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

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

-
-Befehl: 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 können nur angegeben werden, wenn das sqlps Hilfsprogramm entweder über PowerShell oder eine andere 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 ausgibt.

[ -? | -Help ]
Zeigt eine Syntaxzusammenfassung der Optionen des Hilfsprogramms sqlps an.

Hinweise

Das sqlps Hilfsprogramm startet die PowerShell-Umgebung (PowerShell.exe) und lädt das SQL Server PowerShell-Modul. Das Modul, auch genanntsqlps, lädt und registriert die folgenden 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 .

Das Hilfsprogramm sqlps kann für die folgenden Tasks verwendet werden:

• 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öhere Versionen des Hilfsprogramms, die geändert wurden, um das sqlps Modul zu verwenden.

Beispiele

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

Weitere Informationen

Aktivieren oder Deaktivieren eines Servernetzwerkprotokolls
SQL Server-PowerShell