SqlServerDacpacDeployment@1 - SQL Server 数据库部署 (已弃用) v1 任务

使用此任务使用 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。 允许的值:HttpHttps

指定要用于与计算机建立 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。 必填。 允许的值:serverconnectionString(连接字符串)、publishProfile(发布配置文件)。 默认值:server

指定连接到目标 SQL Server 数据库的选项。 可以提供 SQL Server 数据库详细信息、SQL Server 连接字符串或发布配置文件 XML 文件。


ServerName - 服务器名称
stringTargetMethod = server时是必需的。 默认值:localhost

指定 SQL Server 名称,例如 machinename\FabriakmSQL,1433localhost.\SQL2012R2。 指定 localhost 连接到计算机上的默认 SQL Server 实例。


DatabaseName - 数据库名称
stringTargetMethod = server时是必需的。

指定 SQL Server 数据库的名称。


SqlUsername - SQL 用户名
string。 可选。 当 TargetMethod = server时使用。

如果指定了 SQL Server 登录名,则用于连接到 SQL Server。 默认的集成身份验证使用计算机管理员的凭据。


SqlPassword - SQL 密码
string。 可选。 当 TargetMethod = server时使用。

如果指定了 SQL Server 登录用户名,请提供 SQL Server 密码。 默认的集成身份验证使用计算机管理员的凭据。


ConnectionString - 连接字符串
stringTargetMethod = 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 资源组,请提供虚拟机的名称,例如 ffwebffdb。 默认值在所有计算机中运行任务。


任务控制选项

除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性

输出变量

没有。

要求

要求 说明
管道类型 YAML,经典版本,经典版本
运行时间 代理,DeploymentGroup
需求 没有
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 1.96.2 或更高版本
任务类别 部署