Edit

Share via

Set-UevConfiguration

Module:
UEV Module

Modifies UE-V configuration settings.

Syntax

ParameterSetUser (Default) 

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>]

ParameterSetComputer 

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetComputer
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ContactITDescription

Specifies a description for the Contact IT link.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetComputer
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ContactITUrl

Specifies a URL for the Contact IT link.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetComputer
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CurrentComputerUser

Indicates that the cmdlet modifies the settings that you specify for the current user only.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetUser
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableFirstUseNotification

Indicates that the cmdlet disables the notification of first-use.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetComputer
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableSync

Indicates that the cmdlet disables the synchronization of settings. If you specify this parameter, UE-V stops the synchronization of settings.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableSyncOverMeteredNetwork

Indicates that the cmdlet disables the synchronization of settings over metered connections.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableSyncUnlistedWindows8Apps

Indicates that the cmdlet disables the synchronization of unlisted Windows 8 apps.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableTrayIcon

Indicates that the cmdlet disables the icon in the notification area.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetComputer
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWaitForSyncOnApplicationStart

Indicates that the cmdlet disables UE-V from waiting for synchronization to finish before the user can start an application.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DisableWaitForSyncOnLogon

For internal use only.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableFirstUseNotification

Indicates that the cmdlet enables first use notification.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetComputer
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableSyncOverMeteredNetwork

Indicates that the cmdlet enables the synchronization of settings over metered connections.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableSyncUnlistedWindows8Apps

Indicates that the cmdlet enables the synchronization of unlisted Windows 8 apps.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableTrayIcon

Indicates that the cmdlet enables the icon in the notification area.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetComputer
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableWaitForSyncOnApplicationStart

For internal use only.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EnableWaitForSyncOnLogon

For internal use only.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SettingsImportNotifyDelayInSeconds

Specifies the time, in seconds, before UE-V notifies the user about the settings import.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SettingsStoragePath

Specifies the path of the location where UE-V stores the user settings.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SettingsTemplateCatalogPath

Specifies the path of the location where UE-V stores the settings template catalog.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ParameterSetComputer
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SyncMethod

Specifies the method for the synchronization of settings. Valid values are:

  • SyncProvider
  • None

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SyncTimeoutInMilliseconds

Specifies the time, in milliseconds, before UE-V synchronizes settings from the settings repository.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments: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.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WaitForSyncTimeoutInMilliseconds

For internal use only.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.