SqlServerDacpacDeployment@1 – SQL Server Aufgabe "Datenbankbereitstellung (veraltet) v1"

Verwenden Sie diese Aufgabe, um eine SQL Server Datenbank mithilfe von DACPAC bereitzustellen.

Wichtig

Diese Aufgabe ist veraltet und wird am 31. Januar 2024 eingestellt. Verwenden Sie die IIS-Web-App-Bereitstellung mithilfe von WinRM – Viual Studio Marketplace.

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.

Eingaben

EnvironmentName - Maschinen
string. Erforderlich.

Gibt eine durch Trennzeichen getrennte Liste von Computer-IP-Adressen oder FQDNs zusammen mit Ports an. Der Standardport basiert auf dem ausgewählten Protokoll. Beispiel: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986 Ausgabevariablen anderer Aufgaben können auch bereitgestellt werden, z. B $(variableName). .

AdminUserName - Admin Anmeldung
string.

Gibt die Administratoranmeldung für die Zielcomputer an.

AdminPassword - Passwort
string.

Gibt das Administratorkennwort für die Zielcomputer an. Variablen, die in Build- oder Releasedefinitionen definiert sind, werden als $(passwordVariable)akzeptiert. Sie können den Variablentyp als secret zum Sichern markieren.

Protocol - Protokoll
string. Zulässige Werte: Http, Https.

Gibt das Protokoll an, das für die WinRM-Verbindung mit den Computern verwendet werden soll. Standardwert: HTTPS.

TestCertificate - Zertifikat testen
boolean. Optional. Verwenden Sie , wenn Protocol = Https. Standardwert. true.

Überspringt die Echtheitsüberprüfung des Zertifikats des Computers durch eine vertrauenswürdige Zertifizierungsstelle. Der Parameter ist für das WinRM-HTTPS-Protokoll erforderlich.

DacpacFile - DACPAC-Datei
string. Erforderlich.

Gibt den Speicherort der DACPAC-Datei auf den Zielcomputern oder in einem UNC-Pfad wie \\BudgetIT\Web\Deploy\FabrikamDB.dacpacan. Der UNC-Pfad sollte für das Administratorkonto des Computers zugänglich sein. Umgebungsvariablen wie $env:windir, $env:systemrootund $env:windir\FabrikamFibre\Webwerden ebenfalls unterstützt.

TargetMethod - Angeben von SQL mit
string. Erforderlich. Zulässige Werte: server, connectionString (Verbindungszeichenfolge), publishProfile (Veröffentlichungsprofil). Standardwert. server.

Gibt die Option an, eine Verbindung mit der Zieldatenbank SQL Server herzustellen. Sie können SQL Server Datenbankdetails, eine SQL Server Verbindungszeichenfolge oder eine XML-Datei für das Veröffentlichungsprofil angeben.

ServerName - Servername
string. Erforderlich, wenn TargetMethod = server. Standardwert. localhost.

Gibt den SQL Server Namen an, z. Bmachinename\FabriakmSQL,1433. oder localhost.\SQL2012R2oder . Angeben einer localhost Verbindung mit dem Standard SQL Server instance auf dem Computer.

DatabaseName - Datenbankname
string. Erforderlich, wenn TargetMethod = server.

Gibt den Namen der SQL Server-Datenbank an.

SqlUsername - SQL-Benutzername
string. Optional. Verwenden Sie , wenn TargetMethod = server.

Wenn die SQL Server-Anmeldung angegeben ist, wird sie verwendet, um eine Verbindung mit dem SQL Server herzustellen. Die Standardmäßige integrierte Authentifizierung verwendet die Anmeldeinformationen des Computeradministrators.

SqlPassword - SQL-Kennwort
string. Optional. Verwenden Sie , wenn TargetMethod = server.

Wenn der SQL Server Benutzernamen für die Anmeldung angegeben ist, geben Sie das SQL Server Kennwort an. Die Standardmäßige integrierte Authentifizierung verwendet die Anmeldeinformationen des Computeradministrators.

ConnectionString - Verbindungszeichenfolge
string. Erforderlich, wenn TargetMethod = connectionString.

Gibt die SQL Server Verbindungszeichenfolge an, z. BServer=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;. .

PublishProfile - Profil veröffentlichen
string.

Bietet eine differenzierte Kontrolle über SQL Server Datenbankerstellung oder -upgrades. Gibt den Pfad zur XML-Datei zum Veröffentlichen des Profils auf dem Zielcomputer oder auf einer UNC-Freigabe an, auf die die Anmeldeinformationen des Computeradministrators zugreifen können.

AdditionalArguments - Zusätzliche Argumente
string.

Gibt zusätzliche SqlPackage.exe Argumente an, die beim Erstellen oder Aktualisieren der SQL Server Datenbank angewendet werden, z/p:IgnoreAnsiNulls=True. B. oder /p:IgnoreComments=True. Diese Argumente überschreiben die Einstellungen in der XML-Datei des Veröffentlichungsprofils (sofern angegeben).

DeployInParallel - Parallel bereitstellen
boolean. Standardwert. true.

Wenn auf truefestgelegt ist, führt die Datenbankbereitstellungsaufgabe parallel auf den Zielcomputern aus.

ResourceFilteringMethod - Computer nach auswählen
string. Zulässige Werte: machineNames (Computernamen), tags. Standardwert. machineNames.

Optional. Gibt eine Teilmenge von Computern an, indem Computernamen oder Tags angegeben werden.

MachineFilter - Bereitstellen auf Computern
string.

Diese Eingabe ist nur für Computergruppen gültig und wird für eine flache Liste von Computern oder Ausgabevariablen noch nicht unterstützt.
Gibt eine Liste von Computern an, z. B dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34. oder Tags wie Role:DB; OS:Win8.1. Wenn mehrere Tags bereitgestellt werden, wird der Task auf allen Computern mit den angegebenen Tags ausgeführt. Geben Sie für Azure-Ressourcengruppen den Namen des virtuellen Computers an, z. B ffweb . oder ffdb. Standardmäßig wird der Task auf allen Computern ausgeführt.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	1.96.2 oder höher
Aufgabenkategorie	Bereitstellen