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 3000

This 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 3000

This 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 3000

This 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 700000

This 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