Konfigurieren des Shell-Startprogramms

Es gibt zwei Möglichkeiten, das Shell-Startprogramm zu konfigurieren:

1. Verwenden des ShellLauncher Knotens des Konfigurationsdienstanbieters für zugewiesenen Zugriff (Assigned Access Configuration Service Provider, CSP), der auch automatisch das Shell-Startfeld auf dem Gerät aktiviert, wenn das Gerät dies unterstützt
2. Verwenden sie die WMI-Anbieter des Shell-Startprogramms direkt in einer Anwendung. Wenn Sie diese Methode verwenden, müssen Sie zuerst das Shell-Startprogramm aktivieren .

Sie können die folgenden Optionen für das Shell-Startprogramm konfigurieren:

• Hinzufügen/Entfernen einer Shellkonfiguration für einen bestimmten Benutzer oder eine bestimmte Gruppe
• Ändern der Standardshellkonfiguration
• Abrufen von Informationen zu einer Shellkonfiguration für einen bestimmten Benutzer oder eine bestimmte Gruppe

Aktivieren des Shell-Startprogramms

Das Shell-Startprogramm ist eine optionale Komponente in Windows, die standardmäßig nicht aktiviert ist. Um sie zu konfigurieren, müssen Sie sie zuerst aktivieren. Sie können das Shell-Startprogramm in einem benutzerdefinierten Windows-Image aktivieren und konfigurieren, oder Sie können es aktivieren, bevor Sie ein Bereitstellungspaket anwenden, um es zu konfigurieren.

Es gibt mehrere Möglichkeiten, das Shell-Startprogramm zu aktivieren. Wählen Sie die Methode aus, die Ihren Anforderungen am besten entspricht, um mehr zu erfahren.

@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

Starten verschiedener Shells für verschiedene Benutzerkonten

Standardmäßig führt das Shell-Startprogramm die Standardshell aus, die beim Erstellen des Betriebssystemimages zur Entwurfszeit angegeben wird. Die Standardshell ist auf den Windows-Befehlsprozessor (Cmd.exe) festgelegt, aber Sie können jede ausführbare Datei als Standardshell angeben.

Sie können das Shell-Startprogramm auch so konfigurieren, dass eine andere Shell für bestimmte Benutzer oder Gruppen gestartet wird, wenn Sie die Standardshell nicht ausführen möchten. Beispielsweise können Sie ein Gerät so konfigurieren, dass eine benutzerdefinierte Anwendungsshell für Gastkonten gestartet wird, aber die Standardmäßige Windows Explorer-Shell für Administratorkonten zur Wartung des Geräts ausführen.

Wenn das aktuell angemeldete Konto zu zwei oder mehr Gruppen gehört, für die für jede Gruppe unterschiedliche Konfigurationen definiert sind, verwendet das Shell-Startprogramm die erste gefundene Konfiguration. Da die Suchreihenfolge nicht definiert ist, sollten Sie vermeiden, einen Benutzer mehreren Gruppen mit unterschiedlichen Shell-Startprogrammkonfigurationen zuzuweisen.

Start- und Beendigungsverhalten des Shell-Startprogramms

Das Shell-Startprogramm verarbeitet die Run Registrierungsschlüssel und RunOnce vor dem Starten der benutzerdefinierten Shell, sodass Ihre benutzerdefinierte Shell den automatischen Start anderer Anwendungen und Dienste nicht verarbeiten muss.

Das Shell-Startprogramm behandelt auch das Verhalten des Systems, wenn Ihre benutzerdefinierte Shell beendet wird. Sie können das Verhalten beim Beenden der Shell konfigurieren, wenn das Standardverhalten Nicht Ihren Anforderungen entspricht. Wenn eine benutzerdefinierte Shell beendet wird, kann das Shell-Startprogramm eine von vier Aktionen ausführen:

• 0: Starten Sie die Shell neu.
• 1: Starten Sie das Gerät neu.
• 2: Herunterfahren des Geräts
• 3:Nichts tun

Standardmäßige Rückgabecodeaktion

Sie können eine standardmäßige Rückgabecodeaktion für das Shell-Startprogramm mit der Einstellung DefaultReturnCodeAction definieren. Wenn Sie den Anfangswert nicht ändern, wird die Standardmäßige Rückgabecodeaktion auf 0 (null) festgelegt. Dies bedeutet, dass das Shell-Startprogramm die Shell neu startet, wenn die Shell beendet wird.

Zuordnen des Exitcodes zu einer Shell-Startprogrammaktion

Das Shell-Startprogramm kann basierend auf dem von der Shell zurückgegebenen Exitcode eine bestimmte Aktion ausführen. Für jeden von der Shell zurückgegebenen Exitcode können Sie die Aktion des Shell-Startprogramms konfigurieren, indem Sie diesen Exitcode einer der Shell-Exitaktionen zuordnen.

Wenn der Exitcode nicht mit einem definierten Wert übereinstimmt, führt shell Launcher die Standardmäßige Rückgabecodeaktion aus.

Ihre Shell kann z. B. Exitcodewerte von -1, , 10oder 255 zurückgeben, je nachdem, wie die Shell beendet wird. Sie können das Shell-Startprogramm für Folgendes konfigurieren:

• Starten Sie das Gerät neu (1), wenn die Shell einen Exitcode des Werts zurückgibt. -1
• Starten Sie die Shell (0) neu, wenn die Shell einen Exitcode mit value zurückgibt. 0
• Nichts tun (3), wenn die Shell einen Exitcode des Werts 1 zurückgibt
• Herunterfahren des Geräts (2), wenn die Shell einen Exitcode des Werts zurückgibt 255

Ihre benutzerdefinierte Rückgabecodeaktionszuordnung würde wie folgt aussehen:

Festlegen der benutzerdefinierten Shell mit dem Zugewiesenen Zugriff -CSP

Die Konfiguration des Shell-Startprogramms erfolgt mithilfe einer XML-Datei. Die XML-Datei wird über den Zugewiesener-Zugriff-CSP auf das Gerät angewendet, wobei eine der folgenden Optionen verwendet wird:

• Eine Mobile Device Management (MDM)-Lösung, wie Microsoft Intune
• Bereitstellungspakete
• Der MDM-Bridge-WMI-Anbieter

Informationen zum Konfigurieren der XML-Datei des Shell-Startprogramms finden Sie unter Erstellen einer Shell-Startprogrammkonfigurationsdatei.

Die folgenden Anweisungen enthalten Details zum Konfigurieren Ihrer Geräte. Wählen Sie die Option, die Ihren Bedürfnissen am besten entspricht.

$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"

Benutzerfreundlichkeit

Nachdem die Einstellungen angewendet wurden, führen die Benutzer, die für die Verwendung des Shell-Startprogramms konfiguriert sind, die benutzerdefinierte Shell nach der Anmeldung aus.

Abhängig von Ihrer Konfiguration können Sie einen Benutzer bitten, sich automatisch beim Gerät anzumelden.

Entfernen des Shell-Startprogramms

Hier sind die Optionen zum Entfernen des Shell-Startprogramms, und wählen Sie die Methode aus, die Ihren Anforderungen am besten entspricht:

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

Nächste Schritte