Set-CMStateMigrationPoint
修改 Configuration Manager 中狀態移轉點的設定。
語法
Set-CMStateMigrationPoint
[-AddBoundaryGroupName <String[]>]
[-AddStorageFolder <StorageDirectoryData[]>]
[-AllowFallbackSourceLocationForContent <Boolean>]
[-DeleteImmediately]
[-EnableRestoreOnlyMode <Boolean>]
-InputObject <IResultObject>
[-PassThru]
[-RemoveBoundaryGroupName <String[]>]
[-RemoveStorageFolder <StorageDirectoryData[]>]
[-TimeDeleteAfter <Int32>]
[-TimeUnit <IntervalType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMStateMigrationPoint
[-AddBoundaryGroupName <String[]>]
[-AddStorageFolder <StorageDirectoryData[]>]
[-AllowFallbackSourceLocationForContent <Boolean>]
[-DeleteImmediately]
[-EnableRestoreOnlyMode <Boolean>]
[-PassThru]
[-RemoveBoundaryGroupName <String[]>]
[-RemoveStorageFolder <StorageDirectoryData[]>]
[-SiteCode <String>]
[-SiteSystemServerName] <String>
[-TimeDeleteAfter <Int32>]
[-TimeUnit <IntervalType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Set-CMStateMigrationPoint Cmdlet 會修改 Configuration Manager 中狀態移轉點的設定。 狀態移轉點是一種月台系統角色，可在操作系統安裝程式期間管理用戶端計算機的數據傳輸。 使用此 Cmdlet 修改與移轉點相關聯的界限群組和記憶體資料夾、在移轉點刪除客戶端資料之前等待多久、是否允許內容的後援來源位置，以及是否啟用僅限還原模式。
您可以使用站台系統伺服器名稱和月臺碼來指定要修改的移轉點，或使用 Get-CMStateMigrationPoint Cmdlet。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：修改狀態移轉點
PS XYZ:\> $StateMigrationPoint = Get-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com"
PS XYZ:\> Set-CMStateMigrationPoint -InputObject $StateMigrationPoint -AllowFallbackSourceLocationForContent $True -TimeDeleteAfter 12 -TimeUnit Hours本範例會針對具有 CM4 程式代碼的月臺修改名為 MigrationServer.TSQA.Contoso.com 的移轉點。 此範例會變更移轉點以允許內容的後援來源位置，並修改數據下載後要刪除數據的時間長度。
第一個命令會使用 Get-CMStateMigrationPoint Cmdlet 來取得指定月臺碼和伺服器名稱的移轉點，並將它儲存在$StateMigrationPoint變數中。
第二個命令會修改儲存在$StateMigrationPoint變數中的輸入物件。 命令會將 AllowFallbackSourceLocationForContent 參數設定為$True，並將刪除時間修改為12小時。
範例 2：修改狀態移轉點的記憶體資料夾和界限群組
PS XYZ:\> $Storage01 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 100 -SpaceUnit Megabyte -StorageFolderName "C:\"
PS XYZ:\> $Storage02 = New-CMStoragefolder -MaximumClientNumber 100 -MinimumFreeSpace 10 -SpaceUnit Gigabyte -StorageFolderName "D:\"
PS XYZ:\> Set-CMStateMigrationPoint -SiteCode "CM4" -SiteSystemServerName "MigrationServer.TSQA.Contoso.com" -AddBoundaryGroupName "BG07" -AddStorageFolder $Storage02 -AllowFallbackSourceLocationForContent $False -DeleteImmediately -EnableRestoreOnlyMode $True -RemoveBoundaryGroupName "BG22" -RemoveStorageFolder $Storage01本範例會修改網站代碼為 CM4 的月臺，名為 MigrationServer.TSQA.Contoso.com 的狀態移轉點設定。 此範例會取代不同的界限群組和不同的記憶體資料夾，並修改其他設定。
第一個命令會使用 New-CMStoragefolder Cmdlet 來建立記憶體資料夾物件，並將它儲存在 $Storage 01 變數中。 如需詳細資訊，請參閱該 Cmdlet 的檔。
第二個命令會使用 New-CMStoragefolder Cmdlet 來建立記憶體資料夾物件，並將它儲存在 $Storage 02 變數中。
第三個命令會從移轉點移除儲存在 $Storage 01 變數中的記憶體資料夾，並在同一個命令中，將儲存在 $Storage 02 變數中的記憶體資料夾新增至移轉點。 同樣地，命令會移除名為 BG22 的界限群組，並新增名為 BG07 的界限群組。 命令也會指定 AllowFallbackSourceLocationForContent 參數的$False值，以及 EnableRestoreOnlyMode 參數的 $True 值。 命令使用 DeleteImmediately 參數;因此，移轉點會在下載之後立即刪除客戶端資訊。
參數
-AddBoundaryGroupName
指定界限組名的陣列。 Cmdlet 會將這些界限群組新增至狀態移轉點。 在移轉期間，界限群組中的用戶端會使用此網站作為內容的來源位置。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AddStorageFolder
指定記憶體資料夾的陣列，做為記憶體目錄資料物件。 Cmdlet 會將這些資料夾新增至狀態移轉點。 若要取得記憶體目錄數據物件，請使用 New-CMStoragefolder Cmdlet。
狀態移轉點會在將電腦移轉至新的作業系統時儲存用戶狀態數據。
| 類型: | StorageDirectoryData[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-AllowFallbackSourceLocationForContent
指出後援來源位置是否可用。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DeleteImmediately
指出刪除客戶端數據會在目標計算機下載該數據之後立即發生。 如果您選取$False值，請使用 TimeDeleteAfter 和 TimeUnit 參數來指定等候多久。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-EnableRestoreOnlyMode
指出是否啟用僅限還原模式。 在僅限還原模式中，Configuration Manager 會拒絕儲存客戶端數據的新要求。
| 類型: | Boolean |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定狀態移轉點物件。 若要取得狀態移轉點物件，請使用 Get-CMStateMigrationPoint Cmdlet。
| 類型: | IResultObject |
| 別名: | StateMigrationPoint |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-PassThru
新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RemoveBoundaryGroupName
指定界限組名的陣列。 Cmdlet 會從狀態移轉點移除這些界限群組。 在移轉期間，界限群組中的用戶端會使用此網站作為內容的來源位置。
| 類型: | String[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-RemoveStorageFolder
指定記憶體資料夾的陣列，做為記憶體目錄資料物件。 Cmdlet 會從狀態移轉點移除這些資料夾。 狀態移轉點會在將電腦移轉至新的作業系統時儲存用戶狀態數據。
| 類型: | StorageDirectoryData[] |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SiteCode
指定 Configuration Manager 月臺的月臺碼。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-SiteSystemServerName
指定狀態移轉點的主機名。
| 類型: | String |
| 別名: | Name, ServerName |
| Position: | 0 |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TimeDeleteAfter
指定目標電腦下載數據以刪除該數據之後要等待的時間量。 使用 TimeUnit 參數指定時間單位。 若要立即刪除數據，請為 DeleteImmediately 參數指定$True值。
| 類型: | Int32 |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-TimeUnit
為 TimeDeleteAfter 參數中指定的值指定時間單位。 此參數可接受的值為：天數和時數。
| 類型: | IntervalType |
| 接受的值: | Hours, Days |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
IResultObject