Configurar el iniciador de shell

Hay dos maneras de configurar Shell Launcher:

1. Usar el ShellLauncher nodo del proveedor de servicios de configuración de acceso asignado (CSP), que también habilita automáticamente el iniciador de shell en el dispositivo, si el dispositivo lo admite
2. Usar los proveedores WMI del iniciador de shell directamente en una aplicación. Al usar este método, primero debe habilitar el iniciador de shell .

Puede configurar las siguientes opciones para El iniciador de shell:

• Adición o eliminación de una configuración de shell para un usuario o grupo específico
• Cambio de la configuración predeterminada del shell
• Obtener información sobre una configuración de shell para un usuario o grupo específico

Habilitación del iniciador de Shell

El iniciador de shell es un componente opcional en Windows que no está habilitado de forma predeterminada. Para configurarlo, primero debe habilitarlo. Puede habilitar y configurar el iniciador de Shell en una imagen de Windows personalizada, o bien puede habilitarla antes de aplicar un paquete de aprovisionamiento para configurarlo.

Hay varias maneras de habilitar shell launcher, seleccione el método que mejor se adapte a sus necesidades para obtener más información.

@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

Inicio de diferentes shells para diferentes cuentas de usuario

De forma predeterminada, el iniciador de shell ejecuta el shell predeterminado, que se especifica al crear la imagen del sistema operativo en tiempo de diseño. El shell predeterminado se establece en el procesador de comandos de Windows (Cmd.exe), pero puede especificar cualquier archivo ejecutable para que sea el shell predeterminado.

También puede configurar el iniciador de shell para iniciar un shell diferente para usuarios o grupos específicos si no desea ejecutar el shell predeterminado. Por ejemplo, puede configurar un dispositivo para iniciar un shell de aplicación personalizado para las cuentas de invitado, pero ejecutar el shell estándar del Explorador de Windows para las cuentas de administrador para el mantenimiento del dispositivo.

Cuando la cuenta actual con sesión iniciada pertenece a dos o más grupos que tienen configuraciones diferentes definidas para cada grupo, el iniciador de shell usa la primera configuración que encuentra. El orden de búsqueda no está definido, por lo que se recomienda evitar la asignación de un usuario a varios grupos con distintas configuraciones del iniciador de shell.

Comportamiento de inicio y salida del iniciador de shell

El iniciador de shell procesa las Run claves del Registro y RunOnce antes de iniciar el shell personalizado, por lo que el shell personalizado no necesita controlar el inicio automático de otras aplicaciones y servicios.

El iniciador de shell también controla el comportamiento del sistema cuando se cierra el shell personalizado. Puede configurar el comportamiento de salida del shell si el comportamiento predeterminado no satisface sus necesidades. Cuando se cierra un shell personalizado, el iniciador de shell puede realizar una de las cuatro acciones siguientes:

• 0: reinicie el shell.
• 1: reinicie el dispositivo.
• 2: apagar el dispositivo
• 3: no hacer nada

Acción de código devuelto predeterminada

Puede definir una acción de código devuelto predeterminada para shell Launcher con el valor DefaultReturnCodeAction. Si no cambia el valor inicial, la acción de código devuelto predeterminada se establece en 0 (cero), lo que indica que el iniciador de shell reinicia el shell cuando se cierra el shell.

Asignar el código de salida a una acción del iniciador de Shell

El iniciador de shell puede realizar una acción específica en función del código de salida devuelto por el shell. Para cualquier código de salida determinado devuelto por el shell, puede configurar la acción que realiza el iniciador de shell mediante la asignación de ese código de salida a una de las acciones de salida del shell.

Si el código de salida no coincide con un valor definido, el iniciador de shell realiza la acción de código devuelto predeterminada.

Por ejemplo, el shell podría devolver valores de código de salida de -1, 0, 1o 255 en función de cómo salga el shell. Puede configurar el iniciador de shell para:

• reiniciar el dispositivo (1) cuando el shell devuelve un código de salida de valor -1
• reiniciar el shell (0) cuando el shell devuelve un código de salida de valor 0
• no hacer nada (3) cuando el shell devuelve un código de salida del valor 1
• apagar el dispositivo (2) cuando el shell devuelve un código de salida de valor 255

La asignación de acción de código devuelto personalizada tendría este aspecto:

Establecer el shell personalizado con el CSP de acceso asignado

La configuración del iniciador de shell se realiza mediante un archivo XML. El archivo XML se aplica al dispositivo a través del CSP de acceso asignado mediante una de las siguientes opciones:

• Una solución de Administración de dispositivos móviles (MDM), como Microsoft Intune
• Paquetes de aprovisionamiento
• Proveedor wmi de puente mdm

Para obtener información sobre cómo configurar el archivo XML del iniciador de shell, consulte Creación de un archivo de configuración del iniciador de shell.

En las instrucciones siguientes se proporcionan detalles sobre cómo configurar los dispositivos. Seleccione la opción que mejor se adapte a sus necesidades.

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

Experiencia del usuario

Una vez aplicada la configuración, los usuarios configurados para usar el iniciador de shell ejecutarán el shell personalizado después del inicio de sesión.

En función de la configuración, puede hacer que un usuario inicie sesión automáticamente en el dispositivo.

Quitar iniciador de shell

Estas son las opciones para quitar Shell Launcher y seleccionar el método que mejor se adapte a sus necesidades:

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

Pasos siguientes