Psconfig 명령줄 참조(SharePoint Foundation 2010)

  • 아티클

 

적용 대상: SharePoint Foundation 2010

마지막으로 수정된 항목: 2015-03-09

SharePoint 2010 제품에서는 Psconfig 명령줄 도구를 대체 인터페이스로 사용하여 SharePoint 2010 제품 구성 방법을 제어하는 여러 작업을 수행할 수 있습니다. 이러한 작업을 수행하려면 로컬 컴퓨터에서 Administrators 그룹 구성원이어야 합니다.

이 문서의 내용

  • Psconfig 명령 사용법

  • 사용 가능한 명령 및 매개 변수

Psconfig 명령 사용법

명령 프롬프트에서 Psconfig를 실행할 때는 도구 실행 방법을 제어하는 명령을 지정할 수 있습니다. 명령 프롬프트에서 Psconfig를 실행하려면 %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\bin 폴더로 이동한 후에 다음 구문을 사용하여 명령을 입력합니다.

psconfig.exe -cmd <command> [optional parameters]

다음 섹션의 참조 표에는 여러 예제가 나와 있습니다. 명령줄 인터페이스에서도 도움말이 제공됩니다. 도움말을 보려면 명령 프롬프트에 다음을 입력합니다.

psconfig.exe -?

특정 명령에 대한 도움말을 보려면 다음을 입력합니다.

psconfig.exe -help <command name>

Psconfig의 명령은 특정 순서로 실행해야 합니다. SharePoint 제품 구성 마법사를 사용하여 설치를 구성하는 경우에는 명령(구성 작업)이 자동으로 올바른 순서로 호출됩니다. 그러나 명령줄을 사용하여 Psconfig를 실행하는 경우에는 작업을 올바른 순서로 수행해야 합니다. Psconfig 명령은 다음 순서로 실행해야 합니다.

  1. configdb

  2. helpcollections

  3. secureresources

  4. services

  5. installfeatures

  6. adminvs

  7. evalprovision (독립 실행형 설치에만 해당됨)

  8. applicationcontent

  9. upgrade

중요

Psconfig를 실행한 결과 서버 팜을 업그레이드해야 하는 것으로 확인되면 업그레이드 명령을 선택하지 않았더라도 Psconfig 실행 시 업그레이드가 자동으로 시작됩니다.

단일 명령줄 문자열에서 모든 명령이 실행되도록 지정할 수 있습니다. 이렇게 하면 Psconfig가 모든 명령을 올바른 순서로 실행합니다. 예를 들어 명령 프롬프트에서 다음과 같은 명령을 실행할 수 있습니다.

psconfig.exe -cmd configdb <parameters>
-cmd helpcollections <parameters>
-cmd secureresources <parameters>
-cmd services <parameters>
-cmd installfeatures <parameters>
-cmd adminvs <parameters>
-cmd evalprovision <parameters>
-cmd applicationcontent <parameters>

명령줄에서 서버 또는 서버 팜을 구성하는 방법에 대한 자세한 내용은 Microsoft SharePoint Foundation 2010 TechCenter를 참조하십시오.

사용 가능한 명령 및 매개 변수

SharePoint 제품 구성 마법사에서 인식되는 명령줄 옵션은 다음과 같습니다.

명령 설명, 매개 변수 및 예제

?

Psconfig에 사용할 수 있는 명령을 표시합니다.

예제

psconfig.exe -?

help <command name>

Psconfig에 사용할 수 있는 명령을 표시합니다. 명령 이름을 지정하는 경우에는 해당 명령의 도움말을 표시합니다.

예제

psconfig.exe -help adminvs

adminvs

로컬 컴퓨터에서 SharePoint 중앙 관리 웹 응용 프로그램을 관리합니다. 다음과 같은 선택적 매개 변수를 사용합니다.

[-provision]

해당 서버에서 SharePoint 중앙 관리 웹 응용 프로그램을 구축합니다. 구축을 수행하면 서버 팜 관리자 계정으로 실행되는 새 SharePoint 중앙 관리 응용 프로그램과 응용 프로그램 풀이 만들어집니다.

