• 發行項

sqlps 公用程式

sqlps 公用程式會啟動 PowerShell 工作階段並且載入和註冊 SQL Server PowerShell 提供者與指令程式。您可以輸入 PowerShell 命令或指令碼，以便使用 SQL Server PowerShell 元件來處理 SQL Server 執行個體及其物件。

語法

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

引數

  • -NoLogo
    指定 sqlps 在啟動時隱藏著作權橫幅。

  • -NoExit
    指定 sqlps 在啟動命令完成之後繼續執行。

  • -NoProfile
    指定 sqlps 不要載入使用者設定檔。使用者設定檔會記錄常用的別名、函數和變數，以便在 PowerShell 工作階段之間使用。

  • -OutPutFormat { Text | XML }
    指定 sqlps 輸出要格式化成為文字字串 (Text) 或序列化 CLIXML 格式 (XML)。

  • -InPutFormat { Text | XML }
    指定 sqlps 的輸入要格式化成為文字字串 (Text) 或序列化 CLIXML 格式 (XML)。

  • -Command
    指定要讓 sqlps 執行的命令。除非同時指定了 -NoExit，否則 sqlps 公用程式會執行此命令，然後結束。請勿在 -Command 之後指定任何其他參數，因為這些參數將會讀取成命令參數。

  • -
    -Command- 會指定 sqlps 從標準輸入中讀取輸入。

  • script_block [ -argsargument_array ]
    指定要執行的 PowerShell 命令區塊，而且此區塊必須以大括號 {} 括住。只有當 sqlps 是從 PowerShell 或 sqlps 中呼叫時，才能指定 Script_block。argument_array 是 PowerShell 變數的陣列，其中包含 script_block 中 PowerShell 命令的引數。

  • string [ command_parameters ]
    指定包含要執行之 PowerShell 命令的字串。請使用格式 "&{command}"。引號表示字串，而叫用運算子 (&) 會讓 sqlps 執行此命令。

  • [ -? | -Help ]
    顯示 sqlps 選項的語法摘要。

備註

sqlps 公用程式會啟動 PowerShell 環境 (PowerShell.exe) 並且載入和註冊 SQL Server PowerShell 嵌入式管理單元。這些 SQL Server PowerShell 嵌入式管理單元如下所示：

  • Microsoft.SqlServer.Management.PSProvider.dll

    實作 SQL Server PowerShell 提供者和相關聯的指令程式，例如 Encode-SqlName 和 Decode-SqlName。

  • Microsoft.SqlServer.Management.PSSnapin.dll

    實作 Invoke-Sqlcmd 指令程式。

您可以使用 sqlps 來進行下列動作：

  • 以互動方式執行 PowerShell 命令。

  • 執行 PowerShell 指令碼檔案。

  • 執行 SQL Server 指令程式。

  • 使用 SQL Server 提供者路徑來逐一導覽 SQL Server 物件的階層。

根據預設，sqlps 執行時會將指令碼執行原則設定為 Restricted。這樣可防止任何 PowerShell 指令碼執行。您可以使用 Set-ExecutionPolicy 指令程式來允許執行已簽署的指令碼或任何指令碼。建議您只執行來自信任來源的指令碼，並且利用適當的 NTFS 權限來保護所有輸入和輸出檔案。如需有關啟用 PowerShell 指令碼的詳細資訊，請參閱＜執行 Windows PowerShell 指令碼＞(英文)。

範例

A. 在不顯示著作權橫幅的預設互動模式中執行 sqlps

sqlps -NoLogo

B. 從命令提示字元執行 SQL Server PowerShell 指令碼

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

C. 從命令提示字元執行 SQL Server PowerShell 指令碼，並且在指令碼完成之後保持執行狀態

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