Configurare Avvio shell

È possibile configurare Shell Launcher in due modi:

1. Uso del ShellLauncher nodo del provider di servizi di configurazione dell'accesso assegnato (CSP), che abilita automaticamente anche l'utilità di avvio della shell nel dispositivo, se il dispositivo lo supporta
2. Uso dei provider WMI dell'utilità di avvio shell direttamente in un'applicazione. Quando si usa questo metodo, è prima necessario abilitare Shell Launcher

È possibile configurare le opzioni seguenti per Avvio shell:

• Aggiungere/rimuovere una configurazione della shell per un utente o un gruppo specifico
• Modificare la configurazione predefinita della shell
• Ottenere informazioni su una configurazione della shell per un utente o un gruppo specifico

Abilitare l'utilità di avvio della shell

Shell Launcher è un componente facoltativo in Windows che non è abilitato per impostazione predefinita. Per configurarlo, è prima necessario abilitarlo. È possibile abilitare e configurare Shell Launcher in un'immagine Windows personalizzata oppure abilitarla prima di applicare un pacchetto di provisioning per configurarlo.

Esistono diversi modi per abilitare Shell Launcher, selezionare il metodo più adatto alle proprie esigenze per altre informazioni.

@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

Avviare shell diverse per account utente diversi

Per impostazione predefinita, Shell Launcher esegue la shell predefinita, specificata quando si crea l'immagine del sistema operativo in fase di progettazione. La shell predefinita è impostata su Processore di comandi di Windows (Cmd.exe), ma è possibile specificare qualsiasi file eseguibile come shell predefinita.

È anche possibile configurare Shell Launcher per avviare una shell diversa per utenti o gruppi specifici se non si vuole eseguire la shell predefinita. Ad esempio, è possibile configurare un dispositivo per avviare una shell dell'applicazione personalizzata per gli account guest, ma eseguire la shell di Esplora risorse standard per gli account amministratore per la manutenzione del dispositivo.

Quando l'account di accesso corrente appartiene a due o più gruppi con configurazioni diverse definite per ogni gruppo, Shell Launcher usa la prima configurazione trovata. L'ordine di ricerca non è definito, pertanto è consigliabile evitare di assegnare un utente a più gruppi con configurazioni di Avvio shell diverse.

Comportamento di avvio e uscita dell'utilità di avvio della shell

Shell Launcher elabora le Run chiavi del Registro di sistema e RunOnce prima di avviare la shell personalizzata, quindi la shell personalizzata non deve gestire l'avvio automatico di altre applicazioni e servizi.

Shell Launcher gestisce anche il comportamento del sistema quando la shell personalizzata esce. È possibile configurare il comportamento di uscita della shell se il comportamento predefinito non soddisfa le proprie esigenze. Quando una shell personalizzata viene chiusa, Shell Launcher può eseguire una delle quattro azioni seguenti:

• 0: riavviare la shell
• 1: riavviare il dispositivo
• 2: arrestare il dispositivo
• 3: non eseguire alcuna operazione

Azione predefinita per il codice restituito

È possibile definire un'azione di codice restituito predefinita per Avvio shell con l'impostazione DefaultReturnCodeAction. Se non si modifica il valore iniziale, l'azione di codice restituito predefinita è impostata su 0 (zero), che indica che Avvio shell riavvia la shell quando la shell esce.

Eseguire il mapping del codice di uscita a un'azione di avvio shell

Shell Launcher può eseguire un'azione specifica in base al codice di uscita restituito dalla shell. Per qualsiasi codice di uscita specificato restituito dalla shell, è possibile configurare l'azione eseguita da Shell Launcher eseguendo il mapping del codice di uscita a una delle azioni di uscita della shell.

Se il codice di uscita non corrisponde a un valore definito, Shell Launcher esegue l'azione predefinita del codice restituito.

Ad esempio, la shell potrebbe restituire valori di codice di uscita di -1, 0, 1o 255 a seconda della modalità di uscita della shell. È possibile configurare Shell Launcher per:

• riavviare il dispositivo (1) quando la shell restituisce un codice di uscita di valore -1
• riavviare la shell (0) quando la shell restituisce un codice di uscita di valore 0
• non eseguire alcuna operazione (3) quando la shell restituisce un codice di uscita del valore 1
• arrestare il dispositivo (2) quando la shell restituisce un codice di uscita di valore 255

Il mapping dell'azione di codice restituito personalizzato sarà simile al seguente:

Impostare la shell personalizzata con il provider di servizi di configurazione accesso assegnato

La configurazione di Shell Launcher viene eseguita usando un file XML. Il file XML viene applicato al dispositivo tramite il CSP Accesso assegnato, utilizzando una delle seguenti opzioni:

• Una soluzione di gestione dei dispositivi mobili (MDM), come Microsoft Intune
• Pacchetti di provisioning
• Provider WMI del bridge MDM

Per informazioni su come configurare il file XML dell'utilità di avvio della shell, vedere Creare un file di configurazione di Shell Launcher.

Le istruzioni seguenti forniscono informazioni dettagliate su come configurare i dispositivi. Seleziona l'opzione più adatta alle tue esigenze.

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

Esperienza utente

Dopo l'applicazione delle impostazioni, gli utenti configurati per l'uso di Shell Launcher eseguiranno la shell personalizzata dopo l'accesso.

A seconda della configurazione, è possibile avere un utente per accedere automaticamente al dispositivo.

Rimuovere l'utilità di avvio della shell

Ecco le opzioni per rimuovere Shell Launcher, selezionare il metodo più adatto alle proprie esigenze:

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

Passaggi successivi