SqlServerDacpacDeployment@1 - SQL Server-database implementeren (afgeschaft) v1-taak

Gebruik deze taak om een SQL Server-database te implementeren met DACPAC.

Belangrijk

Deze taak is afgeschaft en wordt buiten gebruik gesteld op 31 januari 2024. Gebruik IIS-web-app-implementatie met WinRM - Viual Studio Marketplace.

Syntaxis

# 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.

Invoer

EnvironmentName - Machines
string. Verplicht.

Hiermee geeft u een door komma's gescheiden lijst met IP-adressen of FQDN's van computers, samen met poorten. De standaardpoort is gebaseerd op het geselecteerde protocol. Bijvoorbeeld: dbserver.fabrikam.com,dbserver_int.fabrikam.com:5986,192.168.12.34:5986 Uitvoervariabelen van andere taken kunnen ook worden opgegeven, bijvoorbeeld $(variableName).

AdminUserName - aanmeldgegevens van beheerders
string.

Hiermee geeft u de beheerdersaanmelding voor de doelcomputers.

AdminPassword - wachtwoord
string.

Hiermee geeft u het beheerderswachtwoord voor de doelmachines. Variabelen die zijn gedefinieerd in build- of releasedefinities, worden geaccepteerd als $(passwordVariable). U kunt het variabeletype markeren als secret om het te beveiligen.

Protocol - Protocol
string. Toegestane waarden: Http, Https.

Hiermee geeft u het protocol dat moet worden gebruikt voor de WinRM-verbinding met de machine(s). De standaardwaarde is HTTPS.

TestCertificate - certificaat testen
boolean. Facultatief. Gebruiken wanneer Protocol = Https. Standaardwaarde: true.

Slaat de echtheidsvalidatie van het certificaat van de machine over door een vertrouwde certificeringsinstantie. De parameter is vereist voor het WinRM HTTPS-protocol.

DacpacFile - DACPAC-bestand
string. Verplicht.

Hiermee geeft u de locatie van het DACPAC-bestand op de doelcomputers of op een UNC-pad, zoals \\BudgetIT\Web\Deploy\FabrikamDB.dacpac. Het UNC-pad moet toegankelijk zijn voor het beheerdersaccount van de computer. Omgevingsvariabelen worden ook ondersteund, zoals $env:windir, $env:systemrooten $env:windir\FabrikamFibre\Web.

TargetMethod - SQL opgeven met behulp van
string. Verplicht. Toegestane waarden: server, connectionString (verbindingsreeks), publishProfile (Publicatieprofiel). Standaardwaarde: server.

Hiermee geeft u de optie om verbinding te maken met de doel-SQL Server-database. U kunt sql Server-databasegegevens, een SQL Server-verbindingsreeks of een XML-bestand met een publicatieprofiel opgeven.

ServerName - servernaam
string. Vereist wanneer TargetMethod = server. Standaardwaarde: localhost.

Hiermee geeft u de SQL Server-naam, zoals machinename\FabriakmSQL,1433 of localhost of .\SQL2012R2. Het opgeven van localhost maakt verbinding met het standaard SQL Server-exemplaar op de computer.

DatabaseName - databasenaam
string. Vereist wanneer TargetMethod = server.

Hiermee geeft u de naam van de SQL Server-database.

SqlUsername - SQL-gebruikersnaam
string. Facultatief. Gebruiken wanneer TargetMethod = server.

Als de SQL Server-aanmelding is opgegeven, wordt deze gebruikt om verbinding te maken met de SQL Server. De standaard, geïntegreerde verificatie, maakt gebruik van de referenties van de computerbeheerder.

SqlPassword - SQL-wachtwoord
string. Facultatief. Gebruiken wanneer TargetMethod = server.

Als de gebruikersnaam van de SQL Server-aanmelding is opgegeven, geeft u het SQL Server-wachtwoord op. De standaard, geïntegreerde verificatie, maakt gebruik van de referenties van de computerbeheerder.

ConnectionString - verbindingsreeks
string. Vereist wanneer TargetMethod = connectionString.

Hiermee geeft u de SQL Server-verbindingsreeks, zoals Server=localhost;Database=Fabrikam;User ID=AccountPlaceholder;Password=PasswordPlaceholder;.

PublishProfile - Profiel publiceren
string.

Biedt gedetailleerde controle over het maken of upgraden van SQL Server-databases. Hiermee geeft u het pad naar het XML-bestand van het publicatieprofiel op de doelcomputer of op een UNC-share die toegankelijk is via de referenties van de computerbeheerder.

AdditionalArguments - Aanvullende argumenten
string.

Hiermee geeft u extra SqlPackage.exe argumenten die worden toegepast bij het maken of bijwerken van de SQL Server-database, zoals /p:IgnoreAnsiNulls=True of /p:IgnoreComments=True. Met deze argumenten worden de instellingen in het XML-bestand van het publicatieprofiel overschreven (indien opgegeven).

DeployInParallel - implementeren in parallelle
boolean. Standaardwaarde: true.

Als deze is ingesteld op true, voert u de database-implementatietaak parallel uit op de doelcomputers.

ResourceFilteringMethod - Machines selecteren op
string. Toegestane waarden: machineNames (machinenamen), tags. Standaardwaarde: machineNames.

Facultatief. Hiermee geeft u een subset van machines op door computernamen of tags op te geven.

MachineFilter - implementeren op machines
string.

Deze invoer is alleen geldig voor machinegroepen en wordt nog niet ondersteund voor een platte lijst met machines of uitvoervariabelen.
Hiermee geeft u een lijst met machines, zoals dbserver.fabrikam.com, webserver.fabrikam.com, 192.168.12.34, of tags, zoals Role:DB; OS:Win8.1. Als er meerdere tags worden opgegeven, wordt de taak uitgevoerd op alle computers met de opgegeven tags. Geef voor Azure-resourcegroepen de naam van de virtuele machine op, zoals ffweb of ffdb. Met de standaardinstelling wordt de taak op alle computers uitgevoerd.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde	Beschrijving
Pijplijntypen	YAML, klassieke build, klassieke release
Wordt uitgevoerd op	Agent, DeploymentGroup
eisen	Geen
mogelijkheden	Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen	Welk dan ook
variabelen instellen	Welk dan ook
Agentversie	1.96.2 of hoger
Taakcategorie	Implementeren