Condividi tramite

Gestione dei modelli di percorso delle impostazioni di UE-V 2.1 SP1 tramite Windows PowerShell e WMI

  • Articolo

Microsoft User Experience Virtualization (UE-V) 2.1 SP1 usa i modelli di percorso delle impostazioni XML per definire le impostazioni acquisite e applicate da UE-V. UE-V include un set di modelli di posizione delle impostazioni standard. Include anche lo strumento UE-V Generator che consente di creare modelli di posizione delle impostazioni personalizzati. Dopo aver creato e distribuito i modelli di percorso delle impostazioni, è possibile gestirli usando Windows PowerShell e Strumentazione gestione Windows (WMI). Per un elenco completo dei cmdlet di PowerShell UE-V, vedere Informazioni di riferimento sul cmdlet MDOP.

Gestire i modelli di percorso delle impostazioni UE-V 2 tramite Windows PowerShell

Le funzionalità WMI e Windows PowerShell di UE-V includono la possibilità di abilitare, disabilitare, registrare, aggiornare e annullare la registrazione dei modelli di posizione delle impostazioni. Usando queste funzionalità, è possibile automatizzare il processo di registrazione, aggiornamento o annullamento della registrazione dei modelli con l'agente UE-V. È anche possibile registrare manualmente i modelli usando i comandi WMI e Windows PowerShell. Usando queste funzionalità con una soluzione di distribuzione software elettronica, criteri di gruppo o un altro metodo di distribuzione automatizzato, ad esempio uno script, è possibile automatizzare ulteriormente tale processo.

È necessario disporre delle autorizzazioni di amministratore per aggiornare, registrare o annullare la registrazione di un modello di percorso delle impostazioni. Le autorizzazioni di amministratore non sono necessarie per abilitare, disabilitare o elencare i modelli.

