SqlServerDacpacDeployment@1 - SQL Server資料庫部署 (已淘汰) v1 工作

發行項
07/02/2024

使用此工作以使用 DACPAC 部署SQL Server資料庫。

重要

此工作已被取代，並將于 2024 年 1 月 31 日淘汰。使用 WinRM 使用 IIS Web 應用程式部署 - Viual Studio Marketplace。

使用此工作以使用 DACPAC 部署SQL Server資料庫。

此工作已被取代。

Syntax

# SQL Server database deploy (Deprecated) v1
# Deploy a SQL Server database using DACPAC.
- task: SqlServerDacpacDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    DacpacFile: # string. Required. DACPAC File. 
  # Target
    TargetMethod: 'server' # 'server' | 'connectionString' | 'publishProfile'. Required. Specify SQL Using. Default: server.
    ServerName: 'localhost' # string. Required when TargetMethod = server. Server Name. Default: localhost.
    DatabaseName: # string. Required when TargetMethod = server. Database Name. 
    #SqlUsername: # string. Optional. Use when TargetMethod = server. SQL Username. 
    #SqlPassword: # string. Optional. Use when TargetMethod = server. SQL Password. 
    #ConnectionString: # string. Required when TargetMethod = connectionString. Connection String. 
    #PublishProfile: # string. Publish Profile. 
    #AdditionalArguments: # string. Additional Arguments. 
  # Advanced
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

# SQL Server database deploy (Deprecated) v1
# Deploy SQL Server Database using DACPAC.
- task: SqlServerDacpacDeployment@1
  inputs:
    EnvironmentName: # string. Required. Machines. 
    #AdminUserName: # string. Admin Login. 
    #AdminPassword: # string. Password. 
    #Protocol: # 'Http' | 'Https'. Protocol. 
    #TestCertificate: true # boolean. Optional. Use when Protocol = Https. Test Certificate. Default: true.
  # Deployment
    DacpacFile: # string. Required. DACPAC File. 
  # Target
    TargetMethod: 'server' # 'server' | 'connectionString' | 'publishProfile'. Required. Specify SQL Using. Default: server.
    ServerName: 'localhost' # string. Required when TargetMethod = server. Server Name. Default: localhost.
    DatabaseName: # string. Required when TargetMethod = server. Database Name. 
    #SqlUsername: # string. Optional. Use when TargetMethod = server. SQL Username. 
    #SqlPassword: # string. Optional. Use when TargetMethod = server. SQL Password. 
    #ConnectionString: # string. Required when TargetMethod = connectionString. Connection String. 
    #PublishProfile: # string. Publish Profile. 
    #AdditionalArguments: # string. Additional Arguments. 
  # Advanced
    #DeployInParallel: true # boolean. Deploy in Parallel. Default: true.
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Select Machines By. Default: machineNames.
    #MachineFilter: # string. Deploy to Machines.

輸入

EnvironmentName - 機器
string. 必要。

指定機器 IP 位址或 FQDN 以及埠的逗號分隔清單。預設埠是以選取的通訊協定為基礎。例如： dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986 也可以提供其他工作的輸出變數，例如 $(variableName) 。

AdminUserName - 管理員登入
string.

指定目的電腦的系統管理員登入。

AdminPassword - 密碼
string.

指定目的電腦的系統管理員密碼。組建或發行定義中定義的變數會接受為 $(passwordVariable) 。您可以將變數類型標示為 secret 來保護它。

Protocol - 協定
string. 允許值：Http 和 Https。

指定要用於與電腦 () 之 WinRM 連線的通訊協定。預設值是 HTTPS。

TestCertificate - 測試憑證
boolean. 選擇性。使用時機 Protocol = Https 。預設值：true。

略過受信任憑證授權單位單位對電腦憑證的真實性驗證。 WinRM HTTPS 通訊協定需要參數。

DacpacFile - DACPAC 檔案
string. 必要。

指定目的機器或 UNC 路徑上 DACPAC 檔案的位置，例如 \\BudgetIT\Web\Deploy\FabrikamDB.dacpac 。 UNC 路徑應該可供電腦的系統管理員帳戶存取。也支援環境變數，例如 $env:windir 、 $env:systemroot 和 $env:windir\FabrikamFibre\Web 。

TargetMethod - 使用指定 SQL
string. 必要。允許的值： server 、 connectionString (連接字串) ， publishProfile (發行設定檔) 。預設值：server。

指定連接到目標SQL Server資料庫的選項。您可以提供SQL Server資料庫詳細資料、SQL Server 連接字串或發行設定檔 XML 檔案。

ServerName - 伺服器名稱
string. 當 TargetMethod = server 時為必要。預設值：localhost。

指定SQL Server名稱，例如 machinename\FabriakmSQL,1433 或 localhost.\SQL2012R2 。指定 localhost 會連線到電腦上的預設SQL Server實例。

DatabaseName - 資料庫名稱
string. 當 TargetMethod = server 時為必要。

指定SQL Server資料庫的名稱。

SqlUsername - SQL 使用者名稱
string. 選擇性。使用時機 TargetMethod = server 。

如果指定SQL Server登入，它會用來連線到SQL Server。預設的整合式驗證會使用電腦系統管理員的認證。

SqlPassword - SQL 密碼
string. 選擇性。使用時機 TargetMethod = server 。

如果指定SQL Server登入使用者名稱，請提供SQL Server密碼。預設的整合式驗證會使用電腦系統管理員的認證。

ConnectionString - 連接字串
string. 當 TargetMethod = connectionString 時為必要。

指定SQL Server 連接字串，例如 Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder; 。

PublishProfile - 發佈設定檔
string.

提供SQL Server資料庫建立或升級的精細控制。指定目的電腦上發行設定檔 XML 檔案的路徑，或是電腦系統管理員認證可存取的 UNC 共用。

AdditionalArguments - 其他引數
string.

指定在建立或更新SQL Server資料庫時套用的其他 SqlPackage.exe 引數，例如 /p:IgnoreAnsiNulls=True 或 /p:IgnoreComments=True 。如果提供) ，這些引數將會覆寫發行設定檔 XML 檔案 (中的設定。

DeployInParallel - 平行部署
boolean. 預設值：true。

當設定為 true 時，會在目的電腦上平行執行資料庫部署工作。

ResourceFilteringMethod - 選取電腦依據
string. 允許的值： machineNames (電腦名稱稱) 、 tags 。預設值：machineNames。

選擇性。藉由提供電腦名稱稱或標籤來指定機器的子集。

MachineFilter - 部署至電腦
string.

此輸入僅適用于電腦群組，但尚未支援一般電腦清單或輸出變數。
指定電腦清單，例如 dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34 、或標籤，例如 Role:DB; OS:Win8.1 。如果提供多個標籤，工作會在具有指定標籤的所有機器中執行。針對 Azure 資源群組，提供虛擬機器的名稱，例如 ffweb 或 ffdb 。預設會在所有機器中執行工作。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制項選項和一般工作屬性。

輸出變數

無。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
執行于	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
Settable 變數	任何
代理程式版本	1.96.2 或更新版本
工作類別	部署

共用方式為