Configurar o Iniciador de Shell

Existem duas formas de configurar o Iniciador de Shell:

1. Utilizar o ShellLauncher nó do Fornecedor de Serviços de Configuração de Acesso Atribuído (CSP), que também ativa automaticamente o Iniciador da Shell no dispositivo, se o dispositivo o suportar
2. Utilizar os fornecedores WMI do Shell Launcher diretamente numa aplicação. Ao utilizar este método, primeiro tem de ativar o Shell Launcher

Pode configurar as seguintes opções para o Shell Launcher:

• Adicionar/remover uma configuração de shell para um utilizador ou grupo específico
• Alterar a configuração da shell predefinida
• Obter informações sobre uma configuração de shell para um utilizador ou grupo específico

Ativar o Iniciador de Shell

O Shell Launcher é um componente opcional no Windows que não está ativado por predefinição. Para o configurar, primeiro tem de a ativar. Pode ativar e configurar o Shell Launcher numa imagem personalizada do Windows ou pode ativá-lo antes de aplicar um pacote de aprovisionamento para o configurar.

Existem várias formas de ativar o Shell Launcher. Selecione o método mais adequado às suas necessidades para saber mais.

@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

Iniciar shells diferentes para contas de utilizador diferentes

Por predefinição, o Shell Launcher executa a shell predefinida, que é especificada quando cria a imagem do SO no momento da conceção. A shell predefinida está definida para o Processador de Comandos do Windows (Cmd.exe), mas pode especificar qualquer ficheiro executável para ser a shell predefinida.

Também pode configurar o Shell Launcher para iniciar uma shell diferente para utilizadores ou grupos específicos se não quiser executar a shell predefinida. Por exemplo, pode configurar um dispositivo para iniciar uma shell de aplicação personalizada para contas de convidado, mas executar a shell padrão do Windows Explorer para contas de administrador para manutenção do dispositivo.

Quando a conta com sessão iniciada atual pertence a dois ou mais grupos que têm configurações diferentes definidas para cada grupo, o Shell Launcher utiliza a primeira configuração que encontrar. A ordem de pesquisa não está definida, pelo que recomendamos que evite atribuir um utilizador a vários grupos com diferentes configurações do Shell Launcher.

Comportamento de arranque e saída do Shell Launcher

O Shell Launcher processa as Run chaves de registo e RunOnce antes de iniciar a shell personalizada, para que a shell personalizada não precise de processar o arranque automático de outras aplicações e serviços.

O Shell Launcher também processa o comportamento do sistema quando a shell personalizada sai. Pode configurar o comportamento de saída da shell se o comportamento predefinido não corresponder às suas necessidades. Quando uma shell personalizada sai, o Shell Launcher pode executar uma de quatro ações:

• 0: Reinicie a shell
• 1: Reinicie o dispositivo
• 2: Encerre o dispositivo
• 3: Não fazer nada

Ação de código de retorno predefinido

Pode definir uma ação de código de retorno predefinida para o Iniciador de Shell com a definição DefaultReturnCodeAction. Se não alterar o valor inicial, a ação de código de retorno predefinida é definida como 0 (zero), o que indica que o Shell Launcher reinicia a shell quando a shell é encerrada.

Mapear o código de saída para uma ação do Iniciador de Shell

O Shell Launcher pode efetuar uma ação específica com base no código de saída devolvido pela shell. Para qualquer código de saída devolvido pela shell, pode configurar a ação que o Shell Launcher executa ao mapear esse código de saída para uma das ações de saída da shell.

Se o código de saída não corresponder a um valor definido, o Shell Launcher efetua a ação de código de retorno predefinida.

Por exemplo, a shell pode devolver valores de código de saída de -1, 0, 1ou 255 consoante a forma como a shell sai. Pode configurar o Shell Launcher para:

• reiniciar o dispositivo (1) quando a shell devolver um código de saída de valor -1
• reiniciar a shell (0) quando a shell devolver um código de saída de valor 0
• não fazer nada (3) quando a shell devolve um código de saída do valor 1
• encerrar o dispositivo (2) quando a shell devolver um código de saída de valor 255

O mapeamento de ação do código de retorno personalizado teria o seguinte aspeto:

Definir a shell personalizada com o CSP de Acesso Atribuído

A configuração do Shell Launcher é feita com um ficheiro XML. O ficheiro XML é aplicado ao dispositivo através do CSP de Acesso Atribuído, utilizando uma das seguintes opções:

• Uma solução de Gerenciamento de Dispositivos Móvel (MDM), como Microsoft Intune
• Pacotes de provisionamento
• O Fornecedor de WMI de Ponte MDM

Para saber como configurar o ficheiro XML do Iniciador de Shell, veja Criar um ficheiro de configuração do Shell Launcher.

As instruções seguintes fornecem detalhes sobre como configurar os seus dispositivos. Selecione a opção mais adequada às suas necessidades.

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

Experiência do usuário

Depois de aplicadas as definições, os utilizadores configurados para utilizar o Shell Launcher irão executar a shell personalizada após o início de sessão.

Consoante a configuração, pode fazer com que um utilizador inicie sessão automaticamente no dispositivo.

Remover o Iniciador de Shell

Eis as opções para remover o Iniciador de Shell, selecione o método que melhor se adequa às suas necessidades:

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

Próximas etapas