Set-CMUserDataAndProfileConfigurationItem
Set-CMUserDataAndProfileConfigurationItem
Modifies a user data and profile configuration item.
Syntax
Parameter Set: SetByName
Set-CMUserDataAndProfileConfigurationItem -Name <String[]> [-AccessPolicy <Boolean> ] [-AddAdminGroupToRUPEnabled <Boolean> ] [-AllowAllDevice <Boolean> ] [-AllowCrossForestUserPolicy <Boolean> ] [-BackgroundSynchronization <SynchronizationType> {Disabled | Enabled | NotConfigured} ] [-ConfigureFolderRedirection <Boolean> ] [-ConfigureOffineFile <Boolean> ] [-ConfigureRoamingUserProfile <Boolean> ] [-ConnectionTransferRate <Int32> ] [-DeleteProfileOlderDays <Int32> ] [-DeleteRoamingCacheEnabled <Boolean> ] [-Description <String> ] [-DetectSlowLink <Boolean> ] [-DeviceType <DeviceType> {FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly | OnAnyDevice | OnlyOnPrimaryDevices} ] [-DisableMakeOffline <Boolean> ] [-DisableWorkOffline <Boolean> ] [-EnableOfflineFile <Boolean> ] [-EnableSlowLink <Boolean> ] [-ErrorDays <Int32> ] [-ExcludeList <String[]> ] [-FileSynchronization <SynchronizationType> {Disabled | Enabled | NotConfigured} ] [-FolderRedirectionUserConfigurationForApplicationData <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForContacts <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDesktop <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDocuments <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDownloads <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForFavorites <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForLinks <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForMusic <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForPictures <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForSavedGames <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForSearches <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForStartMenu <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForVideos <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-ForceUnloadDisabled <Boolean> ] [-GrantExclusiveRight <Boolean> ] [-LeaveFolderNewLocation <Boolean> ] [-LimitDisk <Int32> ] [-ManageAdvancedSetting <Boolean> ] [-ManageSlowLink <Boolean> ] [-MoveCachedFolder <Boolean> ] [-MoveContent <Boolean> ] [-NewName <String> ] [-OfflineFile <String[]> ] [-OnlyAllowLocalProfiles <Boolean> ] [-OwnerCheckDisabled <Boolean> ] [-ProfileUploadDisabled <Boolean> ] [-SlowLink <Int32> ] [-SlowLinkUIEnabled <Boolean> ] [-SpecifiedLocation <String> ] [-SpecifyTime <String> ] [-SpecifyTimeInterval <Int32> ] [-SynchronizationInterval <Int32> ] [-SynchronizationList <String[]> ] [-SynchronizationPolicy <Boolean> ] [-TempProfileLogonBlocked <Boolean> ] [-TimeOut <Int32> ] [-UseCommonAlert <Boolean> ] [-UseSpecifiedLocation <Boolean> ] [-WaitForNetworkInSeconds <Int32> ] [-WarningDays <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetById
Set-CMUserDataAndProfileConfigurationItem -Id <String[]> [-AccessPolicy <Boolean> ] [-AddAdminGroupToRUPEnabled <Boolean> ] [-AllowAllDevice <Boolean> ] [-AllowCrossForestUserPolicy <Boolean> ] [-BackgroundSynchronization <SynchronizationType> {Disabled | Enabled | NotConfigured} ] [-ConfigureFolderRedirection <Boolean> ] [-ConfigureOffineFile <Boolean> ] [-ConfigureRoamingUserProfile <Boolean> ] [-ConnectionTransferRate <Int32> ] [-DeleteProfileOlderDays <Int32> ] [-DeleteRoamingCacheEnabled <Boolean> ] [-Description <String> ] [-DetectSlowLink <Boolean> ] [-DeviceType <DeviceType> {FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly | OnAnyDevice | OnlyOnPrimaryDevices} ] [-DisableMakeOffline <Boolean> ] [-DisableWorkOffline <Boolean> ] [-EnableOfflineFile <Boolean> ] [-EnableSlowLink <Boolean> ] [-ErrorDays <Int32> ] [-ExcludeList <String[]> ] [-FileSynchronization <SynchronizationType> {Disabled | Enabled | NotConfigured} ] [-FolderRedirectionUserConfigurationForApplicationData <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForContacts <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDesktop <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDocuments <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDownloads <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForFavorites <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForLinks <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForMusic <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForPictures <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForSavedGames <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForSearches <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForStartMenu <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForVideos <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-ForceUnloadDisabled <Boolean> ] [-GrantExclusiveRight <Boolean> ] [-LeaveFolderNewLocation <Boolean> ] [-LimitDisk <Int32> ] [-ManageAdvancedSetting <Boolean> ] [-ManageSlowLink <Boolean> ] [-MoveCachedFolder <Boolean> ] [-MoveContent <Boolean> ] [-NewName <String> ] [-OfflineFile <String[]> ] [-OnlyAllowLocalProfiles <Boolean> ] [-OwnerCheckDisabled <Boolean> ] [-ProfileUploadDisabled <Boolean> ] [-SlowLink <Int32> ] [-SlowLinkUIEnabled <Boolean> ] [-SpecifiedLocation <String> ] [-SpecifyTime <String> ] [-SpecifyTimeInterval <Int32> ] [-SynchronizationInterval <Int32> ] [-SynchronizationList <String[]> ] [-SynchronizationPolicy <Boolean> ] [-TempProfileLogonBlocked <Boolean> ] [-TimeOut <Int32> ] [-UseCommonAlert <Boolean> ] [-UseSpecifiedLocation <Boolean> ] [-WaitForNetworkInSeconds <Int32> ] [-WarningDays <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: SetByValue
Set-CMUserDataAndProfileConfigurationItem -InputObject <IResultObject> [-AccessPolicy <Boolean> ] [-AddAdminGroupToRUPEnabled <Boolean> ] [-AllowAllDevice <Boolean> ] [-AllowCrossForestUserPolicy <Boolean> ] [-BackgroundSynchronization <SynchronizationType> {Disabled | Enabled | NotConfigured} ] [-ConfigureFolderRedirection <Boolean> ] [-ConfigureOffineFile <Boolean> ] [-ConfigureRoamingUserProfile <Boolean> ] [-ConnectionTransferRate <Int32> ] [-DeleteProfileOlderDays <Int32> ] [-DeleteRoamingCacheEnabled <Boolean> ] [-Description <String> ] [-DetectSlowLink <Boolean> ] [-DeviceType <DeviceType> {FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly | OnAnyDevice | OnlyOnPrimaryDevices} ] [-DisableMakeOffline <Boolean> ] [-DisableWorkOffline <Boolean> ] [-EnableOfflineFile <Boolean> ] [-EnableSlowLink <Boolean> ] [-ErrorDays <Int32> ] [-ExcludeList <String[]> ] [-FileSynchronization <SynchronizationType> {Disabled | Enabled | NotConfigured} ] [-FolderRedirectionUserConfigurationForApplicationData <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForContacts <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDesktop <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDocuments <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForDownloads <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForFavorites <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForLinks <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForMusic <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForPictures <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForSavedGames <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForSearches <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForStartMenu <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-FolderRedirectionUserConfigurationForVideos <FolderRedirectionType> {DoNotManage | RedirectToLocal | RedirectToRemote} ] [-ForceUnloadDisabled <Boolean> ] [-GrantExclusiveRight <Boolean> ] [-LeaveFolderNewLocation <Boolean> ] [-LimitDisk <Int32> ] [-ManageAdvancedSetting <Boolean> ] [-ManageSlowLink <Boolean> ] [-MoveCachedFolder <Boolean> ] [-MoveContent <Boolean> ] [-NewName <String> ] [-OfflineFile <String[]> ] [-OnlyAllowLocalProfiles <Boolean> ] [-OwnerCheckDisabled <Boolean> ] [-ProfileUploadDisabled <Boolean> ] [-SlowLink <Int32> ] [-SlowLinkUIEnabled <Boolean> ] [-SpecifiedLocation <String> ] [-SpecifyTime <String> ] [-SpecifyTimeInterval <Int32> ] [-SynchronizationInterval <Int32> ] [-SynchronizationList <String[]> ] [-SynchronizationPolicy <Boolean> ] [-TempProfileLogonBlocked <Boolean> ] [-TimeOut <Int32> ] [-UseCommonAlert <Boolean> ] [-UseSpecifiedLocation <Boolean> ] [-WaitForNetworkInSeconds <Int32> ] [-WarningDays <Int32> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-CMUserDataAndProfileConfigurationItem cmdlet modifies a user data and profile configuration item that can apply to Windows 8 computers. A configuration item can manage folder redirection, offline folders, and roaming user profiles. You can create a configuration item by using the New-CMUserDataAndProfileConfigurationItem cmdlet.
Parameters
-AccessPolicy<Boolean>
Indicates whether this configuration item manages profile access settings for roaming profiles.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AddAdminGroupToRUPEnabled<Boolean>
Indicates whether to grant the Administrators group access to roaming profile folders.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AllowAllDevice<Boolean>
Indicates whether to allow roaming profiles on all devices. If this value is $False, roaming profiles apply only to the primary device for a user.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-AllowCrossForestUserPolicy<Boolean>
Indicates whether to permit user policies to roam across Active Directory forests that have a trust relationship with the current forest.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-BackgroundSynchronization<SynchronizationType>
Specifies a background synchronization type for file in offline mode. The acceptable values for this parameter are: Disabled, Enabled, and NotConfigured.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ConfigureFolderRedirection<Boolean>
Indicates whether the configuration item includes settings for folder redirection.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ConfigureOffineFile<Boolean>
Indicates whether the configuration item includes settings for offline folders.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ConfigureRoamingUserProfile<Boolean>
Indicates whether the configuration item includes settings for roaming user profiles.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ConnectionTransferRate<Int32>
Specifies a connection transfer rate.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeleteProfileOlderDays<Int32>
Specifies the number of days to keep a user profile since the last time someone used it. A computer deletes an older profile when it restarts.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeleteRoamingCacheEnabled<Boolean>
Indicates whether to delete cached copies of roaming user profiles. The default for this parameter is $False.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Description<String>
Specifies a description for the configuration item.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DetectSlowLink<Boolean>
Indicates whether to detect slow links.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DeviceType<DeviceType>
Specifies the applicability of folder redirection for user devices. The acceptable values for this parameter are:
-- FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly. Folder redirection for any user device, but caching only on the primary device for a user.
-- OnAnyDevice. Folder redirection and caching on any device.
-- OnlyOnPrimaryDevices. Folder redirection and caching on the primary device for a user.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DisableMakeOffline<Boolean>
Indicates whether users can disable the Make Available Offline command.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-DisableWorkOffline<Boolean>
Indicates whether users can disable the Work Offline command.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EnableOfflineFile<Boolean>
Indicates whether this configuration item enables use of offline files.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-EnableSlowLink<Boolean>
Indicates whether the configuration enables work with offline files over a slow link.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ErrorDays<Int32>
Specifies the number of days to wait before the profile creates an error.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ExcludeList<String[]>
Specifies an array of folders. The configuration item excludes these folders from roaming profiles.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FileSynchronization<SynchronizationType>
Specifies a file synchronization type for metered networks for work in offline mode. The acceptable values for this parameter are: Disabled, Enabled, and NotConfigured.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForApplicationData<FolderRedirectionType>
Specifies whether to redirect the Application Data folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForContacts<FolderRedirectionType>
Specifies whether to redirect the Contacts folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForDesktop<FolderRedirectionType>
Specifies whether to redirect the Desktop to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForDocuments<FolderRedirectionType>
Specifies whether to redirect the Documents folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForDownloads<FolderRedirectionType>
Specifies whether to redirect the Downloads folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForFavorites<FolderRedirectionType>
Specifies whether to redirect the Favorites folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForLinks<FolderRedirectionType>
Specifies whether to redirect the Links folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForMusic<FolderRedirectionType>
Specifies whether to redirect the Music folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForPictures<FolderRedirectionType>
Specifies whether to redirect the Pictures folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForSavedGames<FolderRedirectionType>
Specifies whether to redirect the Saved Games folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForSearches<FolderRedirectionType>
Specifies whether to redirect the Searches folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForStartMenu<FolderRedirectionType>
Specifies whether to redirect the Start Menu to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-FolderRedirectionUserConfigurationForVideos<FolderRedirectionType>
Specifies whether to redirect the Videos folder to a local folder or a remote folder, or not to redirect this folder. The acceptable values for this parameter are:
-- DoNotManage
-- RedirectToLocal
-- RedirectToRemote
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ForceUnloadDisabled<Boolean>
Indicates whether to disable forced unload of a user profile at logoff. The default value for this parameter is $False.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-GrantExclusiveRight<Boolean>
Indicates whether to grant the user exclusive permissions to a redirected folder.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Id<String[]>
Specifies an array of IDs for user data and profile configuration items.
Aliases |
CIId |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-InputObject<IResultObject>
Specifies a user data and profile configuration item object. To obtain a configuration item object, use the Get-CMUserDataAndProfileConfigurationItem cmdlet.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-LeaveFolderNewLocation<Boolean>
Indicates whether to leave the folder in the redirected location in the event that you remove this configuration item.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-LimitDisk<Int32>
Specifies a limit, in megabytes, for the disk space used for offline files.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ManageAdvancedSetting<Boolean>
Indicates whether this configuration item manages advanced settings for folder redirection. Specify values for any of the following parameters:
-- GrantExclusiveRight
-- MoveContent
-- LeaveFolderNewLocation
-- MoveCachedFolder
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ManageSlowLink<Boolean>
Indicates whether this profile item manages slow links.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MoveCachedFolder<Boolean>
Indicates whether to move the cached folder when the path updates on the server.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-MoveContent<Boolean>
Indicates whether to move the contents of redirected folders to the new location.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Name<String[]>
Specifies an array of names of user data and profile configuration items.
Aliases |
LocalizedDisplayName |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-NewName<String>
Specifies a new name for the configuration item.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OfflineFile<String[]>
Specifies an array of Administrative user assigned offline folders, as UNC paths as follows: \\server\share\%UserName%.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OnlyAllowLocalProfiles<Boolean>
Indicates whether the configuration item allows only local profiles, not domain profiles.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-OwnerCheckDisabled<Boolean>
Indicates whether the configuration item does not check for ownership of roaming profile folders.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-ProfileUploadDisabled<Boolean>
Indicates whether to disable uploading of profiles.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SlowLink<Int32>
Specifies a value for a slow link.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SlowLinkUIEnabled<Boolean>
Indicates whether to enable the user logon prompt to allow profile download when a device detects a slow link.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SpecifiedLocation<String>
Specifies a specified location.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SpecifyTime<String>
Specifies a time for background upload of the user hive.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SpecifyTimeInterval<Int32>
Specifies a time of day for synchronization for user profiles. Enter a value of zero (0) to 12. Zero indicates 12:00 a.m. Values from one (1) to 12 indicate times from 1:00 p.m. to 12:00 p.m.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SynchronizationInterval<Int32>
Specifies a synchronization interval, in hours, for the user profiles.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SynchronizationList<String[]>
Specifies an array of folders. The configuration item specifies these subfolders of Appdata\Roaming to synchronize only at logon and logoff.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-SynchronizationPolicy<Boolean>
Indicates whether to use a synchronization policy.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-TempProfileLogonBlocked<Boolean>
Indicates whether to block users from logging on by using a temporary profile.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-TimeOut<Int32>
Specifies a timeout value.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UseCommonAlert<Boolean>
Indicates whether to use common alerts.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-UseSpecifiedLocation<Boolean>
Indicates whether to use the specified location referred to by the SpecifiedLocation parameter.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-WaitForNetworkInSeconds<Int32>
Specifies the maximum time to wait, in seconds, for slow link network connectivity before loading the profile.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-WarningDays<Int32>
Specifies the number of days to wait before the profile creates a warning.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
True (ByPropertyName) |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
Examples
Example 1: Modify a configuration item
This command modifies the configuration item named CMUDaPCI001, changing its name to CMUDaPCI0073. The command also sets values for whether the configuration item specifies folder redirection, offline folders, and roaming profiles, and it provides a description for the configuration item.
PS C:\> Set-CMUserDataAndProfileConfigurationItem -Name "CMUDaPCI001" -NewName "CMUDaPCI0073" -ConfigureFolderRedirection $False -ConfigureOffineFile $False -ConfigureRoamingUserProfile $False -Description "User data and profile configuration information"
Related topics
Copy-CMUserDataAndProfileConfigurationItem
Get-CMUserDataAndProfileConfigurationItem