Edit

Share via


Set-CMUserDataAndProfileConfigurationItem

Modifies a user data and profile configuration item.

Syntax

SetByValue (Default)

Set-CMUserDataAndProfileConfigurationItem
    [-InputObject] <IResultObject>
    [-AccessPolicy <Boolean>]
    [-AddAdminGroupToRupEnabled <Boolean>]
    [-AllowAllDevice <Boolean>]
    [-AllowCrossForestUserPolicy <Boolean>]
    [-AppDataRoaming <FolderRedirectionType>]
    [-BackgroundSynchronization <SynchronizationType>]
    [-BackgroundUploadHour <Int32>]
    [-ConfigureFolderRedirection <Boolean>]
    [-ConfigureOfflineFile <Boolean>]
    [-ConfigureRoamingUserProfile <Boolean>]
    [-ConnectionTransferRate <Int32>]
    [-Contact <FolderRedirectionType>]
    [-DeleteProfileOlderDays <Int32>]
    [-DeleteRoamingCacheEnabled <Boolean>]
    [-Desktop <FolderRedirectionType>]
    [-DetectSlowLink <Boolean>]
    [-DeviceType <DeviceType>]
    [-DisableMakeOffline <Boolean>]
    [-DisableWorkOffline <Boolean>]
    [-Document <FolderRedirectionType>]
    [-Download <FolderRedirectionType>]
    [-EnableOfflineFile <Boolean>]
    [-EnableSlowLink <Boolean>]
    [-ErrorDays <Int32>]
    [-ExcludeList <String[]>]
    [-Favorite <FolderRedirectionType>]
    [-FileSynchronization <SynchronizationType>]
    [-ForceUnloadDisabled <Boolean>]
    [-GrantExclusiveRight <Boolean>]
    [-LeaveFolderNewLocation <Boolean>]
    [-LimitDisk <Int32>]
    [-Link <FolderRedirectionType>]
    [-ManageAdvancedSetting <Boolean>]
    [-ManageSlowLink <Boolean>]
    [-MoveCachedFolder <Boolean>]
    [-MoveContent <Boolean>]
    [-Music <FolderRedirectionType>]
    [-OfflineFile <String[]>]
    [-OnlyAllowLocalProfile <Boolean>]
    [-OwnerCheckDisabled <Boolean>]
    [-Picture <FolderRedirectionType>]
    [-ProfileUploadDisabled <Boolean>]
    [-SavedGame <FolderRedirectionType>]
    [-Search <FolderRedirectionType>]
    [-SlowLink <Int32>]
    [-SlowLinkUIEnabled <Boolean>]
    [-SpecifiedLocation <String>]
    [-SpecifyTime <String>]
    [-SpecifyTimeMin <Int32>]
    [-StartMenu <FolderRedirectionType>]
    [-SynchronizationList <String[]>]
    [-SynchronizationPolicy <Boolean>]
    [-SyncMins <Int32>]
    [-TempProfileLogonBlocked <Boolean>]
    [-TimeOut <Int32>]
    [-UseCommonAlert <Boolean>]
    [-UseSpecifiedLocation <Boolean>]
    [-Video <FolderRedirectionType>]
    [-WaitForNetworkSec <Int32>]
    [-WarningDays <Int32>]
    [-Description <String>]
    [-Digest <ConfigurationItem>]
    [-DigestPath <String>]
    [-DigestXml <String>]
    [-NewName <String>]
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetById

