WESL_UserSetting

Articolo
07/22/2023

Questa classe configura l'avvio dell'utilità di avvio della shell dell'applicazione in base all'identificatore di sicurezza (SID) dell'utente connesso e configura anche il set di codici restituiti e restituisce azioni eseguite da Shell Launcher all'uscita dall'applicazione.

Sintassi

class WESL_UserSetting {
    [read, write, Required] string Sid;
    [read, write, Required] string Shell;
    [read, write]  Sint32 CustomReturnCodes[];
    [read, write]  Sint32 CustomReturnCodesAction[];
    [read, write] sint32 DefaultAction;

    [Static] uint32 SetCustomShell(
        [In, Required] string Sid,
        [In, Required] string Shell,
        [In] sint32 CustomReturnCodes[],
        [In] sint32 CustomReturnCodesAction[],
        [In] sint32 DefaultAction
    );
    [Static] uint32 GetCustomShell(
        [In, Required] string Sid,
        [Out, Required] string Shell,
        [Out, Required] sint32 CustomReturnCodes[],
        [Out, Required] sint32 CustomReturnCodesAction[],
        [Out, Required] sint32 DefaultAction
    );
    [Static] uint32 RemoveCustomShell(
        [In, Required] string Sid
    );
    [Static] uint32 GetDefaultShell(
        [Out, Required] string Shell,
        [Out, Required] sint32 DefaultAction
    );
    [Static] uint32 SetDefaultShell(
        [In, Required] string Shell,
        [In, Required] sint32 DefaultAction
    );
    [Static] uint32 IsEnabled(
        [Out, Required] boolean Enabled
    );
    [Static] uint32 SetEnabled(
        [In, Required] boolean Enabled);
    );
};

Members

Nelle tabelle seguenti sono elencati i metodi e le proprietà appartenenti a questa classe.

Metodi

Metodi	Descrizione
WESL_UserSetting.SetCustomShell	Configura l'utilità di avvio della shell per un utente o un gruppo specifico, in base al SID.
WESL_UserSetting.GetCustomShell	Recupera la configurazione di Shell Launcher per un utente o un gruppo specifico, in base al SID.
WESL_UserSetting.RemoveCustomShell	Rimuove una configurazione di Shell Launcher per un utente o un gruppo specifico, in base al SID.
WESL_UserSetting.GetDefaultShell	Recupera la configurazione predefinita dell'utilità di avvio della shell.
WESL_UserSetting.SetDefaultShell	Imposta la configurazione predefinita di Shell Launcher.
WESL_UserSetting.IsEnabled	Recupera un valore che indica se l'utilità di avvio della shell è abilitata o disabilitata.
WESL_UserSetting.SetEnabled	Abilita o disabilita l'utilità di avvio della shell.

Proprietà

Proprietà	Tipo di dati	Qualificatori	Descrizione
Sid	string	[lettura, scrittura, obbligatorio]	SID utente o gruppo.
Guscio	string	[lettura, scrittura, obbligatorio]	Applicazione da avviare come shell. La proprietà della shell può essere un nome file nella variabile di ambiente Path oppure può contenere un percorso completo per l'applicazione. È anche possibile usare le variabili di ambiente nel percorso. Tutti gli spazi nella proprietà della shell devono far parte di una stringa delimitata da virgolette.
CustomReturnCodes	Sint32[]	[lettura, scrittura]	Matrice di codici restituiti personalizzati che possono essere restituiti dalla shell.
CustomReturnCodesAction	Sint32[]	[lettura, scrittura]	Matrice di azioni del codice restituito personalizzate che determinano l'azione eseguita da Utilità di avvio shell all'uscita dalla shell. Le azioni personalizzate eseguono il mapping alla matrice di CustomReturnCodes. Le azioni possibili sono: 0 - Riavviare la shell. 1 - Riavviare il dispositivo. 2 - Arrestare il dispositivo. 3 - Non fare nulla.
Defaultaction	Sint32	[lettura, scrittura]	L'azione predefinita Utilità di avvio shell viene eseguita all'uscita dalla shell. Le azioni possibili sono definite come segue: 0 - Riavviare la shell. 1 - Riavviare il dispositivo. 2 - Arrestare il dispositivo. 3 - Non fare nulla.

