使用此工作來使用 DACPAC 部署 SQL Server 資料庫。
這很重要
此工作已被取代,且將於 2024 年 1 月 31 日淘汰。 使用 winRM 使用 IIS Web 應用程式部署 - Viual Studio Marketplace。
使用此工作來使用 DACPAC 部署 SQL Server 資料庫。
此工作已被取代。
語法
# 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.
輸入
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 資料庫建立或升級的精細控制。 指定目標電腦上或計算機系統管理員認證可存取之 UNC 共用上發行配置檔 XML 檔案的路徑。
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 |
| 需求 | 沒有 |
| 功能 | 此工作不符合作業中後續工作的任何需求。 |
| 命令限制 | 任意 |
| Settable 變數 | 任意 |
| 代理程式版本 | 1.96.2 或更高版本 |
| 工作類別 | 部署 |