Set-CMUserDataAndProfileConfigurationItem
    [-Id] <Int32>
    [-AccessPolicy <Boolean>]
    [-AddAdminGroupToRupEnabled <Boolean>]
    [-AllowAllDevice <Boolean>]
    [-AllowCrossForestUserPolicy <Boolean>]
    [-AppDataRoaming <FolderRedirectionType>]
    [-BackgroundSynchronization <SynchronizationType>]
    [-BackgroundUploadHour <Int32>]
    [-ConfigureFolderRedirection <Boolean>]
    [-ConfigureOfflineFile <Boolean>]
    [-ConfigureRoamingUserProfile <Boolean>]
    [-ConnectionTransferRate <Int32>]
    [-Contact <FolderRedirectionType>]
    [-DeleteProfileOlderDays <Int32>]
    [-DeleteRoamingCacheEnabled <Boolean>]
    [-Desktop <FolderRedirectionType>]
    [-DetectSlowLink <Boolean>]
    [-DeviceType <DeviceType>]
    [-DisableMakeOffline <Boolean>]
    [-DisableWorkOffline <Boolean>]
    [-Document <FolderRedirectionType>]
    [-Download <FolderRedirectionType>]
    [-EnableOfflineFile <Boolean>]
    [-EnableSlowLink <Boolean>]
    [-ErrorDays <Int32>]
    [-ExcludeList <String[]>]
    [-Favorite <FolderRedirectionType>]
    [-FileSynchronization <SynchronizationType>]
    [-ForceUnloadDisabled <Boolean>]
    [-GrantExclusiveRight <Boolean>]
    [-LeaveFolderNewLocation <Boolean>]
    [-LimitDisk <Int32>]
    [-Link <FolderRedirectionType>]
    [-ManageAdvancedSetting <Boolean>]
    [-ManageSlowLink <Boolean>]
    [-MoveCachedFolder <Boolean>]
    [-MoveContent <Boolean>]
    [-Music <FolderRedirectionType>]
    [-OfflineFile <String[]>]
    [-OnlyAllowLocalProfile <Boolean>]
    [-OwnerCheckDisabled <Boolean>]
    [-Picture <FolderRedirectionType>]
    [-ProfileUploadDisabled <Boolean>]
    [-SavedGame <FolderRedirectionType>]
    [-Search <FolderRedirectionType>]
    [-SlowLink <Int32>]
    [-SlowLinkUIEnabled <Boolean>]
    [-SpecifiedLocation <String>]
    [-SpecifyTime <String>]
    [-SpecifyTimeMin <Int32>]
    [-StartMenu <FolderRedirectionType>]
    [-SynchronizationList <String[]>]
    [-SynchronizationPolicy <Boolean>]
    [-SyncMins <Int32>]
    [-TempProfileLogonBlocked <Boolean>]
    [-TimeOut <Int32>]
    [-UseCommonAlert <Boolean>]
    [-UseSpecifiedLocation <Boolean>]
    [-Video <FolderRedirectionType>]
    [-WaitForNetworkSec <Int32>]
    [-WarningDays <Int32>]
    [-Description <String>]
    [-Digest <ConfigurationItem>]
    [-DigestPath <String>]
    [-DigestXml <String>]
    [-NewName <String>]
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

SetByName

Set-CMUserDataAndProfileConfigurationItem
    [-Name] <String>
    [-AccessPolicy <Boolean>]
    [-AddAdminGroupToRupEnabled <Boolean>]
    [-AllowAllDevice <Boolean>]
    [-AllowCrossForestUserPolicy <Boolean>]
    [-AppDataRoaming <FolderRedirectionType>]
    [-BackgroundSynchronization <SynchronizationType>]
    [-BackgroundUploadHour <Int32>]
    [-ConfigureFolderRedirection <Boolean>]
    [-ConfigureOfflineFile <Boolean>]
    [-ConfigureRoamingUserProfile <Boolean>]
    [-ConnectionTransferRate <Int32>]
    [-Contact <FolderRedirectionType>]
    [-DeleteProfileOlderDays <Int32>]
    [-DeleteRoamingCacheEnabled <Boolean>]
    [-Desktop <FolderRedirectionType>]
    [-DetectSlowLink <Boolean>]
    [-DeviceType <DeviceType>]
    [-DisableMakeOffline <Boolean>]
    [-DisableWorkOffline <Boolean>]
    [-Document <FolderRedirectionType>]
    [-Download <FolderRedirectionType>]
    [-EnableOfflineFile <Boolean>]
    [-EnableSlowLink <Boolean>]
    [-ErrorDays <Int32>]
    [-ExcludeList <String[]>]
    [-Favorite <FolderRedirectionType>]
    [-FileSynchronization <SynchronizationType>]
    [-ForceUnloadDisabled <Boolean>]
    [-GrantExclusiveRight <Boolean>]
    [-LeaveFolderNewLocation <Boolean>]
    [-LimitDisk <Int32>]
    [-Link <FolderRedirectionType>]
    [-ManageAdvancedSetting <Boolean>]
    [-ManageSlowLink <Boolean>]
    [-MoveCachedFolder <Boolean>]
    [-MoveContent <Boolean>]
    [-Music <FolderRedirectionType>]
    [-OfflineFile <String[]>]
    [-OnlyAllowLocalProfile <Boolean>]
    [-OwnerCheckDisabled <Boolean>]
    [-Picture <FolderRedirectionType>]
    [-ProfileUploadDisabled <Boolean>]
    [-SavedGame <FolderRedirectionType>]
    [-Search <FolderRedirectionType>]
    [-SlowLink <Int32>]
    [-SlowLinkUIEnabled <Boolean>]
    [-SpecifiedLocation <String>]
    [-SpecifyTime <String>]
    [-SpecifyTimeMin <Int32>]
    [-StartMenu <FolderRedirectionType>]
    [-SynchronizationList <String[]>]
    [-SynchronizationPolicy <Boolean>]
    [-SyncMins <Int32>]
    [-TempProfileLogonBlocked <Boolean>]
    [-TimeOut <Int32>]
    [-UseCommonAlert <Boolean>]
    [-UseSpecifiedLocation <Boolean>]
    [-Video <FolderRedirectionType>]
    [-WaitForNetworkSec <Int32>]
    [-WarningDays <Int32>]
    [-Description <String>]
    [-Digest <ConfigurationItem>]
    [-DigestPath <String>]
    [-DigestXml <String>]
    [-NewName <String>]
    [-PassThru]
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Modify a configuration item