Commenti

Esiste una sola istanza di WESL_UserSetting in un dispositivo con Avvio shell.

Shell Launcher usa la configurazione personalizzata definita per il SID dell'utente attualmente connesso, se presente. In caso contrario, Shell Launcher usa una configurazione personalizzata definita per un SID di gruppo di cui l'utente è membro, se presente. Se esistono più configurazioni personalizzate di gruppo per l'utente, Avvio shell usa la prima configurazione valida trovata. L'ordine di ricerca non è definito.

Se non è presente alcuna configurazione personalizzata per il SID dell'utente o per i SID di gruppo di cui l'utente è membro, Avvio shell usa la configurazione predefinita.

È possibile trovare il SID per un utente e tutti i gruppi di cui l'utente è membro usando lo strumento da riga di comando whoami .

Esempio

Lo script di Windows PowerShell seguente illustra come aggiungere e rimuovere configurazioni della shell personalizzate per l'utilità di avvio della shell usando i provider di Strumentazione gestione Windows (WMI) per l'utilità di avvio della shell.

$COMPUTER = "localhost"
$NAMESPACE = "root\standardcimv2\embedded"

# Create a handle to the class instance so we can call the static methods.
$ShellLauncherClass = [wmiclass]"\\$COMPUTER\${NAMESPACE}:WESL_UserSetting"


# This well-known security identifier (SID) corresponds to the BUILTIN\Administrators group.

$Admins_SID = "S-1-5-32-544"

# Create a function to retrieve the SID for a user account on a machine.

function Get-UsernameSID($AccountName) {

    $NTUserObject = New-Object System.Security.Principal.NTAccount($AccountName)
    $NTUserSID = $NTUserObject.Translate([System.Security.Principal.SecurityIdentifier])

    return $NTUserSID.Value

}

# Get the SID for a user account named "Cashier". Rename "Cashier" to an existing account on your system to test this script.

$Cashier_SID = Get-UsernameSID("Cashier")

# Define actions to take when the shell program exits.

$restart_shell = 0
$restart_device = 1
$shutdown_device = 2
$do_nothing = 3

# Examples

# Set the command prompt as the default shell, and restart the device if it's closed.

$ShellLauncherClass.SetDefaultShell("cmd.exe", $restart_device)

# Display the default shell to verify that it was added correctly.

$DefaultShellObject = $ShellLauncherClass.GetDefaultShell()

"`nDefault Shell is set to " + $DefaultShellObject.Shell + " and the default action is set to " + $DefaultShellObject.defaultaction

# Set Internet Explorer as the shell for "Cashier", and restart the machine if it's closed.

$ShellLauncherClass.SetCustomShell($Cashier_SID, "c:\program files\internet explorer\iexplore.exe www.microsoft.com", ($null), ($null), $restart_shell)

# Set Explorer as the shell for administrators.

$ShellLauncherClass.SetCustomShell($Admins_SID, "explorer.exe")

# View all the custom shells defined.

"`nCurrent settings for custom shells:"
Get-WmiObject -namespace $NAMESPACE -computer $COMPUTER -class WESL_UserSetting | Select Sid, Shell, DefaultAction

# Remove the new custom shells.

$ShellLauncherClass.RemoveCustomShell($Admins_SID)

$ShellLauncherClass.RemoveCustomShell($Cashier_SID)

Requisiti

Edizione per Windows	Supportato
Windows Home	No
Windows Pro	No
Windows Enterprise	Sì
Windows Education	Sì
Windows IoT Enterprise	Sì

Utilità di avvio della shell