WSMAN_SHELL_STARTUP_INFO_V10 구조체(wsman.h)

WSManCreateShell 함수와 함께 사용할 셸 시작 매개 변수를 정의합니다. 구조체는 클라이언트에 의해 할당되고 WSManCreateShell 함수에 전달되어야 합니다.

WSManCreateShell 함수에 전달된 구성은 셸 내에서 실행되는 명령의 동작에 직접 영향을 줄 수 있습니다. 일반적인 예는 각 프로세스와 연결된 작업 디렉터리를 설명하는 workingDirectory 인수이며, 운영 체제는 상대 경로를 사용하여 지정된 파일을 찾으려고 할 때 사용합니다.

스트림 명명에 대한 특정 요구 사항이 없는 경우 클라이언트와 서비스는 입력 스트림에 STDIN, 기본 출력 스트림의 경우 STDOUT 및 오류 또는 출력 스트림 상태 STDERR을 사용해야 합니다.

구문

typedef struct _WSMAN_SHELL_STARTUP_INFO_V10 {
  WSMAN_STREAM_ID_SET            *inputStreamSet;
  WSMAN_STREAM_ID_SET            *outputStreamSet;
  DWORD                          idleTimeoutMs;
  PCWSTR                         workingDirectory;
  WSMAN_ENVIRONMENT_VARIABLE_SET *variableSet;
} WSMAN_SHELL_STARTUP_INFO_V10;

멤버

inputStreamSet

셸에 대한 입력 스트림 집합을 지정하는 WSMAN_STREAM_ID_SET 구조체에 대한 포인터입니다. 필터에 없는 스트림은 셸 구현에서 무시할 수 있습니다. Windows Cmd.exe 셸의 경우 이 값은 L"stdin"이어야 합니다. 값이 NULL이면 구현에서는 L"stdin"이 있는 배열을 기본값으로 사용합니다.

outputStreamSet

셸의 출력 스트림 집합을 지정하는 WSMAN_STREAM_ID_SET 구조체에 대한 포인터입니다. 필터에 없는 스트림은 셸 구현에서 무시할 수 있습니다. Windows cmd.exe 셸의 경우 이 값은 L"stdout stderr"이어야 합니다. 값이 NULL이면 구현에서는 L"stdout" 및 L"stderr"가 있는 배열을 기본값으로 사용합니다.

idleTimeoutMs

클라이언트 요청 없이 셸이 열린 상태로 유지되는 최대 기간(밀리초)을 지정합니다. 최대 기간을 초과하면 셸이 자동으로 삭제됩니다. 0에서 0xFFFFFFFF 모든 값을 설정할 수 있습니다. 이 기간은 유휴 시간 제한 GPO 설정(사용하도록 설정된 경우) 또는 IdleTimeout 로컬 구성으로 지정된 최대값을 가 줍니다. GPO/로컬 구성에서 최대 기간의 기본값은 15분입니다. 그러나 시스템 관리자는 이 값을 변경할 수 있습니다. GPO/로컬 구성의 최대값을 사용하려면 클라이언트가 이 필드에 0을 지정해야 합니다. 0에서 0xFFFFFFFF 사이의 명시적 값을 사용하는 경우 명시적 API 값과 GPO/로컬 구성의 값 사이의 최소값이 사용됩니다.

workingDirectory

셸의 시작 디렉터리를 지정합니다. 모든 실행 명령과 함께 사용됩니다. 이 멤버가 NULL 값인 경우 명령을 실행할 때 원격 컴퓨터에서 기본 디렉터리를 사용합니다. 빈 값은 기본 프로토콜에서 생략된 값으로 처리됩니다.

variableSet

셸의 시작 환경을 설명하는 변수 이름 및 값 쌍의 배열을 지정하는 WSMAN_ENVIRONMENT_VARIABLE_SET 구조체에 대한 포인터입니다. 이러한 요소의 콘텐츠는 셸별로 지정되며 다른 환경 변수의 관점에서 정의할 수 있습니다. NULL 값이 전달되면 서버 쪽에서 기본 환경이 사용됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7
지원되는 최소 서버	Windows Server 2008 R2
머리글	wsman.h
재배포 가능 파일	WINDOWS Server 2008 SP2, Windows Vista SP1 및 Windows Vista SP2의 Windows Management Framework