Delen via

Opdrachtregelopties in de SSMA-console (AccessToSQL)

Microsoft biedt een robuuste set opdrachtregelopties voor het uitvoeren en beheren van SSMA-activiteiten (SQL Server Migration Assistant). Meer informatie vindt u in de volgende secties.

Opdrachtregelopties in de SSMA-console

In deze sectie worden de consoleopdrachtopties beschreven.

In deze sectie verwijzen de termenoptie en schakeloptie naar hetzelfde.

Opties zijn niet hoofdlettergevoelig en kunnen beginnen met het - of / teken.

Als u opties opgeeft, moet u ook de bijbehorende optieparameters opgeven.

U moet optieparameters scheiden van het optieteken met behulp van witruimte.

Voorbeelden van syntaxis:

SSMAforAccessConsole.exe -s scriptfile

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"

Map- of bestandsnamen die spaties bevatten, moeten tussen dubbele aanhalingstekens worden gezet.

De uitvoer van opdrachtregelvermeldingen en foutberichten gaat naar stdout of naar een opgegeven bestand.

Optie scriptbestand: -s/script

Gebruik deze verplichte schakeloptie om het pad en de naam van het scriptbestand op te geven. Het scriptbestand bevat opdrachtenreeksen die door SSMA worden uitgevoerd.

Voorbeeld van syntaxis:

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

Optie voor bestand met variabele waarde: -v/variabele

Gebruik deze optionele schakeloptie om een variabelewaardebestand op te geven. Het bestand bevat variabelen die in het scriptbestand worden gebruikt. Als in het scriptbestand variabelen worden gebruikt die niet zijn gedeclareerd in een bestand met variabelewaarden, genereert SSMA een fout en wordt de uitvoering van de console beëindigd.

Voorbeeld van syntaxis:

Definieer variabelen in bestanden met meerdere variabele waarden, zoals één bestand met standaardwaarden en een ander bestand met exemplaarspecifieke waarden. Als er sprake is van duplicatie van variabelen, heeft het laatste variabelebestand dat is opgegeven in de opdrachtregelargumenten de voorkeur:

SSMAforAccessConsole.exe -s "C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -v C:\migrationprojects\global_variablevaluefile.xml -v "C:\migrationprojects\instance_variablevaluefile.xml"

Optie voor serververbindingsbestand: -c/serverconnection

Dit bestand bevat serververbindingsgegevens voor elke server. Elke serverdefinitie wordt geïdentificeerd door een unieke server-id. Het scriptbestand verwijst naar elke server-id in opdrachten die betrekking hebben op verbindingen.

Een serverdefinitie kan deel uitmaken van een serververbindingsbestand of een scriptbestand. Als er sprake is van duplicatie van de server-id, heeft de server-id van het scriptbestand voorrang op het serververbindingsbestand.

Voorbeelden van syntaxis:

  • Gebruik server-id's in het scriptbestand en definieer deze in een afzonderlijk serververbindingsbestand. In dit bestand worden variabelen gebruikt die zijn gedefinieerd in het waardebestand voor variabelen:

    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

  • Sluit de serverdefinitie in het scriptbestand in:

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

Optie voor XML-uitvoer: -x/xmloutput [xmloutputfile]

Gebruik deze opdracht om de uitvoerberichten van de opdracht uit te voeren in een XML-indeling, naar de console of naar een XML-bestand.

xmloutput heeft twee opties.

  • Als u het bestandspad na de xmloutput schakeloptie opgeeft, moet u de uitvoer omleiden naar het bestand.

    Voorbeeld van syntaxis:

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

  • Als u na de xmloutput schakeloptie geen bestandspad opgeeft, wordt de uitvoer weergegeven op de console.

    Voorbeeld van syntaxis:

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

Optie voor logboekbestand: -l/log

De consoletoepassing registreert alle SSMA-bewerkingen in een logboekbestand. De schakelaar is optioneel. Als u een logboekbestand en het bijbehorende pad opgeeft op de opdrachtregel, wordt het logboek gegenereerd op de opgegeven locatie. Anders wordt het logboek gegenereerd op de standaardlocatie.

Voorbeeld van syntaxis:

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

Optie voor projectomgeving: -e/projectenvironment

Gebruik deze optionele schakeloptie om de map met projectomgevingsinstellingen voor het huidige SSMA-project op te geven.

Voorbeeld van syntaxis:

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

Optie wachtwoord beveiligen: -p/securepassword

Gebruik deze optie om het versleutelde wachtwoord voor serververbindingen op te geven. Het verschilt van alle andere opties doordat het geen scripts uitvoert en geen hulp biedt bij migratiegerelateerde activiteiten. In plaats daarvan kunt u wachtwoordversleuteling beheren voor de serververbindingen die in het migratieproject worden gebruikt.

Wanneer u deze optie gebruikt, moet dit de enige parameter zijn die u opgeeft. Andere opties of wachtwoorden zorgen ervoor dat de opdracht mislukt. Zie de sectie Wachtwoorden beheren voor meer informatie.

De volgende suboptions worden ondersteund voor -p/securepassword:

  • Een wachtwoord toevoegen of bijwerken in beveiligde opslag voor een opgegeven server-id of voor alle server-id's die zijn gedefinieerd in het serververbindingsbestand:

    -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]

  • Verwijder het versleutelde wachtwoord uit de beveiligde opslag van de opgegeven server-id of voor alle server-id's:

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

  • Een lijst met server-id's weergeven waarvoor het wachtwoord is versleuteld:

    -p/securepassword -l/list

  • Exporteer de wachtwoorden die zijn opgeslagen in beveiligde opslag naar een versleuteld bestand. Dit bestand wordt versleuteld met de door de gebruiker opgegeven wachtwoordzin.

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

  • Het eerder geëxporteerde versleutelde bestand wordt geïmporteerd in lokale beveiligde opslag met behulp van de door de gebruiker opgegeven wachtwoordzin. Zodra het bestand is ontsleuteld, wordt de inhoud opgeslagen in een nieuw bestand, dat op zijn beurt wordt versleuteld op de lokale computer.

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

    U kunt meerdere server-id's opgeven met behulp van kommascheidingstekens.

Help-optie: -?/Help

Geeft de syntaxissamenvatting weer van SSMA Console-opties.

Zie Bijlage - 1 voor een tabelweergave van de opdrachtregelopties van de SSMA-console.

Voorbeeld van syntaxis:

SSMAforAccessConsole.exe -?

SecurePassword Help optie: -securepassword -?/Help

Geeft de syntaxissamenvatting weer van SSMA Console-opties:

Zie Bijlage - 1 voor een tabelweergave van de opdrachtregelopties van de SSMA-console.

Voorbeeld van syntaxis:

SSMAforAccessConsole.exe -securepassword -?

Verwante inhoud

  • Last updated on