Set-UevConfiguration
Modifies UE-V configuration settings.
Syntax
Set-UevConfiguration
[-CurrentComputerUser]
[-MaxPackageSizeInBytes <Int32>]
[-SettingsStoragePath <String>]
[-EnableSyncProviderPing]
[-DisableSyncProviderPing]
[-SyncTimeoutInMilliseconds <Int32>]
[-SyncMethod <String>]
[-EnableSync]
[-DisableSync]
[-EnableSyncOverMeteredNetwork]
[-DisableSyncOverMeteredNetwork]
[-EnableSyncOverMeteredNetworkWhenRoaming]
[-DisableSyncOverMeteredNetworkWhenRoaming]
[-EnableSettingsImportNotify]
[-DisableSettingsImportNotify]
[-SettingsImportNotifyDelayInSeconds <Int32>]
[-EnableDontSyncWindows8AppSettings]
[-DisableDontSyncWindows8AppSettings]
[-WaitForSyncTimeoutInMilliseconds <Int32>]
[-EnableWaitForSyncOnApplicationStart]
[-DisableWaitForSyncOnApplicationStart]
[-EnableWaitForSyncOnLogon]
[-DisableWaitForSyncOnLogon]
[-EnableSyncUnlistedWindows8Apps]
[-DisableSyncUnlistedWindows8Apps]
[-VdiCollectionName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-UevConfiguration
[-Computer]
[-MaxPackageSizeInBytes <Int32>]
[-SettingsStoragePath <String>]
[-SettingsTemplateCatalogPath <String>]
[-EnableSyncProviderPing]
[-DisableSyncProviderPing]
[-SyncTimeoutInMilliseconds <Int32>]
[-SyncMethod <String>]
[-EnableSync]
[-DisableSync]
[-EnableSyncOverMeteredNetwork]
[-DisableSyncOverMeteredNetwork]
[-EnableSyncOverMeteredNetworkWhenRoaming]
[-DisableSyncOverMeteredNetworkWhenRoaming]
[-EnableSettingsImportNotify]
[-DisableSettingsImportNotify]
[-SettingsImportNotifyDelayInSeconds <Int32>]
[-ContactITUrl <String>]
[-ContactITDescription <String>]
[-EnableTrayIcon]
[-DisableTrayIcon]
[-EnableFirstUseNotification]
[-DisableFirstUseNotification]
[-EnableDontSyncWindows8AppSettings]
[-DisableDontSyncWindows8AppSettings]
[-WaitForSyncTimeoutInMilliseconds <Int32>]
[-EnableWaitForSyncOnApplicationStart]
[-DisableWaitForSyncOnApplicationStart]
[-EnableWaitForSyncOnLogon]
[-DisableWaitForSyncOnLogon]
[-EnableSyncUnlistedWindows8Apps]
[-DisableSyncUnlistedWindows8Apps]
[-VdiCollectionName <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
The Set-UevConfiguration cmdlet modifies Microsoft User Experience Virtualization (UE-V) configuration settings. If you specify the CurrentComputerUser parameter, the cmdlet changes the settings that you specify for the current user only. If you specify the Computer parameter, the cmdlet clears the settings that you specify for all users on the computer. You must have administrative credentials to use this cmdlet to modify settings for all users on the computer. If you do not specify the CurrentComputerUser or Computer parameter, the cmdlet changes the settings that you specify for the current user only.
Examples
Example 1: Modify the synchronization timeout setting for all users
PS C:\> Set-UevConfiguration -Computer -SyncTimeoutInMilliseconds 3000This command modifies the synchronization timeout setting to three seconds for all users on the computer.
Example 2: Modify the synchronization timeout setting for the current user
PS C:\> Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds 3000This command modifies the synchronization timeout setting to three seconds for the current user on the computer.
Example 3: Modify the synchronization timeout setting for the current user by default
PS C:\> Set-UevConfiguration -SyncTimeoutInMilliseconds 3000This command modifies the synchronization timeout setting to three seconds by default for the current user on the computer.
Example 4: Modify multiple settings for the current user
PS C:\> Set-UevConfiguration -CurrentComputerUser -SyncTimeoutInMilliseconds 5000 -MaxPackageSizeInBytes 700000This command modifies the settings for the synchronization timeout and maximum package size for the current user on the computer.
Parameters
-Computer
Indicates that the cmdlet changes the settings that you specify for all users on the computer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Prompts you for confirmation before running the cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContactITDescription
Specifies a description for the Contact IT link.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContactITUrl
Specifies a URL for the Contact IT link.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CurrentComputerUser
Indicates that the cmdlet modifies the settings that you specify for the current user only.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableDontSyncWindows8AppSettings
Indicates that the cmdlet disables the setting for not synchronizing Windows® 8 app settings. If you specify this parameter, UE-V synchronizes Windows 8 app settings.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableFirstUseNotification
Indicates that the cmdlet disables the notification of first-use.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableSettingsImportNotify
Indicates that the cmdlet disables the notification of settings import. If you specify this parameter, UE-V does not notify the user about the settings import.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableSync
Indicates that the cmdlet disables the synchronization of settings. If you specify this parameter, UE-V stops the synchronization of settings.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableSyncOverMeteredNetwork
Indicates that the cmdlet disables the synchronization of settings over metered connections.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableSyncOverMeteredNetworkWhenRoaming
Indicates that the cmdlet disables the synchronization of settings over metered connections outside of the home provider network, for example, when connected by using a roaming connection.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableSyncProviderPing
Indicates that the cmdlet disables the synchronization provider from pinging the network before it synchronizes. If you specify this parameter, UE-V attempts to synchronize settings, even if the network is not available.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableSyncUnlistedWindows8Apps
Indicates that the cmdlet disables the synchronization of unlisted Windows 8 apps.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableTrayIcon
Indicates that the cmdlet disables the icon in the notification area.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWaitForSyncOnApplicationStart
Indicates that the cmdlet disables UE-V from waiting for synchronization to finish before the user can start an application.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWaitForSyncOnLogon
For internal use only.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableDontSyncWindows8AppSettings
Indicates that the cmdlet enables the setting for not synchronizing Windows 8 app settings. If you specify this parameter, UE-V does not synchronize Windows 8 app settings.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableFirstUseNotification
Indicates that the cmdlet enables first use notification.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSettingsImportNotify
Indicates that the cmdlet enables the notification for settings import. If the settings import takes longer than the amount of time that you specify for the SettingsImportNotifyDelayInSecond parameter, UE-V notifies the user.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSync
Indicates that the cmdlet enables the synchronization of settings. UE-V synchronizes the settings that are defined in the settings location templates that you have enabled.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSyncOverMeteredNetwork
Indicates that the cmdlet enables the synchronization of settings over metered connections.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSyncOverMeteredNetworkWhenRoaming
Indicates that the cmdlet enables the synchronization of settings over metered connections outside of the home provider network, for example, when connected by using a roaming connection.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSyncProviderPing
Indicates that the cmdlet enables the synchronization provider to ping for network accessibility. If you specify this parameter, UE-V attempts to synchronize settings only if the network is available.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableSyncUnlistedWindows8Apps
Indicates that the cmdlet enables the synchronization of unlisted Windows 8 apps.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableTrayIcon
Indicates that the cmdlet enables the icon in the notification area.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableWaitForSyncOnApplicationStart
For internal use only.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableWaitForSyncOnLogon
For internal use only.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxPackageSizeInBytes
Specifies the maximum package size, in bytes. If the size of a package exceeds the value that you specify, UE-V logs a warning.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SettingsImportNotifyDelayInSeconds
Specifies the time, in seconds, before UE-V notifies the user about the settings import.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SettingsStoragePath
Specifies the path of the location where UE-V stores the user settings.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SettingsTemplateCatalogPath
Specifies the path of the location where UE-V stores the settings template catalog.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SyncMethod
Specifies the method for the synchronization of settings. Valid values are:
- SyncProvider
- None
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SyncTimeoutInMilliseconds
Specifies the time, in milliseconds, before UE-V synchronizes settings from the settings repository.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VdiCollectionName
Specifies the name of the collection of computers that should share/sync settings. Specify this parameter when you are performing synchronization in a pooled VDI-type environment when computers are not persistent.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WaitForSyncTimeoutInMilliseconds
For internal use only.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |