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

指示此配置项目是否管理漫游配置文件的配置文件访问设置。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AddAdminGroupToRupEnabled

指示是否授予管理员组对漫游配置文件文件夹的访问权限。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowAllDevice

指示是否允许所有设备上的漫游配置文件。 如果此值$False,则漫游配置文件仅适用于用户的主设备。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowCrossForestUserPolicy

指示是否允许用户策略在与当前林具有信任关系的 Active Directory 林之间漫游。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AppDataRoaming

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForAppDataRoaming
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackgroundSynchronization

为处于脱机模式的文件指定后台同步类型。 此参数的可接受值为:Disabled、Enabled 和 NotConfigured。

Type:SynchronizationType
Accepted values:Enabled, Disabled, NotConfigured
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConfigureFolderRedirection

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConfigureOfflineFile

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ConfigureRoamingUserProfile

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

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionTransferRate

指定连接传输速率。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Contact

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForContacts, Contacts
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeleteProfileOlderDays

指定自用户上次使用用户配置文件以来保留该配置文件的天数。 计算机在重启时删除较旧的配置文件。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeleteRoamingCacheEnabled

指示是否删除漫游用户配置文件的缓存副本。 此参数的默认值为 $False。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

指定配置项目的说明。

Type:String
Aliases:LocalizedDescription
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Desktop

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForDesktop
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DetectSlowLinkDisabled

指示是否禁用慢速链接检测。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DeviceType

指定文件夹重定向对用户设备的适用性。 此参数可接受的值为:

  • FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly。 任何用户设备的文件夹重定向,但仅在用户的主设备上缓存。
  • OnAnyDevice。 在任何设备上进行文件夹重定向和缓存。
  • OnlyOnPrimaryDevices。 用户主设备上的文件夹重定向和缓存。
Type:DeviceType
Accepted values:OnAnyDevice, OnlyOnPrimaryDevices, FolderRedirectionOnAnyDeviceCachingOnPrimaryDevicesOnly
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableMakeOffline

指示用户是否可以禁用“ 脱机可用” 命令。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWorkOffline

指示用户是否可以禁用 Work Offline 命令。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Document

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForDocuments, Documents
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Download

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForDownloads, Downloads
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-EnableOfflineFile

指示此配置项目是否允许使用脱机文件。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ErrorDays

指定在配置文件创建错误之前要等待的天数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExcludeProfile

Type:String[]
Aliases:ExcludeList
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Favorite

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForFavorites, Favorites
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileSynchronization

为脱机模式下的工作指定按流量计费的网络的文件同步类型。 此参数的可接受值为:Disabled、Enabled 和 NotConfigured。

Type:SynchronizationType
Accepted values:Enabled, Disabled, NotConfigured
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceUnloadDisabled

指示是否在注销时禁用强制卸载用户配置文件。 此参数的默认值为 $False。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

此参数处理通配符,并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GrantExclusiveRight

指示是否向用户授予对重定向文件夹的独占权限。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LeaveFolderNewLocation

指示在删除此配置项目时是否将文件夹保留在重定向位置。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LimitDisk

指定用于脱机文件的磁盘空间的限制(以 MB 为单位)。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForLinks, Links
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ManageAdvancedSetting

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

  • GrantExclusiveRight
  • MoveContent
  • LeaveFolderNewLocation
  • MoveCachedFolder
Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MoveCachedFolder

指示在服务器上更新路径时是否移动缓存文件夹。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MoveContent

指示是否将重定向文件夹的内容移动到新位置。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Music

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForMusic
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

指定配置项目的名称。

Type:String
Aliases:LocalizedDisplayName
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-OfflineFile

指定管理用户分配的脱机文件夹的数组,如 UNC 路径所示:\\server\share%UserName%。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnlyAllowLocalProfile

Type:Boolean
Aliases:OnlyAllowLocalProfiles
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OwnerCheckDisabled

指示配置项目是否不检查漫游配置文件文件夹的所有权。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Picture

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForPictures, Pictures
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProfileUploadDisabled

指示是否禁用配置文件上传。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SavedGame

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForSavedGames, SavedGames
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForSearches, Searches
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

指定慢速链接的值。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SlowLinkUIEnabled

指示设备检测到慢链接时是否启用用户登录提示以允许配置文件下载。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SpecifiedLocation

指定指定位置。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SpecifyTime

指定用户配置单元的后台上传时间。

Type:String
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
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SpecifyTimeMin

Type:Int32
Aliases:SpecifyTimeInterval
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StartMenu

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForStartMenu
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SyncDirectory

Type:String[]
Aliases:SynchronizationList, SyncDirectories
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SynchronizationPolicy

指示是否使用同步策略。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SyncMins

Type:Int32
Aliases:SynchronizationInterval
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TempProfileLogonBlocked

指示是否阻止用户使用临时配置文件登录。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Timeout

指定超时值。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseCommonAlert

指示是否使用常见警报。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UseSpecifiedLocation

指示是否使用 由 SpecifiedLocation 参数引用的指定位置。

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Video

Type:FolderRedirectionType
Aliases:FolderRedirectionUserConfigurationForVideos, Videos
Accepted values:RedirectToRemote, RedirectToLocal, DoNotManage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WaitForNetworkSec

Type:Int32
Aliases:WaitForNetworkInSeconds
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WarningDays

指定在配置文件创建警告之前要等待的天数。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

None

输出

IResultObject