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

-ConfigureFolderRedirection

指示配置项目是否包括文件夹重定向的设置。

类型:Boolean
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ConfigureOfflineFile

指示配置项目是否包括脱机文件夹的设置。

类型:Boolean
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ConfigureRoamingUserProfile

指示配置项目是否包括漫游用户配置文件的设置。

类型: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

-Contact

类型: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

指示配置是否允许通过慢速链接处理脱机文件。

类型: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
类型:FolderRedirectionType
别名:FolderRedirectionUserConfigurationForLinks, Links
接受的值:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ManageAdvancedSetting

指示此配置项目是否管理文件夹重定向的高级设置。 指定以下任何参数的值:

  • GrantExclusiveRight
  • MoveContent
  • LeaveFolderNewLocation
  • MoveCachedFolder
类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

指示此配置文件项是否管理慢速链接。

类型: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
类型:FolderRedirectionType
别名:FolderRedirectionUserConfigurationForSearches, Searches
接受的值:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

指定慢速链接的值。

类型: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

-StartMenu

类型: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