WSMAN_SHELL_STARTUP_INFO_V10 結構 (wsman.h)

定義要與 WSManCreateShell 函式搭配使用的殼層啟動參數。 結構必須由用戶端配置，並傳遞至 WSManCreateShell 函式。

傳遞至 WSManCreateShell 函式的組態，可能會直接影響在殼層內執行的命令行為。 典型的範例是 workDirectory 自變數，描述與每個進程相關聯的工作目錄，操作系統在使用相對路徑嘗試尋找指定的檔案時，會使用此自變數。

如果沒有數據流命名的特定需求，用戶端和服務應該嘗試針對輸入數據流使用 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的任何值。 如果已啟用，或由IdleTimeout 本機設定所指定的閒置逾時 GPO 設定，則此持續時間具有最大值。 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