nscontrol export 명령

아티클
12/15/2008

업데이트: 2005년 12월 5일

데이터베이스에서 메타데이터를 내보내어 XML 인스턴스 구성 파일(ICF)을 만들고 응용 프로그램 당 하나의 XML ADF(응용 프로그램 정의 파일)를 하나 이상 만듭니다. 결과 파일은 내보내기 명령을 실행할 당시에 유효한 인스턴스 및 응용 프로그램 정의입니다. 이 정보를 사용하여 인스턴스 및 응용 프로그램 정의를 백업할 수 있으며 인스턴스를 만들거나 업데이트하는 데 사용할 수 있는 파일을 생성할 수 있습니다.

구문

nscontrol export 
    [-nologo]
    [-help] 
        -name instanceName
    [-server databaseServer]
    [-sqlusername sqlUserName -sqlpassword sqlPassword]
    [-out directory]
    [-force]

인수

-nologo
nscontrol 명령을 실행할 때 나타나는 제품 및 버전 설명을 표시하지 않습니다.

-help
명령 구문을 표시합니다.

-nameinstanceName
구성 및 응용 프로그램 정의 파일을 만드는 데 사용할 인스턴스의 이름입니다.

-serverdatabaseServer
인스턴스 및 응용 프로그램 데이터베이스를 호스팅하는 서버의 이름입니다. 인스턴스가 로컬 컴퓨터에 등록되지 않은 경우에만 이 인수를 제공합니다. 인스턴스가 등록되어 있는데 -server 인수를 제공하는 경우 인스턴스에 대한 레지스트리 값은 무시됩니다.

명명된 SQL Server 인스턴스를 사용하여 인스턴스 데이터베이스를 호스팅하는 경우 <servername>\<instancename> 형식을 사용하여 서버 이름 및 인스턴스 이름을 지정합니다.

-sqlusernamesqlUserName
SQL Server에 연결하는 데 사용되는 SQL Server 로그인입니다.

중요:

Windows 인증은 SQL Server 인증보다 안전합니다. 가능하면 Windows 인증을 사용하십시오.

SQL Server 인증을 사용하여 SQL Server에 연결하는 경우 이 인수를 사용하여 로그인을 지정합니다. 또한 -sqlpassword 인수를 사용하여 암호를 지정합니다.

Windows 인증을 사용하는 경우 -sqlusername과 -sqlpassword 인수를 지정하지 마십시오.

중요:
Windows 인증은 SQL Server 인증보다 안전합니다. 가능하면 Windows 인증을 사용하십시오.

-sqlpasswordsqlPassword
-sqlusername 로그인과 연관된 암호입니다. SQL Server 인증을 사용하여 연결하는 경우에만 이 인수를 사용해야 합니다.

-outdirectory
파일을 쓸 디렉터리입니다. 기본 디렉터리는 현재 디렉터리입니다.

-force
출력 디렉터리에서 이름이 같은 기존 파일을 덮어쓰도록 지정합니다.

주의

인스턴스를 실행하는 동안 nscontrol export 명령을 사용할 수 있습니다. 인스턴스를 해제하거나 중지할 필요가 없습니다.

결과 구성 파일의 이름은 <instance_name>.config.xml입니다. 각 결과 ADF의 이름은 <instance_name>.<application_name>.adf.xml입니다.

nscontrol export 명령은 UTF-8 인코딩을 사용하여 파일을 씁니다. 다른 인코딩을 사용하여 구성 및 응용 프로그램 정의 파일을 내보내려면 SQL Server Management Studio에서 내보내기 명령을 사용합니다.

nscontrol export 명령은 원래 구성 및 응용 프로그램 정의 파일을 다시 만들지 않습니다. 대체 가능한 매개 변수를 통해 제공했을 수 있는 값을 비롯하여 현재 인스턴스 및 응용 프로그램 설정이 포함된 파일을 만듭니다. 이러한 이유로 원래 구성 및 응용 프로그램 정의 파일을 유지해야 하며 현재 인스턴스 및 응용 프로그램 설정을 확인해야 할 경우 nscontrol export를 사용하는 것이 좋습니다.

