設定殼層啟動程式

發行項
03/11/2025
適用於:

✅ Windows 11, ✅ Windows 10

有兩種方式可以設定Shell Launcher：

使用指ShellLauncher派存取權設定服務提供者的節點 (CSP) ，如果裝置支援，這也會在裝置上自動啟用Shell Launcher
直接在應用程式中使用 Shell Launcher WMI 提供者 。使用此方法時，您必須先啟用Shell Launcher

您可以為 Shell Launcher 設定下列選項：

新增/移除特定使用者或群組的殼層組態
變更預設殼層設定
取得特定使用者或群組的殼層設定相關信息

注意

在使用者登入之前，任何變更不會生效。

啟用殼層啟動器

Shell Launcher 是 Windows 中預設未啟用的選擇性元件。若要進行設定，您必須先加以啟用。您可以在自定義的 Windows 映射中啟用和設定 Shell Launcher，也可以在套用布建套件進行設定之前加以啟用。

注意

當您使用指派的存取權設定服務提供者 (CSP) 設定 Shell Launcher 時，如果裝置支援，則會自動啟用 Shell Launcher。當您使用受指派的存取 CSP 進行設定時，不需要個別啟用 Shell Launcher。

有多種方式可以啟用 Shell Launcher，請選取最符合您需要的方法以深入瞭解。

若要使用控制台啟用殼層啟動器，請遵循下列步驟：

開啟控制台>Programs>開啟或關閉 Windows 功能或使用命令optionalfeatures.exe
展開 [裝置鎖定 ]，然後選取 [殼層啟動器]
選取 [確定 ] 以啟用殼層啟動器

若要使用 PowerShell 啟用 Shell Launcher，請遵循下列步驟：

以系統管理員許可權開啟 PowerShell 視窗

執行下列命令：

Enable-WindowsOptionalFeature -FeatureName Client-DeviceLockdown,Client-EmbeddedShellLauncher -Online

下列範例使用稱為的 install.wimWindows 映像，但您可以使用相同的程式來套用布建套件。

以系統管理員許可權開啟命令提示字元。
在下列步驟中，將 install.wim 複製到硬碟 (上的暫存資料夾，我們假設它稱為 C:\wim)
變更下列文稿以符合您的環境：

@echo off
REM Create a new directory
md c:\wim

REM Mount the image
dism /mount-wim /wimfile:c:\bootmedia\sources\install.wim /index:1 /MountDir:c:\wim

REM Enable the feature
dism /image:c:\wim /enable-feature /all /featureName:Client-EmbeddedShellLauncher

REM Commit the change
dism /unmount-wim /MountDir:c:\wim /Commit

如需 DISM 的詳細資訊，請參閱什麼是部署映像服務和管理。

針對不同的用戶帳戶啟動不同的殼層

根據預設，Shell Launcher 會執行預設殼層，這是當您在設計時間建立 OS 映射時所指定。默認殼層會設定為 Windows 命令處理器 (Cmd.exe) ，但您可以將任何可執行檔指定為預設殼層。

如果您不想執行預設殼層，您也可以設定 Shell Launcher 為特定使用者或群組啟動不同的殼層。例如，您可以將裝置設定為啟動客體帳戶的自定義應用程式殼層，但針對系統管理員帳戶執行標準 Windows 檔案總管殼層來維護裝置。

當目前登入的帳戶屬於針對每個群組定義了不同組態的兩個或多個群組時，Shell Launcher 會使用它找到的第一個組態。搜尋順序未定義，因此建議您避免將使用者指派給具有不同 Shell Launcher 設定的多個群組。

注意

如果您在運行時間使用 WMI 提供者為使用者或群組設定 Shell Launcher，則必須針對該安全性主體使用安全標識碼 (SID) 。您無法使用使用者名稱或群組名稱。

如需常見安全標識碼的詳細資訊，請參閱已知的 SID。

殼層啟動器啟動和結束行為

殼層啟動器會在啟動自定義殼層之前處理 Run 和 RunOnce 登錄機碼，因此您的自定義殼層不需要處理其他應用程式和服務的自動啟動。

殼層啟動器也會在自定義殼層結束時處理系統的行為。如果預設行為不符合您的需求，您可以設定殼層結束行為。當自定義殼層結束時，Shell Launcher 可以執行四個動作的其中一個：

0：重新啟動殼層
1：重新啟動裝置
2：關閉裝置
3：不執行任何動作

重要

請確定您的殼層應用程式不會自動結束，也不會由對話框篩選器等任何功能自動關閉，因為除非傳回碼動作設定為不執行任何動作，否則這可能會導致結束和重新啟動的無限迴圈。

默認傳回碼動作

您可以使用 DefaultReturnCodeAction 設定來定義 Shell Launcher 的預設傳回碼動作。如果您未變更初始值，預設傳回碼動作會設定為0 (零) ，這表示殼層啟動器會在殼層結束時重新啟動殼層。

將結束代碼對應至 Shell 啟動器動作

殼層啟動器可以根據殼層傳回的結束代碼來採取特定動作。對於殼層所傳回的任何指定結束代碼，您可以藉由將該結束代碼對應至其中一個殼層結束動作，來設定Shell Launcher所採取的動作。

如果結束代碼不符合定義的值，Shell Launcher 會執行預設傳回碼動作。

