Freigeben über


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

Verwenden Sie diese Aufgabe, um eine SQL Server-Datenbank mit DACPAC bereitzustellen.

Wichtig

Dieser Vorgang ist veraltet und wird am 31. Januar 2024 eingestellt. Verwenden Sie IIS Web App-Bereitstellung mit WinRM – Viual Studio Marketplace.

Verwenden Sie diese Aufgabe, um eine SQL Server-Datenbank mit DACPAC bereitzustellen.

Diese Aufgabe ist veraltet.

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.

Eingänge

EnvironmentName - Computer
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 - Administratoranmeldung
string.

Gibt die Administratoranmeldung für die Zielcomputer an.


AdminPassword - Kennwort
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 markieren, um ihn zu sichern.


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

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


TestCertificate - Testzertifikat
boolean. Wahlfrei. Wird verwendet, 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 auf einem UNC-Pfad an, z. B. \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Der UNC-Pfad sollte für das Administratorkonto des Computers zugänglich sein. Umgebungsvariablen werden auch unterstützt, z. B. $env:windir, $env:systemrootund $env:windir\FabrikamFibre\Web.


TargetMethod - Sql mithilfe von angeben
string. Erforderlich. Zulässige Werte: server, connectionString (Verbindungszeichenfolge), publishProfile (Veröffentlichungsprofil). Standardwert: server.

Gibt die Option zum Herstellen einer Verbindung mit der SQL Server-Zieldatenbank an. Sie können SQL Server-Datenbankdetails, eine SQL Server-Verbindungszeichenfolge oder eine XML-Veröffentlichungsprofildatei bereitstellen.


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

Gibt den SQL Server-Namen an, z. B. machinename\FabriakmSQL,1433 oder localhost oder .\SQL2012R2. Angeben localhost stellt eine Verbindung mit der SQL Server-Standardinstanz auf dem Computer her.


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

Gibt den Namen der SQL Server-Datenbank an.


SqlUsername - SQL-Benutzername
string. Wahlfrei. Wird verwendet, wenn TargetMethod = server.

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


SqlPassword - SQL-Kennwort
string. Wahlfrei. Wird verwendet, wenn TargetMethod = server.

Wenn der SQL Server-Anmeldebenutzername 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. B. Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;.


PublishProfile - Profil veröffentlichen
string.

Bietet eine differenzierte Kontrolle über die Erstellung oder Upgrades von SQL Server-Datenbanken. Gibt den Pfad zur Veröffentlichungsprofil-XML-Datei auf dem Zielcomputer oder auf einer UNC-Freigabe an, auf die von den Anmeldeinformationen des Computeradministrators zugegriffen werden kann.


AdditionalArguments - zusätzliche Argumente
string.

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


DeployInParallel - Parallel bereitstellen
boolean. Standardwert: true.

Wenn sie auf truefestgelegt ist, wird die Datenbankbereitstellungsaufgabe auf den Zielcomputern parallel ausgeführt.


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

Wahlfrei. Gibt eine Teilmenge von Computern an, indem Computernamen oder -tags bereitgestellt werden.


MachineFilter - Bereitstellung 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.34oder Tags, z. B. Role:DB; OS:Win8.1. Wenn mehrere Tags bereitgestellt werden, wird die Aufgabe 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 die Aufgabe auf allen Computern ausgeführt.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 1.96.2 oder höher
Vorgangskategorie Einsetzen