SSMA 콘솔의 명령줄 옵션(AccessToSQL)

아티클
05/23/2023

Microsoft는 SSMA 활동을 실행하고 제어하는 강력한 명령줄 옵션 집합을 제공합니다. 이어지는 섹션에서는 추가 세부 정보를 제공합니다.

SSMA 콘솔의 명령줄 옵션

여기에 설명된 콘솔 명령 옵션은 다음과 같습니다.

이 섹션의 목적을 위해 'option'이라는 용어를 'switch'라고도 합니다.

옵션은 대/소문자를 구분하지 않으며 '' 또는 '-/' 문자로 시작할 수 있습니다.

옵션을 지정하는 경우 해당 옵션 매개 변수를 지정해야 합니다.

옵션 매개 변수는 옵션 문자와 공백으로 구분해야 합니다.

구문 예제:

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"

공백이 포함된 폴더 또는 파일 이름은 큰따옴표로 지정해야 합니다.

명령줄 항목 및 오류 메시지의 출력은 STDOUT 또는 지정된 파일에 저장됩니다.

스크립트 파일 옵션: -s/script

필수 스위치인 스크립트 파일 경로/이름은 SSMA에서 실행할 명령 시퀀스의 스크립트를 지정합니다.

구문 예제:

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

변수 값 파일 옵션: -v/variable

변수 값 파일은 스크립트 파일에 사용되는 변수로 구성됩니다. 스위치는 선택 사항입니다. 변수가 변수 파일에 선언되지 않고 스크립트 파일에서 사용되는 경우 애플리케이션은 오류를 생성하고 콘솔 실행을 종료합니다.

구문 예제:

여러 변수 값 파일에 정의된 변수( 기본값이 있는 변수 및 해당되는 경우 인스턴스별 값이 있는 변수) 명령줄 인수에 지정된 마지막 변수 파일은 변수가 중복되는 경우 기본 설정을 사용합니다.

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"

서버 연결 파일 옵션: -c/serverconnection

이 파일에는 각 서버에 대한 서버 연결 정보가 포함되어 있습니다. 각 서버 정의는 고유한 서버 ID로 식별됩니다. 서버 ID는 연결 관련 명령에 대한 스크립트 파일에서 참조됩니다.

서버 정의는 서버 연결 파일 및/또는 스크립트 파일의 일부일 수 있습니다. 서버 ID가 중복되는 경우 스크립트 파일의 서버 ID가 서버 연결 파일보다 우선합니다.

구문 예제:

서버 ID는 스크립트 파일에 사용됩니다. 별도의 서버 연결 파일에 정의됩니다. 이 파일은 변수 값 파일에 정의된 변수를 사용합니다.

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
서버 정의는 스크립트 파일에 포함됩니다.

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

XML 출력 옵션: -x/xmloutput [xmloutputfile]

이 명령은 콘솔 또는 xml 파일에 xml 형식으로 명령 출력 메시지를 출력하는 데 사용됩니다.

xmloutput에는 다음과 같은 두 가지 옵션을 사용할 수 있습니다.

xmloutput 스위치 후에 파일 경로가 제공되면 출력이 파일로 리디렉션됩니다.

구문 예제:

C:\>SSMAforAccessConsole.EXE -s

"C:\Program Files\Microsoft SQL Server Migration Assistant for Access\Sample Console Scripts\ConversionAndDataMigrationSample.xml" -x d:\xmloutput\project1output.xml
xmloutput 스위치 후에 파일 경로가 제공되지 않으면 xmlout이 콘솔 자체에 표시됩니다.

구문 예제:

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

로그 파일 옵션: -l/log

콘솔 애플리케이션의 모든 SSMA 작업은 로그 파일에 기록되며 스위치는 선택 사항입니다. 명령줄에서 로그 파일과 해당 경로를 지정하면 지정된 위치에 로그가 생성됩니다. 그렇지 않으면 기본 위치에 생성됩니다.

구문 예제:

C:\>SSMAforAccessConsole.EXE

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

프로젝트 환경 폴더 옵션: -e/projectenvironment

이 선택적 스위치는 현재 SSMA 프로젝트의 프로젝트 환경 설정 폴더를 표시합니다.

구문 예제:

C:\>SSMAforAccessConsole.EXE -s

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

보안 암호 옵션: -p/securepassword

이 옵션은 서버 연결에 대한 암호화된 암호를 나타냅니다. 마이그레이션 관련 활동에 스크립트나 도움말을 실행하지 않지만 마이그레이션 프로젝트에 사용되는 서버 연결에 대한 암호 암호화를 관리하는 데 도움이 된다는 점에서 다른 모든 옵션과 다릅니다.

명령줄 매개 변수로 다른 옵션이나 암호를 입력할 수 없습니다. 그렇지 않으면 오류가 발생합니다. 자세한 내용은 암호 관리 섹션을 참조 하세요 .

다음 하위 구성 요소가 지원됩니다.-p/securepassword

지정된 서버 ID 또는 서버 연결 파일에 정의된 모든 서버 ID의 보호된 스토리지에 암호를 추가하거나 기존 암호를 업데이트하려면 다음을 수행합니다.

-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]
지정된 서버 ID 또는 모든 서버 ID의 보호된 스토리지에서 암호화된 암호를 제거하려면 다음을 수행합니다.

-p/securepassword -r/remove {<server_id> [, ...n] | all}
암호가 암호화된 서버 ID 목록을 표시하려면 다음을 수행합니다.

-p/securepassword -l/list
보호된 스토리지에 저장된 암호를 암호화된 파일로 내보내려면 이 파일은 사용자 지정 암호로 암호화됩니다.

-p/securepassword -e/export {<server-id> [, ...n] | all} <encrypted-password -file>
이전에 내보낸 암호화된 파일은 사용자 지정 암호 구를 사용하여 로컬로 보호된 스토리지로 가져옵니다. 파일이 암호 해독되면 새 파일에 저장되고, 그러면 로컬 컴퓨터에서 암호화됩니다.

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

쉼표 구분 기호를 사용하여 여러 서버 ID를 지정할 수 있습니다.

도움말 옵션: -?/Help

SSMA 콘솔 옵션의 구문 요약을 표시합니다.

C:\>SSMAforAccessConsole.EXE -?

SSMA 콘솔 명령줄 옵션의 테이블 형식 표시는 부록 - 1(AccessToSQL)을 참조하세요.

SecurePassword 도움말 옵션: -securepassword -?/Help

SSMA 콘솔 옵션의 구문 요약을 표시합니다.

C:\>SSMAforAccessConsole.EXE -securepassword -?

SSMA 콘솔 명령줄 옵션의 테이블 형식 표시는 부록 - 1(AccessToSQL)을 참조 하세요.

다음 단계

다음 단계는 프로젝트 요구 사항에 따라 달라집니다.

암호를 지정하거나 암호를 내보내거나 가져오려면 암호 관리(AccessToSQL)를 참조하세요.
보고서를 생성하려면 보고서 생성(AccessToSQL)을 참조하세요.
콘솔의 문제 해결은 문제 해결(AccessToSQL)을 참조하세요.

SSMA 콘솔의 명령줄 옵션(AccessToSQL)