Windows PowerShell 및 WMI를 사용하여 UE-V 2.1 SP1 에이전트 및 패키지 관리
WMI(Windows Management Instrumentation) 및 Windows PowerShell을 사용하여 Microsoft UE-V(사용자 환경 가상화) 2.1 SP1 에이전트 구성 및 동기화 동작을 관리할 수 있습니다. UE-V PowerShell cmdlet의 전체 목록은 MDOP cmdlet 참조를 참조하세요.
Windows PowerShell을 사용하여 UE-V 에이전트를 배포하려면
액세스 가능한 네트워크 공유에서 UE-V 설치 관리자 파일을 스테이징합니다.
참고
AgentSetup.exe 사용하여 32비트 및 64비트 버전의 UE-V 에이전트를 모두 배포합니다. AgentSetupx86.msi 및 AgentSetupx64.msi Windows Installer 패키지는 각 아키텍처에 사용할 수 있습니다. 설치 파일을 사용하여 나중에 UE-V 에이전트를 제거하려면 동일한 파일 형식을 사용해야 합니다.
UE-V 에이전트를 설치하려면 다음 Windows PowerShell 명령 중 하나를 사용합니다.
& 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%
Windows PowerShell을 사용하여 UE-V 에이전트를 구성하려면
Windows PowerShell 창을 엽니다. 컴퓨터 매개 변수를 사용하여 컴퓨터의 모든 사용자에게 영향을 주는 컴퓨터 설정을 관리하려면 관리자 권한이 있는 계정으로 창을 엽니다.
다음 Windows PowerShell 명령을 사용하여 에이전트를 구성합니다.
| Windows PowerShell 명령 | 설명 |
|---|---|
Get-UevConfiguration |
유효한 UE-V 에이전트 설정을 가져옵니다. 사용자별 설정은 컴퓨터 설정보다 우선합니다. |
Get-UevConfiguration -CurrentComputerUser |
현재 사용자에 대해서만 UE-V 에이전트 설정 값을 가져옵니다. |
Get-UevConfiguration -Computer |
컴퓨터의 모든 사용자에 대한 UE-V 에이전트 구성 설정 값을 가져옵니다. |
Get-UevConfiguration -Details |
각 구성 설정에 대한 세부 정보를 가져옵니다. 설정이 구성된 위치 또는 기본값을 사용하는 경우 를 표시합니다. 현재 설정이 유효한 경우 가 표시됩니다. |
Set-UevConfiguration -Computer -ContactITDescription <IT description> |
도움말 링크에 대한 회사 설정 센터에 표시되는 텍스트를 설정합니다. |
Set-UevConfiguration -Computer -ContactITUrl <string> |
도움말 링크에 대한 회사 설정 센터의 링크 URL을 설정합니다. 모든 URL 프로토콜을 사용할 수 있습니다. |
Set-UevConfiguration -Computer -EnableDontSyncWindows8AppSettings |
컴퓨터의 모든 사용자에 대해 Windows 앱을 동기화하지 않도록 UE-V 에이전트를 구성합니다. |
Set-UevConfiguration -CurrentComputerUser -EnableDontSyncWindows8AppSettings |
현재 컴퓨터 사용자에 대한 Windows 앱을 동기화하지 않도록 UE-V 에이전트를 구성합니다. |
Set-UevConfiguration -Computer -EnableFirstUseNotification |
컴퓨터의 모든 사용자에 대해 에이전트를 처음 실행할 때 알림을 표시하도록 UE-V 에이전트를 구성합니다. |
Set-UevConfiguration -Computer -DisableFirstUseNotification |
컴퓨터의 모든 사용자에 대해 에이전트가 처음 실행되는 알림을 표시하지 않도록 UE-V 에이전트를 구성합니다. |
Set-UevConfiguration -Computer -EnableSettingsImportNotify |
설정 동기화가 지연될 때 컴퓨터의 모든 사용자에게 알리도록 UE-V 에이전트를 구성합니다. DisableSettingsImportNotify 매개 변수를 사용하여 알림을 사용하지 않도록 설정합니다. |
Set-UevConfiguration -CurrentComputerUser -EnableSettingsImportNotify |
설정 동기화가 지연될 때 현재 사용자에게 알리도록 UE-V 에이전트를 구성합니다. DisableSettingsImportNotify 매개 변수를 사용하여 알림을 사용하지 않도록 설정합니다. |
Set-UevConfiguration -Computer -EnableSyncUnlistedWindows8Apps |
컴퓨터의 모든 사용자에 대해 Windows 앱 목록에서 명시적으로 사용하지 않도록 설정되지 않은 모든 Windows 앱을 동기화하도록 UE-V 에이전트를 구성합니다. 매개 변수를 DisableSyncUnlistedWindows8Apps 사용하여 Windows 앱 목록에서 명시적으로 사용하도록 설정된 Windows 앱만 동기화하도록 UE-V 에이전트를 구성합니다. |
Set-UevConfiguration -CurrentComputerUser -EnableSyncUnlistedWindows8Apps |
컴퓨터의 현재 사용자에 대한 Windows 앱 목록에서 명시적으로 사용하지 않도록 설정되지 않은 모든 Windows 앱을 동기화하도록 UE-V 에이전트를 구성합니다. 매개 변수를 DisableSyncUnlistedWindows8Apps 사용하여 Windows 앱 목록에서 명시적으로 사용하도록 설정된 Windows 앱만 동기화하도록 UE-V 에이전트를 구성합니다. |
Set-UevConfiguration -Computer -DisableSync |
컴퓨터의 모든 사용자에 대해 UE-V를 사용하지 않도록 설정합니다. EnableSync 매개 변수를 사용하여 사용하거나 다시 사용하도록 설정합니다. |
Set-UevConfiguration -CurrentComputerUser -DisableSync |
컴퓨터의 현재 사용자에 대해 UE-V를 사용하지 않도록 설정합니다. EnableSync 매개 변수를 사용하여 사용하거나 다시 사용하도록 설정합니다. |
Set-UevConfiguration -Computer -EnableTrayIcon |
컴퓨터의 모든 사용자에 대해 알림 영역에서 UE-V 아이콘을 사용하도록 설정합니다. DisableTrayIcon 매개 변수를 사용하여 아이콘을 사용하지 않도록 설정합니다. |
Set-UevConfiguration -Computer -MaxPackageSizeInBytes <size in bytes> |
설정 패키지 파일 크기가 컴퓨터의 모든 사용자에 대해 정의된 임계값에 도달할 때 보고하도록 UE-V 에이전트를 구성합니다. 임계값 패키지 크기를 바이트 단위로 설정합니다. |
Set-UevConfiguration -CurrentComputerUser -MaxPackageSizeInBytes <size in bytes> |
설정 패키지 파일 크기가 정의된 임계값에 도달할 때 보고하도록 UE-V 에이전트를 구성합니다. 현재 사용자의 패키지 크기 경고 임계값을 설정합니다. |
Set-UevConfiguration -Computer -SettingsImportNotifyDelayInSeconds |
컴퓨터의 모든 사용자에 대해 사용자에게 알림을 받을 때까지의 시간(초)을 지정합니다. |
Set-UevConfiguration -CurrentComputerUser -SettingsImportNotifyDelayInSeconds |
현재 사용자에 대한 알림이 전송되기 전의 시간(초)을 지정합니다. |
Set-UevConfiguration -Computer -SettingsStoragePath <path to settings storage location> |
컴퓨터의 모든 사용자에 대한 컴퓨터별 설정 스토리지 위치를 정의합니다. |
Set-UevConfiguration -CurrentComputerUser -SettingsStoragePath <path to settings storage location> |
사용자별 설정 스토리지 위치를 정의합니다. |
Set-UevConfiguration -Computer -SettingsTemplateCatalogPath <path to catalog> |
컴퓨터의 모든 사용자에 대한 설정 템플릿 카탈로그 경로를 설정합니다. |
Set-UevConfiguration -Computer -SyncMethod <sync method> |
컴퓨터의 모든 사용자에 대한 동기화 방법(SyncProvider 또는 None)을 설정합니다. |
Set-UevConfiguration -CurrentComputerUser -SyncMethod <sync method> |
현재 사용자의 동기화 메서드인 SyncProvider 또는 None을 설정합니다. |
Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds <timeout in milliseconds> |
컴퓨터의 모든 사용자에 대한 동기화 시간 제한(밀리초)을 설정합니다. |
Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds <timeout in milliseconds> |
현재 사용자의 동기화 제한 시간을 설정합니다. |
Clear-UevConfiguration -Computer -<setting name> |
컴퓨터의 모든 사용자에 대해 지정된 설정을 지웁니다. |
Clear-UevConfiguration -CurrentComputerUser -<setting name> |
현재 사용자에 대해서만 지정된 설정을 지웁니다. |
Export-UevConfiguration <settings migration file> |
UE-V 컴퓨터 구성을 설정 마이그레이션 파일로 내보냅니다. 파일 이름 확장명은 이어야 .uev합니다.
내보내기 cmdlet은 Computer 매개 변수를 사용하여 구성할 수 있는 모든 UE-V 에이전트 설정을 내보냅니다. |
Import-UevConfiguration <settings migration file> |
설정 마이그레이션 파일에서 UE-V 컴퓨터 구성을 가져옵니다. 파일 이름 확장명은 이어야 .uev합니다. |
Windows PowerShell을 사용하여 UE-V 패키지 설정을 내보내고 UE-V 템플릿을 복구하려면
관리자 권한으로 Windows PowerShell 창을 엽니다.
다음 Windows PowerShell 명령을 사용하여 에이전트를 구성합니다.
Windows PowerShell 명령 설명 MicrosoftCalculator6.pkgx Export-UevPackage Microsoft 계산기 패키지 파일에서 설정을 추출하고 XML에서 사람이 읽을 수 있는 형식으로 변환합니다. Repair-UevTemplateIndex UE-V 설정 위치 템플릿의 인덱스를 복구합니다.
WMI를 사용하여 UE-V 에이전트를 구성하려면
사용자 환경 가상화는 다음과 같은 WMI 명령 집합을 제공합니다. 관리자는 이 인터페이스를 사용하여 명령줄에서 UE-V 에이전트를 구성하고 일반적인 구성 작업을 자동화할 수 있습니다.
관리자 권한이 있는 계정을 사용하여 Windows PowerShell 창을 엽니다.
다음 WMI 명령을 사용하여 에이전트를 구성합니다.
Windows PowerShell 명령 설명 Get-WmiObject -Namespace root\Microsoft\UEV Configuration활성 UE-V 에이전트 설정을 표시합니다. 사용자별 설정은 컴퓨터 설정보다 우선합니다. Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration사용자에 대해 정의된 UE-V 에이전트 구성을 표시합니다. Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration컴퓨터에 대해 정의된 UE-V 에이전트 구성을 표시합니다. Get-WmiObject -Namespace root\Microsoft\Uev ConfigurationItem각 구성 항목에 대한 세부 정보를 표시합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.SettingsStoragePath = <path_to_settings_storage_location>$config.Put()컴퓨터별 설정 스토리지 위치를 정의합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV UserConfiguration$config.SettingsStoragePath = <path_to_settings_storage_location>$config.Put()사용자별 설정 스토리지 위치를 정의합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.SyncTimeoutInMilliseconds = <timeout_in_milliseconds>$config.Put()컴퓨터의 모든 사용자에 대한 동기화 시간 제한(밀리초)을 설정합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.MaxPackageSizeInBytes = <size_in_bytes>$config.Put()설정 패키지 파일 크기가 정의된 임계값에 도달할 때 보고하도록 UE-V 에이전트를 구성합니다. 컴퓨터의 모든 사용자에 대해 임계값 패키지 파일 크기를 바이트 단위로 설정합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.SyncMethod = <sync_method>$config.Put()컴퓨터의 모든 사용자에 대한 동기화 방법(SyncProvider 또는 None)을 설정합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.<setting name> = $true$config.Put()특정 컴퓨터별 설정을 사용하도록 설정하려면 설정을 지우고 $null 설정 값으로 사용합니다. 사용자별 설정에 UserConfiguration을 사용합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.<setting name> = $false$config.Put()특정 컴퓨터별 설정을 사용하지 않도록 설정하려면 설정을 지우고 $null 설정 값으로 사용합니다. 사용자별 설정에 사용자 구성을 사용합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.<setting name> = <setting value>$config.Put()컴퓨터별 특정 설정을 업데이트합니다. 설정을 지우려면 $null 설정 값으로 사용합니다. $config = Get-WmiObject -Namespace root\Microsoft\UEV ComputerConfiguration$config.<setting name> = <setting value>$config.Put()컴퓨터의 모든 사용자에 대한 특정 사용자별 설정을 업데이트합니다. 설정을 지우려면 $null 설정 값으로 사용합니다.
WMI 및 Windows PowerShell을 사용하여 UE-V 에이전트를 구성하면 정의된 구성이 다음 위치의 레지스트리에 저장됩니다.
\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\UEV\Agent\Configuration
\HKEY_CURRENT_USER\SOFTWARE\Microsoft\UEV\Agent\Configuration
WMI를 사용하여 UE-V 패키지 설정을 내보내고 UE-V 템플릿을 복구하려면
UE-V는 다음과 같은 WMI 명령 집합을 제공합니다. 관리자는 이 인터페이스를 사용하여 패키지를 내보내거나 UE-V 템플릿을 복구할 수 있습니다.
다음 WMI 명령을 사용합니다.
WMI 명령 설명 Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class UserSettings -Name ExportPackage -ArgumentList <package name>패키지 파일에서 설정을 추출하고 XML에서 사람이 읽을 수 있는 형식으로 변환합니다. Invoke-WmiMethod -Namespace root\Microsoft\UEV -Class SettingsLocationTemplate -Name RebuildIndexUE-V 설정 위치 템플릿의 인덱스를 복구합니다. 관리자 권한으로 실행해야 합니다.