Per gestire i modelli di percorso delle impostazioni tramite Windows PowerShell

  1. Usare un account con diritti di amministratore per aprire un prompt dei comandi di Windows PowerShell.

  2. Per registrare e gestire i modelli di percorso delle impostazioni UE-V, usare i cmdlet di Windows PowerShell seguenti:

    Comando di Windows PowerShell Descrizione
    Get-UevTemplate Elenca tutti i modelli di percorso delle impostazioni registrati nel computer.
    Get-UevTemplate -Application <string> Elenca tutti i modelli di percorso delle impostazioni registrati nel computer in cui il nome dell'applicazione o il nome del modello contiene <string>.
    Get-UevTemplate -TemplateID <string> Elenca tutti i modelli di percorso delle impostazioni registrati nel computer in cui l'ID modello contiene <string>.
    Get-UevTemplate [-ApplicationOrTemplateID] <string> Elenca tutti i modelli di percorso delle impostazioni registrati nel computer in cui il nome dell'applicazione o del modello o l'ID modello contiene <string>.
    Get-UevTemplateProgram [-ID] <template ID> Ottiene il nome del programma e le informazioni sulla versione, che dipendono dall'ID modello.
    Get-UevAppXPackage Ottiene l'elenco effettivo delle app di Windows.
    Get-UevAppXPackage -Computer Ottiene l'elenco di app di Windows configurate per il computer.
    Get-UevAppXPackage -CurrentComputerUser Ottiene l'elenco di app di Windows configurate per l'utente corrente.
    Register-UevTemplate [-Path] <template file path>[,<template file path>] Registra uno o più modelli di posizione delle impostazioni con UE-V usando percorsi relativi e/o caratteri jolly nei percorsi di file. Dopo la registrazione di un modello, UE-V sincronizza le impostazioni definite nel modello tra i computer in cui è registrato il modello.
    Register-UevTemplate -LiteralPath <template file path>[,<template file path>] Registra uno o più modelli di posizione delle impostazioni con UE-V usando percorsi letterali, in cui nessun carattere può essere interpretato come caratteri jolly. Dopo la registrazione di un modello, UE-V sincronizza le impostazioni definite nel modello tra i computer in cui è registrato il modello.
    Unregister-UevTemplate [-ID] <template ID> Annulla la registrazione di un modello di percorso delle impostazioni con UE-V. Quando viene annullata la registrazione di un modello, UE-V non sincronizza più le impostazioni definite nel modello tra computer.
    Unregister-UevTemplate -All Annulla la registrazione di tutti i modelli di percorso delle impostazioni con UE-V. Quando viene annullata la registrazione di un modello, UE-V non sincronizza più le impostazioni definite nel modello tra computer.
    Update-UevTemplate [-Path] <template file path>[,<template file path>] Aggiorna uno o più modelli di posizione delle impostazioni con una versione più recente del modello. Usare percorsi relativi e/o caratteri jolly nei percorsi dei file. Il nuovo modello deve essere una versione più recente del modello esistente.
    Update-UevTemplate -LiteralPath <template file path>[,<template file path>] Aggiorna uno o più modelli di posizione delle impostazioni con una versione più recente del modello. Usare percorsi completi per i file modello, in cui nessun carattere può essere interpretato come caratteri jolly. Il nuovo modello deve essere una versione più recente del modello esistente.
    Clear-UevAppXPackage -Computer [-PackageFamilyName] <package family name>[,<package family name>] Rimuove una o più app di Windows dall'elenco delle app di Windows del computer.
    Clear-UevAppXPackage -CurrentComputerUser Rimuove l'app di Windows dall'elenco di app di Windows utente corrente.
    Clear-UevAppXPackage -Computer -All Rimuove tutte le app di Windows dall'elenco delle app di Windows del computer.
    Clear-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Rimuove una o più app di Windows dall'elenco di app di Windows dell'utente corrente.
    Clear-UevAppXPackage [-CurrentComputerUser] -All Rimuove tutte le app di Windows dall'elenco di app di Windows dell'utente corrente.
    Disable-UevTemplate [-ID] <template ID> Disabilita un modello di percorso delle impostazioni per l'utente corrente del computer.
    Disable-UevAppXPackage -Computer [-PackageFamilyName] <package family name>[,<package family name>] Disabilita una o più app di Windows nell'elenco delle app di Windows del computer.
    Disable-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Disabilita una o più app di Windows nell'elenco delle app di Windows dell'utente corrente.
    Enable-UevTemplate [-ID] <template ID> Abilita un modello di posizione delle impostazioni per l'utente corrente del computer.
    Enable-UevAppXPackage -Computer [-PackageFamilyName] <package family name>[,<package family name>] Abilita una o più app di Windows nell'elenco delle app di Windows del computer.
    Enable-UevAppXPackage [-CurrentComputerUser] [-PackageFamilyName] <package family name>[,<package family name>] Abilita una o più app di Windows nell'elenco delle app di Windows dell'utente corrente.
    Test-UevTemplate [-Path] <template file path>[,<template file path>] Determina se uno o più modelli di percorso delle impostazioni sono conformi al relativo XML Schema. Può usare percorsi relativi e caratteri jolly.
    Test-UevTemplate -LiteralPath <template file path>[,<template file path>] Determina se uno o più modelli di percorso delle impostazioni sono conformi al relativo XML Schema. Il percorso deve essere un percorso completo del file modello, ma non include caratteri jolly.

Le funzionalità di Windows PowerShell UE-V consentono di gestire un gruppo di modelli di impostazioni distribuiti nell'organizzazione. Usare la procedura seguente per gestire un gruppo di modelli tramite Windows PowerShell.

Per gestire un gruppo di modelli di percorso delle impostazioni tramite Windows PowerShell

  1. Modificare o aggiornare i modelli di percorso delle impostazioni desiderate.

  2. Se si desidera modificare o aggiornare i modelli di percorso delle impostazioni, distribuire tali modelli di percorso in una cartella accessibile al computer locale.

  3. Nel computer locale aprire una finestra di Windows PowerShell con diritti di amministratore.

  4. Annullare la registrazione di tutte le versioni registrate in precedenza dei modelli digitando il comando seguente.

    Unregister-UevTemplate -All

    Questo comando annulla la registrazione di tutti i modelli attivi nel computer.

  5. Registrare i modelli aggiornati digitando il comando seguente.

    Register-UevTemplate <path to template folder>\*.xml

    Questo comando registra tutti i modelli di percorso delle impostazioni che si trovano nella cartella del modello specificata.