PS XYZ:\> Set-CMUserDataAndProfileConfigurationItem -Name "CMUDaPCI001" -NewName "CMUDaPCI0073" -ConfigureFolderRedirection $False -ConfigureOffineFile $False -ConfigureRoamingUserProfile $False -Description "User data and profile configuration information"

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.

Parameters

-AccessPolicy

Indicates whether this configuration item manages profile access settings for roaming profiles.

Parameter properties

Type:Boolean
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

-AddAdminGroupToRupEnabled

Indicates whether to grant the Administrators group access to roaming profile folders.

Parameter properties

Type:Boolean
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

-AllowAllDevice

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.

Parameter properties

Type:Boolean
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

-AllowCrossForestUserPolicy

Indicates whether to permit user policies to roam across Active Directory forests that have a trust relationship with the current forest.

Parameter properties

Type:Boolean
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

-AppDataRoaming

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForApplicationData, FolderRedirectionUserConfigurationForAppDataRoaming

Parameter sets

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

-BackgroundSynchronization

Specifies a background synchronization type for file in offline mode.

The acceptable values for this parameter are:

  • Disabled
  • Enabled
  • NotConfigured

Parameter properties

Type:SynchronizationType
Default value:None
Accepted values:Enabled, Disabled, NotConfigured
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

-BackgroundUploadHour

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

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

-ConfigureFolderRedirection

Indicates whether the configuration item includes settings for folder redirection.

Parameter properties

Type:Boolean
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

-ConfigureOfflineFile

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False
Aliases:ConfigureOffineFile

Parameter sets

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

-ConfigureRoamingUserProfile

Indicates whether the configuration item includes settings for roaming user profiles.

Parameter properties

Type:Boolean
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

-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

-ConnectionTransferRate

Specifies a connection transfer rate.

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

-Contact

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForContacts, Contacts

Parameter sets

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

-DeleteProfileOlderDays

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.

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

-DeleteRoamingCacheEnabled

Indicates whether to delete cached copies of roaming user profiles. The default for this parameter is $False.

Parameter properties

Type:Boolean
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

-Description

Specifies a description for the configuration item.

Parameter properties

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

Parameter sets

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

-Desktop

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForDesktop

Parameter sets

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

