New-CMUserDataAndProfileConfigurationItem
语法
New-CMUserDataAndProfileConfigurationItem
[-AccessPolicy <Boolean>]
[-AddAdminGroupToRupEnabled <Boolean>]
[-AllowAllDevice <Boolean>]
[-AllowCrossForestUserPolicy <Boolean>]
[-AppDataRoaming <FolderRedirectionType>]
[-BackgroundSynchronization <SynchronizationType>]
-ConfigureFolderRedirection <Boolean>
-ConfigureOfflineFile <Boolean>
-ConfigureRoamingUserProfile <Boolean>
[-ConnectionTransferRate <Int32>]
[-Contact <FolderRedirectionType>]
[-DeleteProfileOlderDays <Int32>]
[-DeleteRoamingCacheEnabled <Boolean>]
[-Description <String>]
[-Desktop <FolderRedirectionType>]
[-DetectSlowLinkDisabled <Boolean>]
[-DeviceType <DeviceType>]
[-DisableMakeOffline <Boolean>]
[-DisableWorkOffline <Boolean>]
[-Document <FolderRedirectionType>]
[-Download <FolderRedirectionType>]
[-EnableOfflineFile <Boolean>]
[-EnableSlowLink <Boolean>]
[-ErrorDays <Int32>]
[-ExcludeProfile <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>]
-Name <String>
[-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>]
[-SyncDirectory <String[]>]
[-SynchronizationPolicy <Boolean>]
[-SyncMins <Int32>]
[-TempProfileLogonBlocked <Boolean>]
[-Timeout <Int32>]
[-UseCommonAlert <Boolean>]
[-UseSpecifiedLocation <Boolean>]
[-Video <FolderRedirectionType>]
[-WaitForNetworkSec <Int32>]
[-WarningDays <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
New-CMUserDataAndProfileConfigurationItem cmdlet 创建可应用于 Windows 8 计算机的用户数据和配置文件配置项目。
配置项目可以管理文件夹重定向、脱机文件夹和漫游用户配置文件。
可以使用 Set-CMUserDataAndProfileConfigurationItem cmdlet 修改现有配置项目的设置。
注意
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:指定文件夹重定向
PS XYZ:\> New-CMUserDataAndProfileConfigurationItem -ConfigureFolderRedirection $True -ConfigureOffineFile $True -ConfigureRoamingUserProfile $True -Name "CMUserDataProfileCI07" -FolderRedirectionUserConfigurationForDesktop RedirectToRemote -SpecifiedLocation "\\Server017\Shared" -UseSpecifiedLocation $True
此命令创建名为 CMUserDataProfileCI07 的配置项目。
此配置项目管理文件夹重定向、脱机文件夹和漫游用户配置文件。
命令指定 Desktop 文件夹的重定向到远程。
命令包含指定位置,并包含值为 $True 的 UseSpecifiedLocation 参数。
示例 2:指定配置项目的设置
PS XYZ:\> New-CMUserDataAndProfileConfigurationItem -ConfigureFolderRedirection $True -ConfigureOffineFile $True -ConfigureRoamingUserProfile $True -Name "CMUserDataProfileCI27" -AccessPolicy $True -AddAdminGroupToRUPEnabled $True -AllowAllDevice $False -AllowCrossForestUserPolicy $True -BackgroundSynchronization NotConfigured -ConnectionTransferRate 300 -DeleteProfileOlderDays 300 -DeleteRoamingCacheEnabled $True -Description "Configuration item for off-site staff." -DetectSlowLinkDisabled $False -DeviceType OnlyOnPrimaryDevices -DisableMakeOffline $True -DisableWorkOffline $True -EnableOfflineFile $True -EnableSlowLink $True -ErrorDays 200 -ExcludeList "MiscFolder" -FileSynchronization Enabled -FolderRedirectionUserConfigurationForAppDataRoaming RedirectToLocal -FolderRedirectionUserConfigurationForContacts RedirectToRemote -FolderRedirectionUserConfigurationForDesktop RedirectToRemote -FolderRedirectionUserConfigurationForDocuments RedirectToRemote -FolderRedirectionUserConfigurationForDownloads RedirectToLocal -FolderRedirectionUserConfigurationForFavorites RedirectToLocal -FolderRedirectionUserConfigurationForLinks RedirectToRemote -FolderRedirectionUserConfigurationForMusic RedirectToLocal -FolderRedirectionUserConfigurationForPictures RedirectToRemote -FolderRedirectionUserConfigurationForSavedGames RedirectToRemote -FolderRedirectionUserConfigurationForSearches RedirectToLocal -FolderRedirectionUserConfigurationForStartMenu RedirectToLocal -FolderRedirectionUserConfigurationForVideos RedirectToRemote -ForceUnloadDisabled $True -GrantExclusiveRight $False -LeaveFolderNewLocation $True -LimitDisk 1024 -ManageAdvancedSetting $True -ManageSlowLink $True -MoveCachedFolder $True -MoveContent $False -OfflineFile "\\Server78\MiscShared" -OnlyAllowLocalProfiles $True -OwnerCheckDisabled $True -ProfileUploadDisabled $True -SlowLink 350 -SlowLinkUIEnabled $True -SpecifiedLocation "\\Server221\Part17" -SpecifyTimeInterval 120 -SynchronizationInterval 1200 -SynchronizationList "\\Server221\Part17" -SynchronizationPolicy $True -TempProfileLogonBlocked $True -TimeOut 130 -UseCommonAlert $True -UseSpecifiedLocation $True -WaitForNetworkInSeconds 300 -WarningDays 100
此命令创建名为 CMUserDataProfileCI27 的配置项目。
此配置项目管理文件夹重定向、脱机文件夹和漫游用户配置文件。
与前面的示例一样,此命令指定文件夹重定向设置,这一次针对多个文件夹。
命令包括文件夹重定向、脱机文件夹和漫游用户配置文件的其他设置。
参数
-AccessPolicy
指示此配置项目是否管理漫游配置文件的配置文件访问设置。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AddAdminGroupToRupEnabled
指示是否授予管理员组对漫游配置文件文件夹的访问权限。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AllowAllDevice
指示是否允许所有设备上的漫游配置文件。
如果此值$False,则漫游配置文件仅适用于用户的主设备。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AllowCrossForestUserPolicy
指示是否允许用户策略在与当前林具有信任关系的 Active Directory 林之间漫游。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AppDataRoaming
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForAppDataRoaming |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-BackgroundSynchronization
为处于脱机模式的文件指定后台同步类型。
此参数的可接受值为:Disabled、Enabled 和 NotConfigured。
类型: | SynchronizationType |
接受的值: | Enabled, Disabled, NotConfigured |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
指示配置项目是否包括文件夹重定向的设置。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
指示配置项目是否包括脱机文件夹的设置。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
指示配置项目是否包括漫游用户配置文件的设置。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Confirm
提示你在运行 cmdlet 之前进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ConnectionTransferRate
指定连接传输速率。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForContacts, Contacts |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DeleteProfileOlderDays
指定自用户上次使用用户配置文件以来保留该配置文件的天数。
计算机在重启时删除较旧的配置文件。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DeleteRoamingCacheEnabled
指示是否删除漫游用户配置文件的缓存副本。
此参数的默认值为 $False。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Description
指定配置项目的说明。
类型: | String |
别名: | LocalizedDescription |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Desktop
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForDesktop |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DetectSlowLinkDisabled
指示是否禁用慢速链接检测。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DeviceType
指定文件夹重定向对用户设备的适用性。
此参数可接受的值为:
- FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly。
任何用户设备的文件夹重定向,但仅在用户的主设备上缓存。
- OnAnyDevice。
在任何设备上进行文件夹重定向和缓存。
- OnlyOnPrimaryDevices。
用户主设备上的文件夹重定向和缓存。
类型: | DeviceType |
接受的值: | OnAnyDevice, OnlyOnPrimaryDevices, FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableMakeOffline
指示用户是否可以禁用“ 脱机可用” 命令。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DisableWorkOffline
指示用户是否可以禁用 Work Offline 命令。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Document
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForDocuments, Documents |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Download
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForDownloads, Downloads |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnableOfflineFile
指示此配置项目是否允许使用脱机文件。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-EnableSlowLink
指示配置是否允许通过慢速链接处理脱机文件。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ErrorDays
指定在配置文件创建错误之前要等待的天数。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ExcludeProfile
类型: | String[] |
别名: | ExcludeList |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Favorite
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForFavorites, Favorites |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-FileSynchronization
为脱机模式下的工作指定按流量计费的网络的文件同步类型。
此参数的可接受值为:Disabled、Enabled 和 NotConfigured。
类型: | SynchronizationType |
接受的值: | Enabled, Disabled, NotConfigured |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ForceUnloadDisabled
指示是否在注销时禁用强制卸载用户配置文件。
此参数的默认值为 $False。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为, (不建议) 。 不能将其与 DisableWildcardHandling 组合使用。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-GrantExclusiveRight
指示是否向用户授予对重定向文件夹的独占权限。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-LeaveFolderNewLocation
指示删除此配置项目时是否将文件夹保留在重定向位置。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-LimitDisk
指定用于脱机文件的磁盘空间的限制(以 MB 为单位)。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Link
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForLinks, Links |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ManageAdvancedSetting
指示此配置项目是否管理文件夹重定向的高级设置。
指定以下任何参数的值:
-
GrantExclusiveRight
-
MoveContent
-
LeaveFolderNewLocation
-
MoveCachedFolder
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ManageSlowLink
指示此配置文件项是否管理慢速链接。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-MoveCachedFolder
指示在服务器上更新路径时是否移动缓存文件夹。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-MoveContent
指示是否将重定向文件夹的内容移动到新位置。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Music
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForMusic |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Name
指定配置项目的名称。
类型: | String |
别名: | LocalizedDisplayName |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-OfflineFile
指定管理用户分配的脱机文件夹的数组,如 UNC 路径所示:\\server\share%UserName%。
类型: | String[] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-OnlyAllowLocalProfile
类型: | Boolean |
别名: | OnlyAllowLocalProfiles |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-OwnerCheckDisabled
指示配置项目是否不检查漫游配置文件文件夹的所有权。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Picture
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForPictures, Pictures |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ProfileUploadDisabled
指示是否禁用配置文件上传。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SavedGame
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForSavedGames, SavedGames |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Search
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForSearches, Searches |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SlowLink
指定慢速链接的值。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SlowLinkUIEnabled
指示在设备检测到慢速链接时是否启用用户登录提示以允许配置文件下载。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SpecifiedLocation
指定指定位置。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SpecifyTime
指定用户配置单元的后台上传时间。
类型: | String |
接受的值: | 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 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SpecifyTimeMin
类型: | Int32 |
别名: | SpecifyTimeInterval |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForStartMenu |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SyncDirectory
类型: | String[] |
别名: | SynchronizationList, SyncDirectories |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SynchronizationPolicy
指示是否使用同步策略。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-SyncMins
类型: | Int32 |
别名: | SynchronizationInterval |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TempProfileLogonBlocked
指示是否阻止用户使用临时配置文件登录。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Timeout
指定超时值。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-UseCommonAlert
指示是否使用常见警报。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-UseSpecifiedLocation
指示是否使用 由 SpecifiedLocation 参数引用的指定位置。
类型: | Boolean |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Video
类型: | FolderRedirectionType |
别名: | FolderRedirectionUserConfigurationForVideos, Videos |
接受的值: | RedirectToRemote, RedirectToLocal, DoNotManage |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WaitForNetworkSec
类型: | Int32 |
别名: | WaitForNetworkInSeconds |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WarningDays
指定在配置文件创建警告之前要等待的天数。
类型: | Int32 |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | False |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
None
输出
IResultObject