Set-CMStateMigrationPoint
在 Configuration Manager 中修改狀態遷移點的設定。
Syntax
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
CMStateMigrationPoint Cmdlet 會修改 設定 管理員中狀態遷移點的設定。 狀態遷移點是一種網站系統角色，可在作業系統安裝過程中管理從用戶端電腦傳送的資料。 使用此 Cmdlet 可修改與遷移點相關聯的邊界群組和儲存資料夾，在遷移點刪除用戶端資料之前需要等候多久，是否允許內容的回退來源位置，以及是否要啟用僅限還原模式。
您可以使用網站系統伺服器名稱和網站代碼來指定要修改的遷移點，或使用 CMStateMigrationPoint 指令程式 。
注意
從 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此範例會修改名為 MigrationServer.TSQA.Contoso.com 的 CM4 程式碼為之網站的遷移點。 此範例會變更遷移點，以允許內容的回退來源位置，並修改資料下載之後多久刪除資料。
第一個命令會使用 CMStateMigrationPoint 指令程式 來取得指定之網站代碼和伺服器名稱的遷移點，並將其儲存在 $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此範例會修改名為 MigrationServer.TSQA.Contoso.com 的網站代碼為 CM4 之網站的狀態遷移點的設定。 這個範例會取代不同的邊界群組和不同的儲存體資料夾，並且修改其他設定。
第一個命令會使用 CMStoragefolder Cmdlet 來建立 storage folder 物件，並將它儲存在 $Storage 01 變數中。 如需詳細資訊，請參閱該 Cmdlet 的檔。
第二個命令會使用 CMStoragefolder Cmdlet 來建立 storage folder 物件，並將它儲存在 $Storage 的02變數中。
第三個命令會從遷移點移除儲存在 $Storage 01 變數中的儲存資料夾，然後在同一個命令中，將儲存于 $Storage 02 變數中的儲存資料夾新增到遷移點。 同樣地，此命令會移除名為 BG22 的邊界群組，並新增名為 BG07 的邊界群組。 此命令也會指定 AllowFallbackSourceLocationForContent 參數的 $False 值，以及 EnableRestoreOnlyMode 參數的值為 $True。 命令會使用 DeleteImmediately 參數;因此，遷移點會在下載之後立即刪除用戶端資訊。
參數
-AddBoundaryGroupName
指定邊界群組名稱的陣列。 Cmdlet 會將這些邊界群組新增至狀態遷移點。 在遷移期間，邊界群組中的用戶端會使用此網站做為內容的來源位置。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AddStorageFolder
將儲存資料夾陣列指定為儲存目錄資料物件。 Cmdlet 會將這些資料夾新增至狀態遷移點。 若要取得儲存目錄資料物件，請使用 CMStoragefolder Cmdlet。
狀態遷移點會在將電腦遷移至新作業系統時，儲存使用者狀態資料。
| Type: | StorageDirectoryData[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowFallbackSourceLocationForContent
會指出是否可使用回退來源位置。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeleteImmediately
表示在目的電腦下載該資料後，會立即發生用戶端資料刪除。 如果您選取 [$False] 的值，請使用 TimeDeleteAfter 和 TimeUnit 參數，指定等候的時間。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableRestoreOnlyMode
會指出是否要啟用僅限還原模式。 在 [僅還原] 模式中，Configuration Manager 會拒絕新的要求儲存用戶端資料。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元，而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定狀態遷移點物件。 若要取得狀態遷移點物件，請使用 CMStateMigrationPoint Cmdlet。
| Type: | IResultObject |
| Aliases: | StateMigrationPoint |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
新增此參數可傳回代表您正在使用之專案的物件。 根據預設，此 Cmdlet 可能不會產生任何輸出。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveBoundaryGroupName
指定邊界群組名稱的陣列。 Cmdlet 會從狀態遷移點移除這些邊界群組。 在遷移期間，邊界群組中的用戶端會使用此網站做為內容的來源位置。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveStorageFolder
將儲存資料夾陣列指定為儲存目錄資料物件。 Cmdlet 會從狀態遷移點移除這些資料夾。 狀態遷移點會在將電腦遷移至新作業系統時，儲存使用者狀態資料。
| Type: | StorageDirectoryData[] |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SiteCode
指定 Configuration Manager 網站的網站程式碼。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SiteSystemServerName
指定狀態遷移點的主機名稱。
| Type: | String |
| Aliases: | Name, ServerName |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeDeleteAfter
指定目的電腦下載資料以刪除資料時所需等待的時間。 使用 TimeUnit 參數指定時間單位。 若要立即刪除資料，請將 DeleteImmediately 參數的值指定為 $True。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeUnit
指定 TimeDeleteAfter 參數中所指定之值的時間單位。 此參數可接受的值包括：天和小時。
| Type: | IntervalType |
| Accepted values: | Hours, Days |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
IResultObject