[-unprovision]

해당 서버에서 SharePoint 중앙 관리 웹 응용 프로그램 구축을 취소합니다. 구축을 취소하면 SharePoint 중앙 관리 웹 응용 프로그램 및 해당 응용 프로그램 풀이 제거됩니다.

[-port <port number>]

SharePoint 중앙 관리 웹 응용 프로그램 포트는 서버 팜에 대한 전역 설정입니다. 포트를 변경할 때는 SharePoint Timer Service 작업이 디스패치되어 서버 팜의 모든 SharePoint 중앙 관리 웹 응용 프로그램에 대해 포트를 동기화합니다. 포트를 지정하지 않으면 서버 팜의 기존 SharePoint 중앙 관리 웹 응용 프로그램에 사용되는 포트가 사용됩니다. SharePoint 중앙 관리 웹 응용 프로그램을 서버 팜에서 구축하지 않은 경우, 포트가 지정되어 있지 않으면 기본 포트가 임의로 선택됩니다.

[-windowsauthprovider <enablekerberos | onlyusentlm>]

SharePoint 중앙 관리 웹 응용 프로그램 인증 공급자는 서버 팜에 대한 전역 설정입니다. 인증 공급자를 변경할 때는 SharePoint Timer Service 작업이 디스패치되어 서버 팜의 모든 SharePoint 중앙 관리 웹 응용 프로그램에 대해 공급자를 동기화합니다. onlyusentlm을 지정하는 경우에는 모든 SharePoint 중앙 관리 웹 응용 프로그램에 대해 NTLM이 단독 인증 공급자로 사용됩니다. 다른 모든 인증 공급자는 사용하지 않도록 설정되며, NTLM만 인증 공급자로 허용됩니다. enablekerberos를 지정하는 경우에는 모든 SharePoint 중앙 관리 웹 응용 프로그램에 대해 Kerberos 인증이 사용하도록 설정됩니다. 인증 공급자를 지정하지 않으면 서버 팜의 기존 SharePoint 중앙 관리 웹 응용 프로그램에 사용되는 공급자가 사용됩니다. SharePoint 중앙 관리 웹 응용 프로그램을 서버 팜에서 구축하지 않은 경우, 인증 공급자가 지정되어 있지 않으면 Kerberos 인증 공급자가 사용하도록 설정됩니다.

예제

psconfig.exe -cmd adminvs -provision -port 8080 -windowsauthprovider onlyusentlm

psconfig.exe -cmd adminvs -unprovision

applicationcontent

관리되는 응용 프로그램 콘텐츠를 관리합니다. 다음과 같은 필수 매개 변수를 사용합니다.

-install

공유 응용 프로그램 데이터(예: 리소스 파일, 웹 응용 프로그램 바이너리)를 기존 웹 응용 프로그램 가상 디렉터리에 복사합니다.

예제

psconfig.exe -cmd applicationcontent -install

configdb

서버 팜에서 해당 서버를 만들거나 연결하거나 연결을 끊습니다. 다음과 같은 선택적 매개 변수를 사용합니다.

[-create]

새 구성 데이터베이스를 만들어 새 서버 팜을 설정합니다. 해당 서버가 이미 구성 데이터베이스에 연결되어 있는 경우에는 먼저 서버 연결을 끊은 후에 새 구성 데이터베이스를 만듭니다.

[-disconnect]

구성 데이터베이스에서 해당 서버의 연결을 끊어 서버 팜에서 서버 연결을 끊습니다.

[-connect]

기존 구성 데이터베이스에 연결하여 해당 서버를 기존 서버 팜에 연결합니다. 해당 서버가 이미 구성 데이터베이스에 연결되어 있는 경우에는 먼저 서버 연결을 끊은 후에 기존 구성 데이터베이스에 연결합니다.

[-server <SQLServerName>]

