SSMA 콘솔의 명령줄 옵션(AccessToSQL)
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)을 참조 하세요.
다음 단계
다음 단계는 프로젝트 요구 사항에 따라 달라집니다.