Dela via

Kommandoradsalternativ i SSMA-konsolen (AccessToSQL)

  • Artikel

Microsoft tillhandahåller en robust uppsättning kommandoradsalternativ för att köra och kontrollera SSMA-aktiviteter. De efterföljande avsnitten innehåller ytterligare information.

Kommandoradsalternativ i SSMA-konsolen

Här beskrivs kommandoalternativen för konsolen.

I det här avsnittet kallas termen "alternativ" även för "switch".

Alternativen är inte skiftlägeskänsliga och kan börja med antingen tecknet-eller/.

Om alternativ anges är det obligatoriskt att du anger motsvarande alternativparametrar.

Alternativparametrarna måste avgränsas från alternativtecknet med tomt utrymme.

Syntaxexempel:

C:\> SSMAforAccessConsole.EXE -s scriptfile

C:\> SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\AssessmentReportGenerationSample.xml" -v "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\VariableValueFileSample.xml" -c "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ServersConnectionFileSample.xml"

Mapp- eller filnamn som innehåller blanksteg bör anges inom dubbla citattecken.

Utdata från kommandoradsposter och felmeddelanden lagras i STDOUT eller i en angiven fil.

Alternativ för skriptfil: -s/script

En obligatorisk växling, där skriptfilens sökväg/namn anger de kommandosekvenser som ska köras av SSMA.

Syntaxexempel:

C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Filalternativ för variabelvärde: -v/variable

Variabelvärdefilen består av variabler som används i skriptfilen. Växeln är valfri. Om variabler inte deklareras i variabelfilen och används i skriptfilen genererar programmet ett fel och avslutar konsolkörningen.

Syntaxexempel:

  • Variabler som definieras i flera filer med variabelvärde, kanske en med ett standardvärde och en annan med ett instansspecifikt värde när det är tillämpligt. Den sista variabelfilen som anges i kommandoradsargumenten har företräde, vid duplicering av variabler.

    C:\>SSMAforAccessConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v c:\migration

    projects\global_variablevaluefile.xml -v "c:\migrationprojects\instance_variablevaluefile.xml"

Filalternativ för serveranslutning: -c/serverconnection

Den här filen innehåller serveranslutningsinformation för varje server. Varje serverdefinition identifieras med ett unikt server-ID. Server-ID:t refereras till i skriptfilen för anslutningsrelaterade kommandon.

Serverdefinitionen kan vara en del av serveranslutningsfilen och/eller skriptfilen. Server-ID i skriptfilen har företräde framför serveranslutningsfilen, om det finns en duplicering av server-ID.

Syntaxexempel:

  • Server-ID:t används i skriptfilen. De definieras i en separat serveranslutningsfil. Den här filen använder variabler som definieras i variabelvärdefilen:

    C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v

    c:\SsmaProjects\myvaluefile1.xml -c

    c:\SsmaProjects\myserverconnectionsfile1.xml

  • Serverdefinitionen är inbäddad i skriptfilen:

    C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml"

Alternativ för XML-utdata: -x/xmloutput [xmloutputfile]

Det här kommandot används för att mata ut kommandots utdatameddelanden i ett XML-format, antingen till konsolen eller till en XML-fil.

Det finns två tillgängliga alternativ för xmloutput, nämligen:

  • Om filsökvägen anges efter xmloutput-växeln omdirigeras utdata till filen.

    Syntaxexempel:

    C:\>SSMAforAccessConsole.EXE -s

    "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml

  • Om ingen filsökväg har angetts efter xmloutput-växeln visas xmlout i själva konsolen.

    Syntaxexempel:

    C:\>SSMAforAccessConsole.EXE -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -xmloutput

Loggfilsalternativ: -l/log

Alla SSMA-åtgärder i konsolprogrammet registreras i en loggfil och växeln är valfri. Om en loggfil och dess sökväg anges på kommandoraden genereras loggen på den angivna platsen. Annars genereras den på standardplatsen.

Syntaxexempel:

C:\>SSMAforAccessConsole.EXE

"C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -l c:\SsmaProjects\migration1.log

Mappalternativ för projektmiljö: -e/projectenvironment

Den här valfria växeln anger mappen för projektmiljöinställningar för det aktuella SSMA-projektet.

Syntaxexempel:

C:\>SSMAforAccessConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -e c:\SsmaProjects\CommonEnvironment

Alternativet Skydda lösenord: -p/securepassword

Det här alternativet anger det krypterade lösenordet för serveranslutningar. Den skiljer sig från alla andra alternativ eftersom den inte kör något skript eller någon hjälp i migreringsrelaterade aktiviteter, utan hjälper till att hantera lösenordskryptering för de serveranslutningar som används i migreringsprojektet.

Du kan inte ange något annat alternativ eller lösenord som kommandoradsparameter. Annars resulterar det i ett fel. Mer information finns i avsnittet Hantera lösenord.

Följande underalternativ stöds för -p/securepassword:

  • Om du vill lägga till ett lösenord, eller uppdatera ett befintligt lösenord, till skyddat lagringsutrymme för ett angivet server-ID eller för alla server-ID:t som definierats i serveranslutningsfilen:

    -p|-securepassword -a|add {"<server_id>[, .n]"|all}``-c|-serverconnection <server-connection-file> [-v|variable <variable-value-file>]``[-o|overwrite]

    -p|-securepassword -a|add {"<server_id>[, .n]"|all}``-s|-script <server-connection-file> [-v|variable <variable-value-file>] [-o|overwrite]

  • Så här tar du bort det krypterade lösenordet från den skyddade lagringen av det angivna server-ID:t eller för alla server-ID:t:

    -p/securepassword -r/remove {<server_id> [, ...n] | all}

  • Så här visar du en lista över server-ID:t som lösenordet är krypterat för:

    -p/securepassword -l/list

  • Så här exporterar du lösenorden som lagras i skyddad lagring till en krypterad fil. Den här filen krypteras med den användardefinierade lösenfrasen.

    -p/securepassword -e/export {<server-id> [, ...n] | all} <encrypted-password -file>

  • Den krypterade filen som tidigare exporterades importeras till lokal skyddad lagring med hjälp av den användardefinierade lösenfrasen. När filen har dekrypterats lagras den i en ny fil, som i sin tur krypteras på den lokala datorn.

    -p/securepassword -i/import {<server-id> [, ...n] | all} <encrypted-password -file>

    Flera server-ID:er kan anges med kommaavgränsare.

Hjälpalternativ: -?/Hjälp

Visar syntaxsammanfattningen för SSMA-konsolalternativ:

C:\>SSMAforAccessConsole.EXE -?

En tabellvisning av kommandoradsalternativen för SSMA-konsolen finns i Bilaga - 1 (AccessToSQL).

Hjälpalternativet SecurePassword: -securepassword -?/Help

Visar syntaxsammanfattningen för SSMA-konsolalternativ:

C:\>SSMAforAccessConsole.EXE -securepassword -?

En tabellvisning av kommandoradsalternativen för SSMA-konsolen finns i Bilaga - 1 (AccessToSQL)

Nästa steg

Nästa steg beror på dina projektkrav:

  1. Information om hur du anger ett lösenord eller exporterar/importerar lösenord finns i Hantera lösenord (AccessToSQL).

  2. Information om hur du genererar rapporter finns i Generera rapporter (AccessToSQL).

  3. För felsökning av problem i konsolen, se Felsökning (AccessToSQL).