Elenco di app di Windows

Elencando un'app di Windows nell'elenco delle app di Windows, si specifica se l'app è abilitata o disabilitata per la sincronizzazione delle impostazioni. Le app vengono identificate nell'elenco dal nome della famiglia di pacchetti e dal fatto che la sincronizzazione delle impostazioni deve essere abilitata o disabilitata per tale app. Quando usi queste impostazioni insieme all'impostazione Comportamento di sincronizzazione predefinito non in elenco, puoi controllare se le app di Windows sono sincronizzate.

Per visualizzare il nome della famiglia di pacchetti delle app di Windows installate, al prompt dei comandi di Windows PowerShell immettere:

Get-AppxPackage | Sort-Object PackageFamilyName | Format-Table PackageFamilyName

Per visualizzare un elenco di app di Windows in grado di sincronizzare le impostazioni in un computer con il nome della famiglia di pacchetti, lo stato abilitato e l'origine abilitata, al prompt dei comandi di Windows PowerShell immettere: Get-UevAppxPackage

Definizioni delle proprietà Get-UevAppxPackage

  • DisplayName: nome visualizzato dall'utente nell'applicazione Centro impostazioni società. La DisplayName proprietà è derivata dalla PackageFamilyName proprietà .

  • PackageFamilyName: nome del pacchetto installato per l'utente corrente.

  • Abilitato: definisce se le impostazioni per l'app sono configurate per la sincronizzazione.

  • EnabledSource: percorso in cui è impostata la configurazione che abilita o disabilita l'app. I valori possibili sono: NotSet, LocalMachine, LocalUser, PolicyMachine e PolicyUser.

  • NotSet: i criteri non sono configurati per sincronizzare l'app.

  • LocalMachine: lo stato abilitato è impostato nella sezione computer locale del Registro di sistema.

  • LocalUser: lo stato abilitato è impostato nella sezione utente corrente del Registro di sistema.

  • PolicyMachine: lo stato abilitato è impostato nella sezione dei criteri della sezione computer locale del Registro di sistema.

Per ottenere l'elenco di app di Windows configurato dall'utente, al prompt dei comandi di Windows PowerShell immettere: Get-UevAppxPackage -CurrentComputerUser

Per ottenere l'elenco di app di Windows configurato dal computer, al prompt dei comandi di Windows PowerShell immettere: Get-UevAppxPackage -Computer

Per entrambi i parametri, CurrentComputerUser o Computer, il cmdlet restituisce un elenco delle app di Windows configurate a livello di utente o computer.

Definizioni delle proprietà

  • DisplayName: nome visualizzato dall'utente nell'applicazione Centro impostazioni società. La DisplayName proprietà è derivata dalla PackageFamilyName proprietà .

  • PackageFamilyName: nome del pacchetto installato per l'utente corrente.

  • Abilitato: definisce se le impostazioni per l'app sono configurate per la sincronizzazione per l'opzione specificata, ovvero l'utente o il computer.

  • Installato: True, se PackageFamilyName è installato per l'utente corrente.

Gestire i modelli di percorso delle impostazioni UE-V 2 tramite WMI

