Megosztás:

sqlps segédprogram

Vonatkozik a következőkre:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalitikai Platform System (PDW)SQL adatbázis a Microsoft Fabric-ben

Az sqlps segédprogram elindít egy Windows PowerShell-munkamenetet az SQL Server PowerShell-szolgáltatóval és a betöltött és regisztrált parancsmagokkal. Olyan PowerShell-parancsokat vagy szkripteket adhat meg, amelyek az SQL Server PowerShell-összetevőit használják az SQL Server példányainak és objektumainak használatához.

Fontos

Ez a funkció az SQL Server egy későbbi verziójában lesz eltávolítva. Ne használja ezt a funkciót az új fejlesztési munkában, és tervezze meg a funkciót jelenleg használó alkalmazások módosítását. Használja inkább az sqlps PowerShell-modult. Az sqlps modulról további információt az SQLPS-modul importálása című témakörben talál.

Szemantika

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

Érvek

Megadja, hogy az sqlps segédprogram elrejtse a szerzői jogi szalagcímet az indításkor.

-NoExit

Megadja, hogy az sqlps segédprogram az indítási parancsok befejeződése után is fut-e.

-NoProfile

Megadja, hogy az sqlps segédprogram ne töltsön be felhasználói profilt. A felhasználói profilok a PowerShell-munkamenetekben gyakran használt aliasokat, függvényeket és változókat rögzítik.

-OutPutFormat { Text | XML }

Megadja, hogy az sqlps segédprogram kimenete szöveges sztringként (Text) vagy szerializált CLIXML formátumban (XML) legyen formázva.

-InPutFormat { Text | XML }

Megadja, hogy az sqlps segédprogram bemenete szöveges sztringként (Text) vagy szerializált CLIXML formátumban (XML) legyen formázva.

-Parancs

Megadja az sqlps segédprogram futtatásához szükséges parancsot. Az sqlps segédprogram futtatja a parancsot, majd kilép, hacsak nincs -NoExit megadva. Ne adjon meg más kapcsolókat a (z) után -Command. Parancsparaméterekként vannak beolvasva.

-

-Command- azt adja meg, hogy az sqlps segédprogram beolvassa a bemenetet a standard bemenetből.

script_block [ -argsargument_array ]

A futtatandó PowerShell-parancsok blokkját adja meg, a blokkot kapcsos zárójelek közé kell tenni: {}. Script_block csak akkor adható meg, ha az sqlps segédprogram meghívása a PowerShellből vagy egy másik sqlps segédprogram-munkamenetből történik. A argument_array PowerShell-változók tömbje, amelyek a script_block PowerShell-parancsainak argumentumait tartalmazzák.

sztring [ parancs_paraméterek ]

Megadja a futtatni kívánt PowerShell-parancsokat tartalmazó sztringet. Használja a következő formátumot: "{<command>}". Az idézőjelek egy sztringet jelölnek, a meghívási operátor (&) pedig az sqlps segédprogram futtatását<command> ().

[ -? | -Súgó ]

Az sqlps segédprogram beállításainak szintaxis-összegzését jeleníti meg.

Megjegyzések

Az sqlps segédprogram elindítja a PowerShell-környezetet (PowerShell.exe), és betölti az SQL Server PowerShell-modult. Az sqlps nevű modul betölti és regisztrálja ezeket az SQL Server PowerShell beépülő modulokat:

  • Microsoft.SqlServer.Management.PSProvider.dll

    Implementálja az SQL Server PowerShell-szolgáltatót és a kapcsolódó parancsmagokat, például az Encode-SqlName és a Decode-SqlName parancsmagokat.

  • Microsoft.SqlServer.Management.PSSnapin.dll

    Implementálja az Invoke-Sqlcmd és az Invoke-PolicyEvaluation parancsmagokat.

Az sqlps segédprogrammal a következő feladatokat végezheti el:

  • PowerShell-parancsok interaktív futtatása.

  • Futtassa a PowerShell-szkriptfájlokat.

  • SQL Server-parancsmagok futtatása.

  • Az SQL Server-szolgáltató elérési útjai segítségével navigálhat az SQL Server-objektumok hierarchiája között.

Az sqlps segédprogram alapértelmezés szerint korlátozott parancsprogram-végrehajtási szabályzattal fut. Ez megakadályozza a PowerShell-szkriptek futtatását. A Set-ExecutionPolicy parancsmaggal engedélyezheti az aláírt szkriptek vagy bármely szkript futtatását. Csak megbízható forrásokból futtathat szkripteket, és a megfelelő NTFS-engedélyekkel biztonságossá teheti az összes bemeneti és kimeneti fájlt. A PowerShell-szkriptek engedélyezésével kapcsolatos további információkért lásd: Windows PowerShell-szkriptek futtatása.

Az SQL Server 2008 (10.0.x) és az SQL Server 2008 R2 (10.50.x) sqlps segédprogramjának verziója Windows PowerShell 1.0 minihéjként lett implementálva. A minihéjak bizonyos korlátozásokkal rendelkeznek, például nem teszik lehetővé a felhasználók számára a minihéj által betöltött beépülő moduloktól eltérő beépülő modulok betöltését. Ezek a korlátozások nem vonatkoznak a segédprogram SQL Server 2012 (11.x) és újabb verzióira, amelyek módosultak az sqlps modul használatára.

Példák

sqlps -NoLogo

B. SQL Server PowerShell-szkript futtatása a parancssorból

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

C. Futtasson egy SQL Server PowerShell-szkriptet a parancssorból, és futtassa tovább a szkript befejeződése után

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

Kapcsolódó tartalom

  • Last updated on