 | 참고 |
Servermanagercmd.exe는 사용되지 않으며 다음 릴리스의 Windows에서 지원되지 않을 수도 있습니다. 서버 관리자에 사용할 수 있는 Windows PowerShell cmdlet을 사용하는 것이 좋습니다. |
서버 관리자 명령인 ServerManagerCmd.exe를 사용하면 작업에 대한 출력이 생성되고 화면에 출력이 강조 표시됩니다. 또한 서버 관리자를 사용하면 텍스트 전용 로그 파일에 매우 상세한 출력이 기록됩니다. 명령줄 작업 결과가 XML 기반 결과 파일에 기록되도록 서버 관리자를 구성할 수도 있습니다.
이 섹션에서는 서버 관리자 명령 출력 파일에 있는 코드 및 메시지를 식별하고 설명합니다.
서버 관리자 명령줄 작업 결과
서버 관리자를 사용하면 기본적으로 텍스트 전용 로그 파일인 로그 이름.txt에 명령 출력이 기록됩니다(%windir%\logs\ServerManager.log).
| 참고 |
|
이 로그에는 서버 관리자 명령 작업에 대한 출력이 저장되지만 해당 출력은 매우 상세하며 사용자에게 친숙한 형식이 아닙니다. 이 로그 파일은 서버 관리자 작업에 대해 Microsoft 기술 지원 서비스에 문의해야 할 경우에 유용합니다. |
서버 관리자 명령줄 도구인 ServerManagerCmd.exe에 -logPath 매개 변수를 추가하여 로그 파일의 기본 이름과 위치를 변경할 수 있습니다. -logPath 매개 변수 및 ServerManagerCmd.exe 구문에 대한 자세한 내용은 서버 관리자 명령 개요를 참조하십시오.
서버 관리자를 사용함으로써 기본적으로 만들어지는 텍스트 전용 로그 파일 외에도 사용자가 이름과 위치를 지정한 XML 파일에 작업 결과가 저장되도록 서버 관리자를 구성할 수 있습니다. XML 결과 파일의 이름과 위치를 지정하는 매개 변수는 -resultPath입니다.
서버 관리자 명령과 함께 응답 파일을 사용하여 제거할 역할 또는 기능의 목록을 지정하든 명령줄에서 단일 항목을 직접 설치 또는 제거하든, -logPath 및 -resultPath 매개 변수는 명령 프롬프트에서 사용해야 합니다. 서버 관리자 명령줄 응답 파일에 대한 자세한 내용은 서버 관리자 명령에 대한 응답 파일 만들기를 참조하십시오.
예
다음 예에서는 서버 관리자 명령에서 XML 결과 파일의 이름과 경로를 지정하는 방법을 보여줍니다.
응답 파일을 사용하여 명령에서 결과 파일을 지정하는 예
ServerManagerCmd.exe -inputPath C:\CmdLine\Remove_roles.xml -resultPath C:\CmdLine\010107.xml
앞의 예에서 관리자는 Remove_roles.xml이라는 응답 파일을 만들었으며, 여기에는 서버에서 여러 역할을 제거하는 명령이 포함되어 있습니다. 관리자는 C:\CmdLine\010107.xml과 같이 결과 파일의 이름과 위치를 지정했습니다.
응답 파일을 사용하지 않고 명령에서 결과 파일을 지정하는 예
ServerManagerCmd.exe -install npas -allSubFeatures -r C:\CmdLine\Results\010107.xml -restart
앞의 예에서 관리자는 네트워크 정책 및 액세스 서비스를 설치하도록 서버 관리자를 구성했습니다. 역할에 대한 명령 이름 npas는 대/소문자를 구분하지 않습니다.
이 예에서는 -allSubFeatures 매개 변수를 사용하여 요청한 대로 네트워크 정책 및 액세스 서비스의 모든 역할 서비스가 설치됩니다. 관리자는 -resultPath 매개 변수의 약식인 -r을 사용하여 결과 파일의 이름과 경로를 지정합니다. 마지막으로, 관리자는 -restart 매개 변수를 사용하여 네트워크 정책 및 액세스 서비스 역할 설치가 완료되면 필요에 따라 컴퓨터를 다시 시작하도록 서버 관리자를 구성합니다.
출력 메시지 설명
이 섹션에서는 서버 관리자에서 XML 기반 결과 파일에 반환하는 출력 및 결과를 설명합니다.
출력 메시지
다음 표에서는 서버 관리자 명령을 사용함으로써 콘솔 창 및 결과 파일에 기록되는 메시지를 식별하고 설명합니다.
| 메시지 | 종료 코드 | 텍스트 문자열 | 참고 |
|---|---|---|---|
|
성공. 다시 시작할 필요가 없습니다. |
0 |
성공: 설치했습니다. 성공: 제거했습니다. |
사용자가 명령에서 역할이나 기능을 지정했는지 여부에 따라 두 개의 메시지가 약간 달라질 수 있습니다. |
|
성공. 다시 시작해야 합니다. |
3010 |
성공: 설치했습니다. 다시 시작해야 합니다. 성공: 제거했습니다. 다시 시작해야 합니다. |
이 코드는 다시 시작해야 할 경우에 반환됩니다. 컴퓨터를 다시 시작한 후 Windows Server 2008 R2 사용자 인터페이스에서 서버 관리자를 실행하여 역할 또는 기능에 필요한 구성을 완료해야 할 수 있습니다. |
|
인수가 올바르지 않습니다. |
4 |
ArgumentNotValid: {argument} 인수가 올바르지 않습니다. ArgumentNotValid: 응답 파일 경로가 없습니다. ArgumentNotValid: 로그 파일 경로가 없습니다. ArgumentNotValid: '{name}' 기능이 유효하지 않습니다. 기능의 이름을 찾을 수 없습니다. ArgumentNotValid: '{name}' 역할이 올바르지 않습니다. 역할의 이름을 찾을 수 없습니다. ArgumentNotValid: 입력 경로에 이미 {name}이(가) 지정되었습니다. ArgumentNotValid: 입력 경로에 이미 {setting} 설정이 지정되었습니다. ArgumentNotValid: 잘못된 기능입니다. '{name}'은(는) 역할입니다. ArgumentNotValid: 잘못된 기능입니다. '{name}'은(는) 역할 서비스입니다. ArgumentNotValid: 잘못된 역할입니다. '{name}'은(는) 기능입니다. ArgumentNotValid: 잘못된 역할입니다. '{name}'은(는) 역할 서비스에 대한 이름입니다. ArgumentNotValid: 역할 서비스가 잘못되었습니다. '{name}'은(는) 기능입니다. ArgumentNotValid: 역할 서비스가 잘못되었습니다. '{name}'은(는) 역할입니다. |
사용자가 서버 관리자 명령줄에서 없는 인수를 지정하거나 지정한 인수의 필수 부분을 누락한 경우에 발생합니다. 주의해야 하는 인수에 따라 여러 가지 메시지가 표시됩니다. {argument}은(는) 잘못 지정된 인수를 나타냅니다. {name}은(는) 잘못 지정된 역할, 역할 서비스 또는 기능의 이름을 나타냅니다. {setting}은(는) 역할, 역할 서비스 또는 기능의 설정에 대해 잘못 지정되거나 중복된 참조의 이름을 나타냅니다. |
|
입력 파일을 열거나 읽는 동안 오류가 발생했습니다. |
110 |
ReadError: {0} 응답 파일이 없습니다. ReadError: {0} 응답 파일을 읽지 못했습니다. ReadError: {0} 응답 파일을 로드하지 못했습니다. {1} |
서버 관리자 명령줄 인터페이스에서 사용자가 제공한 응답 파일을 읽거나 찾을 수 없는 경우에 발생합니다. 응답 파일을 로드할 수 없는 특정 이유에 따라 동일한 오류 코드(110)에 대해 여러 가지 메시지가 표시됩니다. {0}은(는) 지정된 경로와 이름을 나타냅니다. {1}은(는) 서버 관리자에서 찾은 예외를 나타냅니다. 이 오류 메시지가 발생한 경우 XML 응답 파일의 이름과 경로를 제대로 입력했는지 확인하고, 응답 파일을 서버 관리자 응답 파일 스키마와 비교하여 유효성을 검사하고, 응답 파일이 올바른 요소 구조를 사용하는지 확인하여 문제를 해결하는 것이 좋습니다. 서버 관리자 명령 응답 파일의 올바른 설정 및 모양에 대한 자세한 내용은 서버 관리자 명령에 대한 응답 파일 만들기를 참조하십시오. |
|
권한이나 자격 증명 부족 |
5 |
오류: 서버 관리자는 로컬 컴퓨터의 기본 제공 Administrators 그룹 구성원만 실행할 수 있습니다. 상승된 권한으로만 역할 및 기능을 설치하고 제거할 수 있습니다. |
이 오류는 제공된 사용자 자격 증명에 서버에 대한 로컬 관리 권한이 없을 경우 또는 사용자가 관리자 권한으로 명령 프롬프트 창을 열지 않았을 경우에 발생합니다. 이 작업을 수행하려면 명령 프롬프트 실행 파일이나 시작 메뉴의 명령 프롬프트를 마우스 오른쪽 단추로 클릭한 다음 관리자 권한으로 실행을 클릭합니다. |
|
변경할 필요 없음 |
1003 |
NoChange: 응답 파일에 지정된 역할과 기능은 이미 설치되었거나 로컬 컴퓨터에서 이미 제거되었기 때문에 변경 내용이 없습니다. |
응답 파일에서 설치하도록 지정한 역할, 역할 서비스 또는 기능이 컴퓨터에 이미 설치된 경우 또는 응답 파일에서 제거하도록 요청하지만 서버 관리자에서 해당 역할, 역할 서비스 또는 기능이 컴퓨터에 없거나 이미 제거되었음을 인식한 경우에 발생합니다. 즉, 이 메시지는 명령에서 지정한 작업이 null 작업이 되는 경우에 발생합니다. |
|
서버 관리자 마법사의 인스턴스가 이 컴퓨터에서 이미 실행되고 있습니다. |
1004 |
오류: 다른 사용자가 서버 관리자 사용자 인터페이스에서 마법사를 실행하고 있습니다. |
역할 추가, 기능 추가, 역할 서비스 추가, 역할 제거, 기능 제거, 역할 서비스 제거 등의 서버 관리자 마법사 중 하나가 이미 실행되고 있는 경우 서버 관리자 명령줄을 실행하여 역할, 역할 서비스 또는 기능을 설치하거나 제거하려고 하면 실패합니다. 서버 관리자에서는 한 번에 하나의 도구만 실행하여 서버에 설치된 소프트웨어 패키지의 변경 내용이 충돌하는 것을 방지합니다. 한 번에 하나의 명령줄 도구 또는 하나의 서버 관리자 마법사만 실행할 수 있으며 동시에 둘 다 실행할 수 없습니다. |
|
설치된 역할 또는 기능을 수집하거나 사용자가 지정한 항목을 설치 또는 제거하는 동안 오류가 발생했습니다. |
1000 |
오류: 하나 이상의 역할, 역할 서비스 또는 기능을 설치하지 못했습니다. 서버 관리자 로그에서 자세한 정보를 확인하고 다시 시도하십시오. 오류: 하나 이상의 역할, 역할 서비스 또는 기능을 제거하지 못했습니다. 서버 관리자 로그에서 자세한 정보를 확인하고 다시 시도하십시오. |
사용자가 명령에서 역할이나 기능을 지정했는지 여부에 따라 두 개의 메시지가 약간 달라질 수 있습니다. |
|
컴퓨터에 대한 변경 내용을 취소하기 위해 컴퓨터를 다시 시작해야 한다는 점을 제외하고 오류 1000과 같습니다. |
1001 |
오류: 하나 이상의 역할, 역할 서비스 또는 기능을 설치하지 못했습니다. 컴퓨터에 수행한 변경 내용을 실행 취소하려면 다시 시작해야 합니다. 서버 관리자 로그에서 자세한 정보를 확인하고 다시 시도하십시오. 오류: 하나 이상의 역할, 역할 서비스 또는 기능을 제거하지 못했습니다. 컴퓨터에 수행한 변경 내용을 실행 취소하려면 다시 시작해야 합니다. 서버 관리자 로그에서 자세한 정보를 확인하고 다시 시도하십시오. 오류: 다른 설치 또는 제거를 완료하기 위해 컴퓨터를 다시 시작해야 하기 때문에 역할, 역할 서비스 또는 기능을 설치하지 못했습니다. 컴퓨터를 다시 시작한 후 역할, 역할 서비스 또는 기능을 다시 설치해 보십시오. 오류: 다른 설치 또는 제거를 완료하기 위해 컴퓨터를 다시 시작해야 하기 때문에 역할, 역할 서비스 또는 기능을 제거하지 못했습니다. 컴퓨터를 다시 시작한 후 역할, 역할 서비스 또는 기능을 다시 제거해 보십시오. |
사용자가 명령에서 역할이나 기능을 지정했는지 여부에 따라 메시지가 약간 달라질 수 있습니다. |
|
일반 오류 |
1002 |
오류: 일반 오류입니다. {0} |
사용할 수 있는 문제 해결 정보가 없는 일반 오류입니다. 이 오류가 발생한 경우 명령 구문을 확인하고, 로컬 컴퓨터에 Administrators 그룹 구성원으로 로그온했는지 확인한 다음 명령을 다시 시도하는 것이 좋습니다. {0}은(는) 서버 관리자에서 찾은 예외를 나타냅니다. |
XML 결과 파일
다음은 서버 관리자 명령줄 도구에 -resultPath 또는 -r 매개 변수를 추가하고, 매개 변수에 경로와 이름을 지정한 경우 서버 관리자에서 만들어진 XML 결과 파일의 예입니다.
< ServerManagerConfigurationResult Action="Install" Time="2006-11-29T14:26:39" Language="en-US" Success="true" RequiresReboot="false" xmlns="https://schemas.microsoft.com/sdm/Windows/ServerManager/Configuration/2007/1"> <Message Level="Information">Start Installing...</Message> <Role DisplayName="DHCP Server" Id="DHCP" Success="true" RequiresReboot="false" RequestedBy="UserSpecified"> <Message Level="Information">Succeeded: [DHCP Server] </Message> </Role> <Message Level="Information">Install succeeded.</Message> </ServerManagerConfigurationResult>
다음 표에서는 결과 파일에 있는 요소를 식별하고 설명합니다.
| 요소 또는 특성 | 설명 |
|---|---|
|
ServerManagerCommandLineResult |
제목 요소로, 전체 파일의 컨테이너입니다. |
|
Action |
표시된 결과가 설치 작업에 대한 것인지 또는 제거 작업에 대한 것인지 나타냅니다. |
|
Time |
작업이 완료된 날짜와 시간을 표시합니다. |
|
Language |
결과에 포함되어 있는 지역화된 메시지의 언어 코드를 표시합니다. 이 예에서는 영어-미국입니다. |
|
Success |
명령줄에 지정된 모든 역할, 역할 서비스 및 기능에 대한 작업을 완료한 경우 "true" 값을 표시하고 하나 이상의 역할, 역할 서비스 또는 기능에 대한 작업이 실패한 경우 "false"를 표시합니다. |
|
RequiresReboot |
설치 또는 제거 작업이 완료되어 컴퓨터를 다시 시작해야 할 경우 "true" 값을 표시하고 다시 시작할 필요가 없을 경우 "false"를 표시합니다. |
|
Xmlns |
이 특성은 서버 관리자 명령줄 XML 스키마 정의를 참조합니다. |
|
Message |
모든 정보 메시지, 경고 메시지 및 오류 메시지는 XML 파일의 본문에 포함됩니다. 전체 작업에 대한 일반 메시지는 최상위에 있습니다. 그러나 메시지가 특정 역할, 역할 서비스 또는 기능에 적용되는 경우 메시지는 해당 항목의 특정 요소 안에 포함됩니다. 메시지는 Language 특성에서 지정한 언어로 지역화됩니다.
|
|
Role, Role Service 또는 Feature |
서버 관리자 명령줄 응답 파일에서 설치 또는 제거하도록 요청하는 개체에 따라 Role, Role Service 또는 Feature 요소는 결과 파일에서 여러 번 나타날 수 있습니다.
|