구성 데이터베이스가 있는 Microsoft SQL Server를 실행 중인 컴퓨터입니다.

[-database <SQLDatabaseName>]

구성 데이터베이스 이름입니다.

[-dbuser <value>]

SQL 인증에 사용되는 사용자 이름입니다.

[-dbpassword <value>]

SQL 인증에 사용되는 암호입니다.

[-user <Domain\User>]

서버 팜 관리자의 사용자 계정입니다.

[-password <Password>]

서버 팜 관리자의 사용자 계정 암호입니다.

[-addomain <value>]

서버 팜에 사용되는 Active Directory 도메인 이름입니다.

[-adorgunit <value>]

서버 팜에 사용되는 Active Directory 조직 구성 단위 이름입니다.

[-admincontentdatabase <SQLAdminContentDatabaseName>]

중앙 관리 웹 응용 프로그램 콘텐츠 데이터베이스 이름입니다.

예제

psconfig.exe -cmd configdb -create -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

-user <DOMAIN\username> -password <password>

-addomain <domain_name> -adorgunit <org_unit>

-admincontentdatabase <Database_name>

psconfig.exe -cmd configdb -disconnect

psconfig.exe -cmd configdb -connect -server <Server_name> -database <Database_name>

-dbuser <DOMAIN\username> -dbpassword <password>

evalprovision

해당 서버를 독립 실행형(평가 모드) 서버로 구축합니다. 다음과 같은 필수/선택적 매개 변수를 사용합니다.

-provision

해당 서버에서 독립 실행형 모드 프로비저닝을 수행합니다.

[-port <port number>]

기본 SharePoint 웹 응용 프로그램에 할당된 포트 번호입니다. 지정하지 않는 경우 포트 80이 사용됩니다. SharePoint 웹 응용 프로그램이 이미 있으며 해당 포트를 사용 중인 경우에는 기존 사이트를 덮어씁니다. SharePoint 웹 응용 프로그램이 아닌 기존 사이트에서 포트를 사용 중이면 해당 사이트가 사용하지 않도록 설정되며, 해당 포트를 사용하는 새 SharePoint 웹 응용 프로그램이 만들어집니다.

[-overwrite]

설치 중에 기존 Microsoft SharePoint Foundation 2010 웹 사이트를 덮어쓸지 여부를 지정합니다. 지정하지 않는 경우 사이트가 삭제되지 않습니다.

예제

psconfig.exe -cmd evalprovision -provision -port 1100

helpcollections

도움말 모음을 관리합니다. 다음과 같은 필수 매개 변수를 사용합니다.

-installall

사용 가능한 모든 도움말 모음을 설치합니다.

예제

psconfig.exe -cmd helpcollections -installall

installfeatures

해당 서버의 파일 시스템에 있는 SharePoint 제품 및 기술 기능을 서버 팜에 등록합니다.

예제

psconfig.exe -cmd installfeatures

quiet

SharePoint 제품 구성 마법사를 자동 모드로 실행합니다. 출력은 PSCONFIG.EXE_MM_DD_YY_HH_MM_SS_MS.log에 기록되며, 여기서 "_MM_DD_YY_HH_MM_SS_MS"는 유틸리티를 실행한 전체 날짜 및 시간입니다. 로그 파일은 %COMMONPROGRAMFILES%\Microsoft Shared\web server extensions\14\LOGS 디렉터리에 저장됩니다.

예제

psconfig.exe -cmd quiet

secureresources

서버에서 SharePoint 2010 제품 리소스 보안 적용을 수행합니다. 예를 들어 파일, 폴더 및 레지스트리 키에 보안을 적용합니다.

예제

psconfig.exe -cmd secureresources

services

SharePoint 2010 제품 서비스를 관리합니다. 다음과 같은 선택적 매개 변수를 사용합니다.

[-install]

서버 팜에서 해당 서버에 있는 서비스를 등록합니다.

[-provision]