UE-V fornisce il set di comandi WMI seguente. Gli amministratori possono usare queste interfacce per gestire i modelli di percorso delle impostazioni da Windows PowerShell e automatizzare le attività amministrative dei modelli.

  1. Usare un account con diritti di amministratore per aprire una finestra di Windows PowerShell.

  2. Usare i comandi WMI seguenti per registrare e gestire i modelli di percorso delle impostazioni UE-V.

    Comando di Windows PowerShell Descrizione
    Get-WmiObject -Namespace root\Microsoft\UEV SettingsLocationTemplate \ | Select-Object TemplateId,TemplateName, TemplateVersion,Enabled \ | Format-Table -Autosize Elenca tutti i modelli di percorso delle impostazioni registrati per il computer.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name GetProcessInfoByTemplateId <template Id> Ottiene il nome del programma e delle informazioni sulla versione, che dipende dal nome del modello.
    Get-WmiObject -Namespace root\Microsoft\UEV EffectiveWindows8App Ottiene l'elenco effettivo delle app di Windows.
    Get-WmiObject -Namespace root\Microsoft\UEV MachineConfiguredWindows8App Ottiene l'elenco di app di Windows configurate per il computer.
    Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguredWindows8App Ottiene l'elenco di app di Windows configurate per l'utente corrente.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Register -ArgumentList <template path> Registra un modello di posizione delle impostazioni con UE-V.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name UnregisterByTemplateId -ArgumentList <template ID> Annulla la registrazione di un modello di percorso delle impostazioni con UE-V. Non appena viene annullata la registrazione di un modello, UE-V non sincronizza più le impostazioni definite nel modello tra computer.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Update -ArgumentList <template path> Aggiorna un modello di percorso delle impostazioni con UE-V. Il nuovo modello deve essere una versione più recente di quella esistente.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name \ | package family name> Rimuove una o più app di Windows dall'elenco delle app di Windows del computer.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name RemoveApp -ArgumentList <package family name \ | package family name> Rimuove una o più app di Windows dall'elenco di app di Windows dell'utente corrente.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name DisableByTemplateId -ArgumentList <template ID> Disabilita uno o più modelli di posizione delle impostazioni con UE-V.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name DisableApp -ArgumentList <package family name \ | package family name> Disabilita una o più app di Windows nell'elenco delle app di Windows del computer.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name DisableApp -ArgumentList <package family name \ | package family name> Disabilita una o più app di Windows nell'elenco delle app di Windows dell'utente corrente.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name EnableByTemplateId -ArgumentList <template ID> Abilita un modello di posizione delle impostazioni con UE-V.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class MachineConfiguredWindows8App -Name EnableApp -ArgumentList <package family name \ | package family name> Abilita le app di Windows nell'elenco delle app di Windows del computer.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserConfiguredWindows8App -Name EnableApp -ArgumentList <package family name \ | package family name> Abilita le app di Windows nell'elenco delle app di Windows dell'utente corrente.
    Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name Validate -ArgumentList <template path> Determina se un modello di percorso delle impostazioni specificato è conforme al relativo XML Schema.

Nota

Se un elenco di nomi di famiglia di pacchetti viene chiamato dal comando WMI, l'elenco deve essere racchiuso tra virgolette e separato da un simbolo di pipe, ad esempio . "<package family name | package family name>"

Distribuzione dell'agente UE-V tramite Windows PowerShell

  1. Preparare il pacchetto di installazione dell'agente UE-V in una condivisione di rete accessibile.

    Nota

    Usare AgentSetup.exe per distribuire sia le versioni a 32 bit che a 64 bit dell'agente UE-V. I pacchetti di Windows Installer, AgentSetupx86.msi e AgentSetupx64.msi, sono disponibili per ogni architettura. Per disinstallare l'agente UE-V in un secondo momento usando il file di installazione, è necessario usare lo stesso tipo di file.

  2. Per installare l'agente UE-V, usare uno dei comandi di Windows PowerShell seguenti.

    & AgentSetup.exe /quiet /norestart /log "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\\server\settingsshare\%username%

    & msiexec.exe /i "<path to msi file>" /quiet /norestart /l*v "%temp%\UE-VAgentInstaller.log" SettingsStoragePath=\\server\settingsshare\%username%

Amministrazione di UE-V 2.1 SP1 con Windows PowerShell e WMI

Amministrazione di UE-V 2.1 SP1