共用方式為

Set-CMStateMigrationPoint

  • 參考
模組:
ConfigurationManager

修改 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