Udostępnij za pośrednictwem

  • Artykuł

Narzędzie sqlps

The sqlps utility starts a PowerShell sesja with the SQL Server PowerShell dostawca and cmdlets loaded and registered. Można wprowadzić PowerShell poleceń lub skryptów, w których SQL Server Składniki PowerShell do pracy z wystąpień SQL Server i ich obiektów.

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

Argumenty

  • -NoLogo
    Określa, że sqlps ukryć transparent o prawach autorskich, podczas jego uruchamiania.

  • -NoExit
    Określa, że sqlps nadal uruchomiony po zakończeniu polecenia wywoływane przy uruchamianiu.

  • -NoProfile
    Określa, że sqlps ładowania profilu użytkownika.Profile użytkowników aliasy rekordu powszechnie używane, funkcje i zmienne, których można używać między sesjami PowerShell.

  • -OutPutFormat { Tekst | XML }
    Określa, że sqlps wyjścia być sformatowana jako albo ciągów tekstowych (Tekst) lub w serializowane CLIXML formatowanie (XML).

  • -InPutFormat { Tekst | XML }
    Określa, że dane wejściowe do sqlps są formatowane jako (ciągi) albo tekstuTekst) lub w serializowane CLIXML formatowanie (XML).

  • -Polecenia
    Określa polecenie dla sqlps do uruchomienia.The sqlps utility runs the command and then exits, unless -NoExit is also specified.Nie zostaną określone inne przełączniki po -Polecenia, które zostaną odczytane jako parametry polecenia.

  • -
    -Command- specifies that sqlps read the input from the standard input.

  • script_block [ -argsargument_array ]
    Określa blok PowerShell polecenia służące do uruchamiania, blok muszą być ujęte w nawiasy klamrowe: {}.Script_block można określić tylko po sqlps jest wywoływana z obu PowerShell or sqlps.The argument_array is an array of PowerShell variables containing the arguments for the PowerShell commands in the script_block.

  • string [ command_parameters ]
    Określa ciąg znaków, który zawiera polecenia PowerShell ma być uruchomiony.Użyj formatu "&{command}". Znaki cudzysłowu wskazuje ciąg i invoke operator (&) powoduje, że sqlps, aby uruchomić to polecenie.

  • [ -? | -Pomoc
    Wyświetla podsumowanie składni sqlps opcje.

Remarks

The sqlps utility starts the PowerShell environment (PowerShell.exe) with the SQL Server PowerShell snap-ins loaded and registered.The SQL Server PowerShell snap-ins are as follows:

  • Microsoft.SqlServer.Management.PSProvider.dll

    Implementuje SQL Server Dostawca PowerShell i cmdlets skojarzonych, takich jak Koduj SqlName and SqlName dekodowania.

  • Microsoft.SqlServer.Management.PSSnapin.dll

    Implementuje Wywołaj Sqlcmd apletu polecenia.

Można użyć sqlps wykonać następujące czynności:

  • Interaktywne uruchamianie polecenia PowerShell.

  • Uruchom PowerShell pliki skryptów.

  • Uruchamianie SQL Server cmdlets.

  • Użycie SQL Server Dostawca ścieżki do nawigowania w hierarchii SQL Server obiekty.

Domyślnie sqlps zasady wykonywanie skryptów, należy ustawić opcję działaOgraniczone.W ten sposób uruchamiania skryptów wszelkie PowerShell.Można użyć Zestaw ExecutionPolicy apletu polecenia umożliwiające uruchamianie skryptów podpisane lub wszystkie skrypty.Uruchamianie skryptów z zaufanych źródeł i bezpieczne wszystkich danych wejściowych i tylko pliki wyjściowe przy użyciu odpowiednie uprawnienia systemu plików NTFS.Aby uzyskać więcej informacji na temat włączania PowerShell skryptów zobacz Uruchamianie skryptów PowerShell systemu Windows.

Przykłady

A.Run sqlps in default, interactive mode without the copyright banner

sqlps -NoLogo

B.Run a SQL Server PowerShell script from the command prompt

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

C.Run a SQL Server PowerShell script from the command prompt, and keep running after the script completes

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