SqlServerDacpacDeployment@1 - SQL Server データベースデプロイ (非推奨) v1 タスク

[アーティクル]
08/19/2024

このタスクを使用して、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.

# 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\FabrikamFibre\Webなど$env:windir$env:systemrootでもサポートされています。

TargetMethod - 使用して SQL を指定する
string. 必須です。使用できる値: server、 connectionString (接続文字列)、 publishProfile (発行プロファイル)。既定値: server。

ターゲット SQL Server データベースに接続するオプションを指定します。 SQL Serverデータベースの詳細、SQL Server 接続文字列、または発行プロファイル XML ファイルを指定できます。

ServerName - サーバー名
string. TargetMethod = server の場合に必要です。既定値: localhost。

または localhost.\SQL2012R2などのmachinename\FabriakmSQL,1433SQL Server名を指定します。を指定すると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 の場合に必要です。

のようなServer=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;SQL Server 接続文字列を指定します。

PublishProfile - プロファイルの発行
string.

SQL Serverデータベースの作成またはアップグレードをきめ細かく制御できます。ターゲットコンピューターまたはコンピューター管理者の資格情報からアクセスできる UNC 共有上の発行プロファイル XML ファイルへのパスを指定します。

AdditionalArguments - その他の引数
string.

や /p:IgnoreComments=Trueなど/p:IgnoreAnsiNulls=True、SQL Server データベースを作成または更新するときに適用される追加SqlPackage.exeの引数を指定します。これらの引数は、発行プロファイル 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 リソースグループの場合は、や ffdbなどffweb、仮想マシンの名前を指定します。既定では、すべてのマシンでタスクが実行されます。

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。詳細については、「コントロールオプションと一般的なタスクプロパティ」を参照してください。

出力変数

[なし] :

必要条件

要件	説明
パイプラインの種類	YAML、クラシックビルド、クラシックリリース
上で実行	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	1.96.2 以降
タスクのカテゴリ	配置

次の方法で共有

SqlServerDacpacDeployment@1 - SQL Server データベースデプロイ (非推奨) v1 タスク

構文

入力

タスク制御オプション

出力変数

必要条件

フィードバック

その他のリソース