narzędzie sqlps

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Database w Microsoft Fabric

Narzędzie sqlps uruchamia sesję programu Windows PowerShell z dostawcą programu SQL Server PowerShell i poleceniami cmdlet załadowanymi i zarejestrowanymi. Możesz wprowadzić polecenia programu PowerShell lub skrypty, które używają składników programu PowerShell programu SQL Server do pracy z wystąpieniami programu SQL Server i ich obiektów.

Składnia

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

Argumenty (w programowaniu)

-NoLogo

Określa, że narzędzie sqlps ukrywa transparent praw autorskich podczas jego uruchamiania.

-NoExit

Określa, że narzędzie sqlps nadal działa po zakończeniu poleceń uruchamiania.

-NoProfile

Określa, że narzędzie sqlps nie ładuje profilu użytkownika. Profile użytkowników rejestrują często używane aliasy, funkcje i zmienne do użycia w sesjach programu PowerShell.

-OutPutFormat { Text | XML }

Określa, że dane wyjściowe narzędzia sqlps są formatowane jako ciągi tekstowe (Tekst) lub w serializowanym formacie CLIXML (XML).

-InPutFormat { Text | XML }

Określa, że dane wejściowe do narzędzia sqlps są formatowane jako ciągi tekstowe (Text) lub w serializowanym formacie CLIXML (XML).

-Polecenie

Określa polecenie dla narzędzia sqlps do uruchomienia. Narzędzie sqlps uruchamia polecenie, a następnie kończy działanie, chyba że -NoExit zostanie również określony. Nie należy określać żadnych innych przełączników po -Command. Są one odczytywane jako parametry polecenia.

-

-Command- określa, że narzędzie sqlps odczytuje dane wejściowe ze standardowych danych wejściowych.

script_block [ -argsargument_array ]

Określa blok poleceń programu PowerShell do uruchomienia, blok musi być ujęty w nawiasy klamrowe: {}. Script_block można określić tylko wtedy, gdy narzędzie sqlps jest wywoływane z programu PowerShell lub innej sesji narzędzia sqlps . Argument_array to tablica zmiennych programu PowerShell zawierających argumenty poleceń programu PowerShell w script_block.

string [ command_parameters ]

Określa ciąg zawierający polecenia programu PowerShell do uruchomienia. Użyj formatu "{<command>}". Znaki cudzysłowu wskazują ciąg, a operator wywołania (&) powoduje, że narzędzie sqlps uruchamia polecenie (<command>).

[ -? | -Pomoc ]

Przedstawia podsumowanie składni opcji narzędzia sqlps .

Uwagi

Narzędzie sqlps uruchamia środowisko programu PowerShell (PowerShell.exe) i ładuje moduł programu SQL Server PowerShell. Moduł o nazwie sqlps, ładuje i rejestruje te przystawki programu SQL Server PowerShell:

• Microsoft.SqlServer.Management.PSProvider.dll

  Implementuje dostawcę programu SQL Server PowerShell i skojarzone polecenia cmdlet, takie jak Encode-SqlName i Decode-SqlName.

• Microsoft.SqlServer.Management.PSSnapin.dll

  Implementuje polecenia cmdlet Invoke-Sqlcmd i Invoke-PolicyEvaluation .

Aby wykonać następujące zadania, możesz użyć narzędzia sqlps :

• Interakcyjne uruchamianie poleceń programu PowerShell.

• Uruchom pliki skryptów programu PowerShell.

• Uruchom polecenia cmdlet programu SQL Server.

• Użyj ścieżek dostawcy programu SQL Server, aby przejść przez hierarchię obiektów programu SQL Server.

Domyślnie narzędzie sqlps jest uruchamiane z zasadami wykonywania skryptów ustawionymi na Wartość Ograniczona. Zapobiega to uruchamianiu wszystkich skryptów programu PowerShell. Możesz użyć polecenia cmdlet Set-ExecutionPolicy , aby włączyć uruchamianie podpisanych skryptów lub dowolnych skryptów. Uruchamiaj tylko skrypty z zaufanych źródeł i zabezpieczaj wszystkie pliki wejściowe i wyjściowe przy użyciu odpowiednich uprawnień NTFS. Aby uzyskać więcej informacji na temat włączania skryptów programu PowerShell, zobacz Uruchamianie skryptów programu Windows PowerShell.

Wersja narzędzia sqlps w programie SQL Server 2008 (10.0.x) i SQL Server 2008 R2 (10.50.x) została zaimplementowana jako mini-powłoka programu Windows PowerShell 1.0. Mini-powłoki mają pewne ograniczenia, takie jak brak zezwolenia użytkownikom na ładowanie przystawek innych niż te przystawki ładowane przez mini-powłokę. Te ograniczenia nie mają zastosowania do programu SQL Server 2012 (11.x) i nowszych wersji narzędzia, które zostały zmienione w celu korzystania z modułu sqlps .

Przykłady

Odp. Uruchamianie narzędzia sqlps w domyślnym trybie interaktywnym bez baneru praw autorskich

sqlps -NoLogo

B. Uruchamianie skryptu programu PowerShell programu SQL Server z poziomu wiersza polecenia

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

C. Uruchom skrypt programu PowerShell programu SQL Server z wiersza polecenia i kontynuuj działanie po zakończeniu działania skryptu

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

Treści powiązane

• Włączanie lub wyłączanie protokołu sieciowego serwera
• PowerShell dla SQL Server