例如，您的殼層可能會傳回、0、 1或 255 的-1結束代碼值，視殼層的結束方式而定。您可以將 Shell Launcher 設定為：

當殼層傳回值的 1 結束代碼時，重新啟動裝置 () -1
當殼層傳回值的 0 結束代碼時，重新啟動殼層 () 0
當殼層傳回值 1 的 3 結束代碼時， () 不執行任何動作
當殼層傳回值的 2 結束代碼時，會關閉裝置 () 255

您的自訂傳回碼動作對應看起來像這樣：

結束代碼	動作
`-1`	`1` (重新啟動裝置)
`0`	`0` (重新啟動殼層)
`1`	`3` (不執行任何)
`255`	`2` (關閉裝置)

使用受指派的存取 CSP 設定您的自訂殼層

Shell Launcher 的設定是使用 XML 檔案來完成。 XML 檔案會使用下列其中一個選項，透過受指派的存取 CSP 套用至裝置：

行動裝置裝置管理 (MDM) 解決方案，例如 Microsoft Intune
佈建套件
MDM 網橋 WMI 提供者

注意

使用受指派的存取 CSP 設定 Shell Launcher，如果裝置支援，則會在裝置上自動啟用 Shell Launcher。

若要瞭解如何設定Shell Launcher XML 檔案，請參閱建立殼層啟動器組態檔。

下列指示提供如何設定裝置的詳細數據。選取最符合您需求的選項。

您可以使用自定義原則搭配 AssignedAccess CSP 來設定裝置。

設定：./Vendor/MSFT/AssignedAccess/ShellLauncher
值： XML 組態檔的內容

將原則指派給包含為您要設定之裝置成員的群組。

您可以藉由建立布建套件，然後在映射部署期間或在運行時間套用布建套件，來設定 Shell Launcher：

如果您要建立內含映射中殼層啟動器設定的安裝媒體，或是在安裝期間套用布建套件，您必須在具有 DISM 的安裝媒體上啟用 Shell Launcher，布建套件才能成功套用
如果在運行時間執行布建套件，請務必先啟用Shell Launcher ，再套用布建套件

使用下列設定來建立布建套件：

路徑	設定名稱	值
`SMISettings/ShellLauncher/`	`Enable`	使
`SMISettings/ShellLauncher/`	*	這取決於特定設定。

將布建套件套用至您想要設定的裝置。

透過 MDM 網橋 WMI 提供者，使用 PowerShell 腳本設定您的裝置。

重要

針對所有裝置設定，WMI 網橋客戶端必須以 SYSTEM (LocalSystem) 帳戶執行。

若要測試 PowerShell 腳本，您可以：

下載 psexec 工具
開啟提升權限的命令提示字元並執行： psexec.exe -i -s powershell.exe
在 PowerShell 工作階段中執行腳本

$shellLauncherConfiguration = @"

# content of the XML configuration file

"@

$namespaceName="root\cimv2\mdm\dmmap"
$className="MDM_AssignedAccess"
$obj = Get-CimInstance -Namespace $namespaceName -ClassName $className
$obj.ShellLauncher = [System.Net.WebUtility]::HtmlEncode($shellLauncherConfiguration)
$obj = Set-CimInstance -CimInstance $obj -ErrorVariable cimSetError -ErrorAction SilentlyContinue
if($cimSetError) {
    Write-Output "An ERROR occurred. Displaying error record and attempting to retrieve error logs...`n"
    Write-Error -ErrorRecord $cimSetError[0]

    $timeout = New-TimeSpan -Seconds 30
    $stopwatch = [System.Diagnostics.Stopwatch]::StartNew()
    $eventLogFilterHashTable = @{ LogName='Microsoft-Windows-AssignedAccess/Admin' }
    do{
        $events = Get-WinEvent -FilterHashtable $eventLogFilterHashTable -ErrorAction Ignore
    } until ($events.Count -or $stopwatch.Elapsed -gt $timeout) # wait for the log to be available

    if($events.Count) {
        $events | ForEach-Object {
            Write-Output "$($_.TimeCreated) [$($_.LevelDisplayName.ToUpper())] $($_.Message -replace "`n|`r")"
        }
    } else {
        Write-Warning "Timed-out attempting to retrieve event logs..."
    }

    Exit 1
}

Write-Output "Successfully applied Shell Launcher configuration"

如需詳細資訊，請參閱搭配 WMI 網橋提供者使用 PowerShell 腳本。

提示

如需實際範例，請參閱快速入門：使用Shell Launcher 設定 kiosk體驗。

使用者體驗

套用設定之後，設定為使用Shell Launcher的使用者將會在登入後執行自定義殼層。

視您的設定而定，您可以讓用戶自動登入裝置。

拿掉殼層啟動器

以下是移除 Shell Launcher 的選項，請選取最符合您需求的方法：

取消指派或刪除包含設定的原則。

$namespaceName="root\cimv2\mdm\dmmap"
$className="MDM_AssignedAccess"
$obj = Get-CimInstance -Namespace $namespaceName -ClassName $className
$obj.Configuration = $null
Set-CimInstance -CimInstance $obj

後續步驟

瞭解如何設定Shell Launcher XML 檔案：

建立殼層啟動器組態檔

共用方式為