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
此示例修改名为 MigrationServer.TSQA.Contoso.com CM4 的站点的迁移点。 该示例更改迁移点以允许内容的回退源位置,并修改数据下载后删除数据所经过的多久。
第一个命令使用 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
此示例修改名为"MigrationServer.TSQA.Contoso.com CM4 的站点的状态迁移点的设置。 该示例替换了不同的边界组和不同的存储文件夹,并修改了其他设置。
第一个命令使用 New-CMStoragefolder cmdlet 创建存储文件夹对象,并存储到 $Storage 01 变量中。 有关详细信息,请参阅该 cmdlet 的文档。
第二个命令使用 New-CMStoragefolder cmdlet 创建存储文件夹对象,并存储到 $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 会将这些文件夹添加到状态迁移点。 若要获取存储目录数据对象,请使用 New-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
指定状态迁移点对象。 若要获取状态迁移点对象,请使用 Get-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 参数中指定的值指定时间单位。 此参数的可接受值为:Days 和 Hours。
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 |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
IResultObject