Indicates whether to detect slow links.

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False
(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

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

Parameter properties

Type:DeviceType
Default value:None
Accepted values:OnAnyDevice, OnlyOnPrimaryDevices, FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly
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

-Digest

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

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

Parameter sets

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

-DigestPath

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

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

Parameter sets

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

-DigestXml

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

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

-DisableMakeOffline

Indicates whether users can disable the Make Available Offline command.

Parameter properties

Type:Boolean
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

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

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

-DisableWorkOffline

Indicates whether users can disable the Work Offline command.

Parameter properties

Type:Boolean
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

-Document

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForDocuments, Documents

Parameter sets

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

-Download

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForDownloads, Downloads

Parameter sets

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

-EnableOfflineFile

Indicates whether this configuration item enables use of offline files.

Parameter properties

Type:Boolean
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

Indicates whether the configuration enables work with offline files over a slow link.

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False
(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ErrorDays

Specifies the number of days to wait before the profile creates an error.

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

-ExcludeList

Specifies an array of folders. The configuration item excludes these folders from roaming profiles.

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

-Favorite

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForFavorites, Favorites

Parameter sets

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

-FileSynchronization

Specifies a file synchronization type for metered networks for work in offline mode. The acceptable values for this parameter are:

  • Disabled
  • Enabled
  • NotConfigured

Parameter properties

Type:SynchronizationType
Default value:None
Accepted values:Enabled, Disabled, NotConfigured
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

-ForceUnloadDisabled

Indicates whether to disable forced unload of a user profile at logoff. The default value for this parameter is $False.

Parameter properties

Type:Boolean
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

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

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

-GrantExclusiveRight

Indicates whether to grant the user exclusive permissions to a redirected folder.

Parameter properties

Type:Boolean
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

-Id

Specifies an array of IDs for user data and profile configuration items.

Parameter properties

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
Aliases:CIId, CI_ID

Parameter sets

SetById
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InputObject

Specifies a user data and profile configuration item object. To obtain a configuration item object, use the Get-CMUserDataAndProfileConfigurationItem cmdlet.

Parameter properties

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

Parameter sets

SetByValue
Position:0
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-LeaveFolderNewLocation

Indicates whether to leave the folder in the redirected ___location in the event that you remove this configuration item.

Parameter properties

Type:Boolean
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

-LimitDisk

Specifies a limit, in megabytes, for the disk space used for offline files.

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

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForLinks, Links
(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ManageAdvancedSetting

Indicates whether this configuration item manages advanced settings for folder redirection. Specify values for any of the following parameters:

  • GrantExclusiveRight
  • MoveContent
  • LeaveFolderNewLocation
  • MoveCachedFolder

Parameter properties

Type:Boolean
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

Indicates whether this profile item manages slow links.

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False
(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MoveCachedFolder

Indicates whether to move the cached folder when the path updates on the server.

Parameter properties

Type:Boolean
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

-MoveContent

Indicates whether to move the contents of redirected folders to the new ___location.

Parameter properties

Type:Boolean
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

-Music

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForMusic

Parameter sets

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

-Name

Specifies an array of names of user data and profile configuration items.

Parameter properties

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

Parameter sets

SetByName
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NewName

Specifies a new name for the configuration item.

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

-OfflineFile

Specifies an array of Administrative user assigned offline folders, as UNC paths as follows: \\server\share%UserName%.

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

-OnlyAllowLocalProfile

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:Boolean
Default value:None
Supports wildcards:False
DontShow:False
Aliases:OnlyAllowLocalProfiles

Parameter sets

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

-OwnerCheckDisabled

Indicates whether the configuration item does not check for ownership of roaming profile folders.

Parameter properties

Type:Boolean
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

-PassThru

Add this parameter to return an object that represents the item with which you're working. By default, this cmdlet may not generate any output.

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

-Picture

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForPictures, Pictures

Parameter sets

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

-ProfileUploadDisabled

Indicates whether to disable uploading of profiles.

Parameter properties

Type:Boolean
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

-SavedGame

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForSavedGames, SavedGames

Parameter sets

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

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForSearches, Searches

Parameter sets

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

Specifies a value for a slow link.

Type:Int32
Default value:None
Supports wildcards:False
DontShow:False
(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SlowLinkUIEnabled

Indicates whether to enable the user logon prompt to allow profile download when a device detects a slow link.

Parameter properties

Type:Boolean
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

-SpecifiedLocation

Specifies a specified ___location.

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

-SpecifyTime

Specifies a time for background upload of the user hive.

Parameter properties

Type:String
Default value:None
Accepted values:12:00 AM, 1:00 PM, 2:00 PM, 3:00 PM, 4:00 PM, 5:00 PM, 6:00 PM, 7:00 PM, 8:00 PM, 9:00 PM, 10:00 PM, 11:00 PM, 12:00 PM
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

-SpecifyTimeMin

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

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

Parameter sets

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

-StartMenu

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForStartMenu

Parameter sets

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

-SynchronizationList

Specifies an array of folders. The configuration item specifies these subfolders of Appdata\Roaming to synchronize only at logon and logoff.

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

-SynchronizationPolicy

Indicates whether to use a synchronization policy.

Parameter properties

Type:Boolean
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

-SyncMins

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

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

Parameter sets

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

-TempProfileLogonBlocked

Indicates whether to block users from logging on by using a temporary profile.

Parameter properties

Type:Boolean
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

-TimeOut

Specifies a timeout value.

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

-UseCommonAlert

Indicates whether to use common alerts.

Parameter properties

Type:Boolean
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

-UseSpecifiedLocation

Indicates whether to use the specified ___location referred to by the SpecifiedLocation parameter.

Parameter properties

Type:Boolean
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

-Video

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

Type:FolderRedirectionType
Default value:None
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Supports wildcards:False
DontShow:False
Aliases:FolderRedirectionUserConfigurationForVideos, Videos

Parameter sets

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

-WaitForNetworkSec

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.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Parameter properties

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

Parameter sets

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

-WarningDays

Specifies the number of days to wait before the profile creates 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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet doesn't 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.

Inputs

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItem

Outputs

System.Object