해당 서버에 있는 서비스를 구축하고, SharePoint 2010 제품가 독립 실행형 모드로 설치된 경우 서비스를 온라인으로 설정합니다. 서비스는 프로비저닝하는 동시에 등록됩니다.

참고

[-provision] 매개 변수는 단일 서버의 독립 실행형 설치에 대해서만 지원됩니다. 팜 설치 시에는 이 매개 변수를 사용하지 마십시오.

예제

psconfig.exe -cmd services -install

psconfig.exe -cmd services -provision

setup

설치 모드를 기반으로 SharePoint 2010 제품 구성을 수행하며, 구성 복구도 수행합니다. 제품이 독립 실행형 모드로 설치된 경우에는 독립 실행형 구성이 완료된 것입니다. 제품이 독립 실행형 모드가 아닌 경우에는 Psconfig 명령줄 도구 대신 SharePoint 제품 구성 마법사를 사용하여 초기 구성을 완료해야 합니다. 마법사를 실행하려면 시작 메뉴에서 모든 프로그램, 관리 도구를 차례로 가리키고 SharePoint 제품 구성 마법사를 클릭합니다.

독립 실행형 설치를 복구하려면 먼저 setup /repair 를 실행하고(자세한 내용은 설치 도움말 시스템 참조), 다음으로 psconfig.exe -setup을 실행합니다. 서버 팜 설치의 경우에는 setup /repair를 실행한 후에 Psconfig 명령줄 도구 대신 SharePoint 제품 구성 마법사를 사용합니다.

다음과 같은 선택적 매개 변수를 사용합니다.

[-lcid <1033>]

설치 언어를 지정하는 LCID(로캘 ID)입니다.

예제

psconfig.exe -cmd setup

standaloneconfig

SharePoint 제품 및 기술의 독립 실행형 구성을 수행합니다. 다음과 같은 선택적 매개 변수를 사용합니다.

[-lcid <1033>]

설치 언어를 지정하는 LCID(로캘 ID)입니다.

예제

psconfig.exe -cmd standaloneconfig

upgrade

SharePoint 2010 제품 업그레이드를 수행합니다. 제품을 업그레이드해야 하는 경우 SharePoint 제품 구성 마법사를 실행하면 이 명령이 자동으로 실행됩니다. 다음과 같은 선택적 매개 변수를 사용합니다.

[-wait]

지정하는 경우 업그레이드가 완료될 때까지 SharePoint 제품 구성 마법사로 돌아오지 않습니다. 지정하지 않는 경우에는 업그레이드를 수행하기 위한 SharePoint Timer Service 작업을 디스패치한 후에 마법사로 돌아옵니다. 업그레이드 작업 상태를 확인하려면 웹 브라우저를 통해 SharePoint 중앙 관리 웹 사이트에 액세스할 수 있습니다.

[-force]

지정하는 경우 SharePoint 제품 구성 마법사에서 현재 실행 중인 업그레이드 작업을 중지하고 업그레이드를 다시 시작합니다.

[-reghostonupgrade]

지정하는 경우 SharePoint 제품 구성 마법사에서 업그레이드 중에 모든 콘텐츠를 사이트 정의 버전으로 다시 설정합니다.

[-inplace <v2v|b2b>]

지정하는 경우 SharePoint 제품 구성 마법사에서 전체 업그레이드를 수행합니다. v2v를 지정하면 전체 버전 간 업그레이드가 수행되고, b2b를 지정하면 전체 빌드 간 업그레이드가 수행됩니다.

[-preserveolduserexperience]

false로 설정하는 경우 SharePoint 제품 구성 마법사에서 최신 SharePoint 사용자 환경을 사용하도록 사이트를 업데이트합니다. 이 매개 변수를 지정하지 않으면 기본값인 true가 사용됩니다.

[-passphrase]

서버 팜에 연결하는 데 사용되는 암호입니다. 암호 값이 팜의 모든 서버에 대해 동일해야 팜이 제대로 작동합니다.

예제

psconfig.exe -cmd upgrade -inplace v2v -wait