このタスクを使用して、DACPAC を使用して SQL Server データベースをデプロイします。
重要
このタスクは非推奨となり、2024 年 1 月 31 日に廃止されます。 WinRM - Viual Studio Marketplace を使用した IIS Web アプリの展開使用します。
このタスクを使用して、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
-
Machines
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.
machinename\FabriakmSQL,1433、localhost、.\SQL2012R2など、SQL Server の名前を指定します。
localhost を指定すると、コンピューター上の既定の SQL Server インスタンスに接続されます。
DatabaseName
-
データベース名の
string.
TargetMethod = serverする場合に必要です。
SQL Server データベースの名前を指定します。
SqlUsername
-
SQL Username
string. 任意
TargetMethod = serverするときに使用します。
SQL Server ログインが指定されている場合は、SQL Server への接続に使用されます。 既定の統合認証では、マシン管理者の資格情報が使用されます。
SQL パスワードの SqlPassword -
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:IgnoreAnsiNulls=True や /p:IgnoreComments=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 リソース グループの場合は、仮想マシンの名前 (ffweb や ffdbなど) を指定します。 既定では、すべてのマシンでタスクが実行されます。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。