Sdílet prostřednictvím

Nástroj SQLps

platí pro:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)databáze SQL v Microsoft Fabric

Nástroj SQLps spustí relaci ve Windows PowerShell s načteným a zaregistrovaným poskytovatelem SQL Server PowerShell a rutinami. Můžete zadat příkazy powershellu nebo skripty, které používají komponenty POWERShellu SQL Serveru k práci s instancemi SQL Serveru a jejich objekty.

Důležité

Tato funkce bude odebrána v budoucí verzi SQL Serveru. Nepoužívejte tuto funkci v nové vývojové práci a naplánujte úpravu aplikací, které tuto funkci aktuálně používají. Místo toho použijte modul sqlps PowerShellu. Další informace o modulu sqlps naleznete v tématu Import modulu SQLPS.

Syntaxe

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

Argumenty

Určuje, že nástroj SQLps skryje banner s autorskými právy při spuštění.

-NoExit

Určuje, že nástroj SQLps bude pokračovat ve spuštění po dokončení spouštěcích příkazů.

-NoProfile

Určuje, že nástroj SQLps nenačte profil uživatele. Profily uživatelů zaznamenávají běžně používané aliasy, funkce a proměnné pro použití napříč relacemi PowerShellu.

-OutPutFormat { Text | XML }

Určuje, že výstup nástroje SQLps je formátován jako textové řetězce (Text) nebo v serializovaném formátu CLIXML (XML).

-InPutFormat { Text | XML }

Určuje, že vstup do nástroje SQLps je formátován jako textové řetězce (Text) nebo v serializovaném formátu CLIXML (XML).

-Příkaz

Určuje příkaz pro spuštění nástroje SQLps . Nástroj SQLps spustí příkaz a potom ukončí, pokud -NoExit není zadán také. Za parametrem -Commandnezadávejte žádné další přepínače. Čtou se jako parametry příkazu.

-

-Command- určuje, že nástroj SQLps přečte vstup ze standardního vstupu.

script_block [ -argsargument_array ]

Určuje blok příkazů PowerShellu, které se mají spustit, musí být blok uzavřený ve složených závorkách: {}. Script_block lze zadat pouze v případech, kdy je nástroj SQLps volán z PowerShellu nebo jiné relace nástroje SQLps . Argument_array je pole proměnných PowerShellu obsahující argumenty pro příkazy PowerShellu v script_block.

string [ command_parameters ]

Určuje řetězec, který obsahuje příkazy PowerShellu, které se mají spustit. Použijte formát "{<command>}". Uvozovky označují řetězec a operátor vyvolání (&) způsobí, že nástroj sqlps spustí příkaz (<command>).

[ -? | -Nápověda ]

Zobrazuje souhrn syntaxe možností nástroje sqlps .

Poznámky

Nástroj SQLps spustí prostředí PowerShell (PowerShell.exe) a načte modul SQL Server PowerShell. Modul, který se také jmenuje sqlps, načte a zaregistruje tyto moduly snap-in PROSTŘEDÍ SQL Server PowerShell:

  • Microsoft.SqlServer.Management.PSProvider.dll

    Implementuje zprostředkovatele PowerShellu SQL Serveru a přidružené rutiny, jako je Encode-SqlName a Decode-SqlName.

  • Microsoft.SqlServer.Management.PSSnapin.dll

    Implementuje rutiny Invoke-Sqlcmd a Invoke-PolicyEvaluation .

Pomocí nástroje sqlps můžete provádět následující úlohy:

  • Interaktivní spouštění příkazů PowerShellu

  • Spusťte soubory skriptů PowerShellu.

  • Spusťte rutiny SQL Serveru.

  • Pomocí cest zprostředkovatele SQL Serveru můžete procházet hierarchii objektů SQL Serveru.

Ve výchozím nastavení běží nástroj SQLps se skriptovací zásadou spouštění nastavenou na Restricted. Tím se zabrání spuštění všech skriptů PowerShellu. Pomocí rutiny Set-ExecutionPolicy můžete povolit spouštění podepsaných skriptů nebo skriptů. Spouštět skripty pouze z důvěryhodných zdrojů a zabezpečit všechny vstupní a výstupní soubory pomocí příslušných oprávnění NTFS. Další informace o povolení skriptů PowerShellu najdete v tématu Spouštění skriptů prostředí Windows PowerShell.

Verze nástroje sqlps v SQL Serveru 2008 (10.0.x) a SQL Serveru 2008 R2 (10.50.x) byla implementována jako mini-shell Windows PowerShell 1.0. Mini shelly mají určitá omezení, například neumožňují uživatelům načítat jiné moduly snap-in než moduly snap-in načtené mini-shellem. Tato omezení neplatí pro SQL Server 2012 (11.x) a novější verze nástroje, které byly změněny tak, aby používaly modul sqlps .

Příklady

sqlps -NoLogo

B. Spuštění skriptu PowerShellu pro SQL Server z příkazového řádku

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

C. Z příkazového řádku spusťte skript PowerShellu pro SQL Server a po dokončení skriptu pokračujte v provozu.

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

Související obsah

  • Last updated on