在 SQL Server PowerShell 提供者中指定實例

為 SQL Server PowerShell 提供者指定的路徑必須識別 Database Engine 的實例及其執行的電腦。 指定計算機和實例的語法必須符合 SQL Server 識別碼和 Windows PowerShell 路徑的規則。

注意

有兩個 SQL Server PowerShell 模組; SqlServer 和 SQLPS。

SqlServer 模組是要使用的目前 PowerShell 模組。

SQLPS 模組隨附於 SQL Server 安裝中(為了回溯相容性),但不再更新。

SqlServer 模組包含 SQLPS 中更新的 Cmdlet 版本,並包含新的 Cmdlet 以支援最新的 SQL 功能。

從 PowerShell 資源庫安裝 SqlServer 模組。

如需詳細資訊,請流覽 SQL Server PowerShell。

開始之前

SQL Server 提供者路徑中 SQLSERVER:\SQL 後面的第一個節點是執行 Database Engine 實例的計算機名稱;例如:

SQLSERVER:\SQL\MyComputer

如果您在與 Database Engine 實例相同的電腦上執行 Windows PowerShell,您可以使用 localhost 或 (local) 而不是計算機的名稱。 任何計算機上都可以執行使用localhost或 (local) 的腳本,而不必變更以反映不同的電腦名稱。

您可以在同一部計算機上執行 Database Engine 可執行程式的多個實例。 SQL Server 提供者路徑中計算機名稱後面的節點會識別 實例;例如:

SQLSERVER:\SQL\MyComputer\MyInstance

每部電腦都可以有一個 Database Engine 的預設實例。 當您安裝預設實例時,您不會指定其名稱。 如果您只在連接字串中指定計算機名稱,則會連線到該電腦上的預設實例。 計算機上的所有其他實例都必須是具名實例。 您可以在安裝期間指定實例名稱,而且連接字串必須同時指定計算機名稱和實例名稱。

限制

您無法使用句號 (.) 在 PowerShell 文稿中指定本機電腦。 不支援句點,因為句點會解譯為 PowerShell 的命令。

Windows PowerShell 通常會將 (local) 中的括號字元視為命令。 您必須將它們編碼或逸出以用於路徑,或以雙引號括住路徑。 如需詳細資訊,請參閱編碼和譯碼 SQL Server 識別碼。

SQL Server 提供者會要求您一律指定實例名稱。 針對預設實例,您必須指定 DEFAULT 的實體名稱。

範例:計算機和實例名稱

此範例會使用 localhost 和 DEFAULT 來指定本機電腦上的預設實例:

Set-Location SQLSERVER:\SQL\localhost\DEFAULT

Windows PowerShell 通常會將 (local) 中的括號字元視為命令。 您必須:

  • 以引號括住路徑字串:

    Set-Location "SQLSERVER:\SQL\(local)\DEFAULT"
    
  • 使用返回檢查字元逸出括號 ('):

    Set-Location SQLSERVER:\SQL\`(local`)\DEFAULT
    
  • 使用其十六進位表示法來編碼括弧:

    Set-Location SQLSERVER:\SQL\%28local%29\DEFAULT