nscontrol create 명령

아티클
12/15/2008

업데이트: 2005년 12월 5일

새 Microsoft SQL Server Notification Services 인스턴스를 만듭니다.

구문

nscontrol create 
    [-nologo]
    [-help]
        -in configFile
    [-sqlusername sqlUserName  -sqlpassword sqlPassword]
    [-argumentkey key]
    [param=value ...]

인수

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

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

-inconfigFile
인스턴스를 정의하는 ICF(인스턴스 구성 파일)의 경로와 파일 이름을 지정합니다. 파일이 현재 디렉터리에 있으면 경로가 필요하지 않습니다.

-sqlusernamesqlUserName
SQL Server에 연결하는 데 사용되는 SQL Server 로그인을 지정합니다.

SQL Server 인증을 사용하여 SQL Server에 연결하는 경우 이 인수를 사용하여 로그인 ID를 지정합니다. 이 인수는 -sqlpassword 인수와 함께 사용해야 합니다.

Windows 인증을 사용하여 SQL Server에 연결하는 경우에는 -sqlusername 및 -sqlpassword 인수를 사용하지 마십시오.

[!참고] 가능하면 Windows 인증을 사용합니다.

-sqlpasswordsqlPassword
-sqlusername 로그인 ID와 연관된 암호를 지정합니다. 이 인수는 -sqlusername 인수와 함께 사용해야 합니다.

-argumentkeykey
Notification Services 데이터베이스에 저장되어 있는 배달 채널과 이벤트 공급자 인수를 암호화하는 데 사용되는 키를 지정합니다. 이 키는 최대 2500자로 이루어진 문자열입니다.

이 인수는 구성 파일의 EncryptArguments 값이 true인 경우에 필요합니다. nscontrol create 명령을 실행한 후에는 인스턴스에서 사용하는 키 값을 변경할 수 없습니다. 다른 키를 사용하려면 인스턴스를 삭제한 다음 다시 만들어야 합니다.

또한 nscontrol register 명령과 nscontrol update 명령을 실행할 때 같은 키 값을 지정해야 합니다. nscontrol register 명령은 키 값을 암호화하여 레지스트리에 저장합니다.

param=value
명령 프롬프트에서 ICF로 매개 변수 값을 전달하는 데 사용되는 이름/값 쌍입니다.

ICF에서 백분율 기호(%) 사이에 나타나는 모든 문자열은 대체 가능한 매개 변수입니다. 다음 예의 DBSystem과 같이 대체 가능한 매개 변수가 ICF에 포함된 경우 명령줄이나 ICF의 ParameterDefaults 섹션에 매개 변수 이름과 값을 지정합니다. 예를 들어 구성 파일에 다음 XML이 들어 있다면
```
<SqlServerSystem>%DBSystem%</SqlServerSystem>
```
다음과 같이 nscontrol create를 사용하여 이름과 값을 지정할 수 있습니다.
```
nscontrol create -in config.xml DBSystem=MySQLServer
```
명령 프롬프트에서 제공하는 매개 변수 값은 ICF의 매개 변수에는 적용되지만 ADF(응용 프로그램 정의 파일)의 매개 변수에는 직접 적용되지 않습니다. 매개 변수 값을 ADF에 전달하려면 Parameters 하위 섹션을 ICF의 Application 섹션에 추가합니다. 대체 가능한 매개 변수를 사용하여 명령 프롬프트에서 해당 매개 변수의 값을 제공할 수 있습니다.

명령 프롬프트에서 매개 변수를 지정하는 것 이외에도 ICF에서 %COMPUTERNAME% 같은 환경 변수를 사용할 수 있습니다. ICF에서 환경 변수를 사용하는 경우 같은 이름을 가진 명령 프롬프트 이름/값 쌍이 환경 변수보다 우선적으로 적용됩니다.

주의

nscontrol create 명령은 ICF과 ADF를 XML 스키마와 비교하여 유효성을 검사하고 멀티캐스트 배달 및 다이제스트 배달 모두에 대한 true 값과 같이 잘못된 값이 있는지 확인합니다. 유효성 검사와 확인이 실패하면 nscontrol create는 인스턴스를 만들지 않고 중단합니다.

nscontrol create 명령은 인스턴스와 응용 프로그램 데이터베이스에서 데이터베이스 간 소유권 체인을 설정합니다. Notification Services 저장 프로시저에서 인스턴스 및 응용 프로그램 데이터베이스의 개체에 액세스하도록 허용하려면 해당 데이터베이스에 데이터베이스 간 소유권 체인이 설정되어 있어야 합니다.

Notification Services Standard Edition을 사용 중인데 이 버전에서 하나 이상의 요소가 지원되지 않으면 nscontrol create는 인스턴스를 만들지 않고 중단합니다. Notification Services Standard Edition에 대한 자세한 내용은 Notification Services 버전을 참조하십시오.

Notification Services 클라이언트 구성 요소가 설치되어 있고 인스턴스와 응용 프로그램 메타데이터를 저장할 SQL Server 데이터베이스 엔진에 액세스할 수 있는 모든 컴퓨터에서 nscontrol create를 실행할 수 있습니다.

Notification Services 인스턴스를 실행하려면 먼저 nscontrol register를 사용하여 인스턴스를 등록해야 합니다. 인스턴스를 등록하면 레지스트리 항목이 생성되고 인스턴스를 실행하는 데 사용할 수 있는 Windows 서비스가 선택적으로 생성됩니다.

nscontrol create를 사용하여 인스턴스를 업데이트할 수는 없습니다. 대신 nscontrol update를 사용하십시오.

사용 권한

nscontrol create를 실행하는 데 사용되는 계정이나 -sqlusername 인수에 지정하는 SQL Server 로그인은 sysadmin 고정 서버 역할의 멤버여야 합니다. 또한 이 계정에는 Notification Services 이진 파일을 실행할 수 있는 권한이 있어야 합니다. 이 권한은 Administrators 및 SQLServerNotificationServicesUser Windows 그룹의 멤버에게 부여됩니다.

예

다음 예에서는 Notification Services 인스턴스를 만드는 방법을 보여 줍니다.

1. 기본 예

이 예에서는 ICF InstanceConfig.xml을 사용하여 Notification Services의 새 인스턴스를 만들고 Windows 인증을 사용하여 SQL Server에 연결하는 방법을 보여 줍니다.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml"

2. 구성 파일 매개 변수 값 제공

이 예에서는 ICF의 BaseDirectoryPath, NSHost 및 SqlServer 매개 변수에 값을 전달하는 방법을 보여 줍니다. nscontrol 명령은 Windows 인증을 사용하여 SQL Server에 연결합니다.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    BaseDirectoryPath=C:\NS\Samples\Stock 
    NSHost=nsuetest SqlServer=nsuetest

3. 인수 암호화 키 제공

이 예에서는 인스턴스를 만들 때 인수 암호화 키를 제공하는 방법을 보여 줍니다. 이 키는 인스턴스를 등록할 때 사용하는 키와 일치해야 합니다.

nscontrol 명령은 Windows 인증을 사용하여 SQL Server에 연결합니다.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -argumentkey "MyArgumentKey"

4. SQL Server 인증 사용

이 예에서는 SQL Server 인증을 통해 SQL Server에 연결하여 Notification Services의 새 인스턴스를 만드는 방법을 보여 줍니다.

nscontrol create -in "C:\NS\Stock\InstanceConfig.xml" 
    -sqlusername SqlUser -sqlpassword sQl-P@sWd

참고 항목

참조

nscontrol 유틸리티

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

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

다음을 통해 공유