nscontrol export 명령은 내보낸 ADF를 가리키도록 구성 파일의 ApplicationDefinitionFilePath 값을 수정합니다. 이 경로가 수정되어 구성 파일을 즉시 사용할 수 있습니다. BaseDirectoryPath를 포함한 다른 모든 경로 설정은 콘텐츠 포맷터 파일 등 인스턴스에 필요한 다른 파일을 가리킬 수 있으므로 수정되지 않은 상태로 유지됩니다.

사용 권한

nscontrol export를 실행하는 데 사용되는 계정이나 -sqlusername 인수에서 지정하는 SQL Server 로그인은 개별 응용 프로그램 및 인스턴스 데이터베이스에서 NSReader 데이터베이스 역할의 멤버 자격을 통해 데이터베이스 권한을 얻을 수 있습니다. db_owner 데이터베이스 역할과 sysadmin 및 dbcreator 고정 서버 역할의 멤버도 nscontrol export를 실행할 수 있습니다.

또한 이 계정에는 Notification Services 이진 파일을 실행할 수 있는 권한이 있어야 합니다. 이 권한은 Administrators 및 SQLServerNotificationServicesUser Windows 그룹의 멤버에게 부여됩니다.

예

다음 예에서는 메타데이터를 XML 파일로 내보내는 방법을 보여 줍니다.

1. 현재 디렉터리로 파일 내보내기

다음 예에서는 StockInstance 인스턴스에 대한 응용 프로그램 정보 및 인스턴스 정보를 내보내는 방법을 보여 줍니다. nscontrol 유틸리티는 Windows 인증을 사용하여 SQL Server에 연결하고 구성 및 응용 프로그램 정의 파일을 현재 디렉터리에 씁니다. 이 파일이 이미 있을 경우 nscontrol은 오류 메시지를 표시합니다.

nscontrol export -name StockInstance

2. 특정 디렉터리로 파일을 내보내고 기존 파일 덮어쓰기

다음 예에서는 결과 인스턴스 및 응용 프로그램 파일의 디렉터리를 지정하는 방법을 보여 줍니다. 또한 -force 인수를 사용하여 이름이 같은 기존 파일을 덮어쓰는 방법도 보여 줍니다.

nscontrol 유틸리티는 Windows 인증을 사용하여 SQL Server에 연결합니다.

nscontrol export -name StockInstance -out "C:\NS\Export" -force

3. 관리 컴퓨터에서 파일 내보내기

다음 예에서는 인스턴스를 컴퓨터에 등록하지 않은 경우 인스턴스 및 응용 프로그램 정보를 내보내는 방법을 보여 줍니다. –server 인수를 사용하여 SQL Server 인스턴스 이름을 지정해야 합니다. 또한 다음 예에서는 출력 디렉터리를 지정하고 이름이 같은 기존 파일을 덮어쓰도록 지정합니다.

nscontrol 유틸리티는 Windows 인증을 사용하여 SQL Server에 연결합니다.

nscontrol export -name StockInstance -server nsuetest 
    -out "C:\NS\Export" -force

4. SQL Server 인증을 사용하여 파일 내보내기

다음 예에서는 SQL Server 인증을 통해 SQL Server에 연결하여 StockInstance 인스턴스에 대한 정보를 내보내는 방법을 보여 줍니다. C:\NS\Export 디렉터리에 구성 및 응용 프로그램 정의 파일이 생성되지만 이 파일이 이미 있더라도 덮어쓰지 않습니다.

nscontrol export -name StockInstance -out "C:\NS\Export" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

참고 항목

참조

nscontrol 유틸리티

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스	내역
2005년 12월 5일	새로운 내용 SQLServerNotificationServicesUser Windows 그룹에 대한 정보를 추가했습니다.

다음을 통해 공유