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>] 说明
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