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>]
Description
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 資料夾指定重新導向至遠端。
命令包含指定的位置,並包含 UseSpecifiedLocation 參數,其值為 $True。
範例 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
指出使用者是否可以停用 [離線工作 ] 命令。
類型: | 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