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

说明

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