New-CMTSStepCaptureUserState

模块:

ConfigurationManager

创建 "捕获用户状态 "步骤，可将其添加到任务序列。

语法

New-CMTSStepCaptureUserState
   [-ConfigFile <String[]>]
   [-ContinueOnLockedFile <Boolean>]
   [-FileAccessOption <FileAccessType>]
   [-ModeOption <ModeType>]
   [-OfflineUserState <Boolean>]
   -Package <IResultObject>
   [-SkipEncryptedFile <Boolean>]
   [-UseHardLinks <Boolean>]
   [-VerboseLogging <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

此 cmdlet 创建新的 捕获用户状态 步骤对象。 然后使用 Add-CMTaskSequenceStep cmdlet 将步骤添加到任务序列。 有关此步骤详细信息，请参阅关于 任务序列步骤：捕获用户状态。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。 有关详细信息，请参阅 入门。

示例

示例 1

此示例首先获取 USMT 中用户状态迁移工具 (包) 。 下一行为捕获用户状态步骤创建**** 一个对象，该步骤使用该 USMT 程序包并配置多个步骤设置。 然后，它获取一个任务序列对象，并将这个新步骤添加到索引为 11 的任务序列。

$pkgUsmt = Get-CMPackage -Name "User State Migration Tool for Windows" -Fast

$step = New-CMTSStepCaptureUserState -Name "Capture User State" -Package $pkgUsmt -ModeOption Standard -VerboseLogging $true -FileAccessOption Normal -ContinueOnLockedFile $true -UseHardLinks $true

$tsNameOsd = "Default OS deployment"
$tsOsd = Get-CMTaskSequence -Name $tsNameOsd -Fast

$tsOsd | Add-CMTaskSequenceStep -Step $step -InsertStepStartIndex 11

参数

-Condition

指定要用于此步骤的条件对象。 若要获取此对象，请使用任务序列条件 cmdlet 之一。 例如 ，Get-CMTSStepConditionVariable。

Type:	IResultObject[]
Aliases:	Conditions
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigFile

当您指定自定义如何捕获用户配置文件时，请使用此参数指定自定义 XML 配置文件 -ModeOption Customize 的文件名。 这些文件需在 USMT 程序包中。

Type:	String[]
Aliases:	ConfigFiles
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueOnError

添加此参数以启用步骤选项 "错误时继续"。 启用此选项后，如果步骤失败，任务序列将继续。

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinueOnLockedFile

指定 时 -FileAccessOption Normal ，如果无法捕获某些文件，则设置此参数以允许 $true USMT 继续。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Disable

添加此参数可禁用此任务序列步骤。

Type:	SwitchParameter
Aliases:	DisableThisStep
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

-FileAccessOption

USMT 如何访问文件系统有两个选项：

• Normal：USMT 使用标准文件系统访问。 指定此选项时，还可以启用ContinueOnLockedFile、OfflineUserState和**** - 。

• VolumeCopyShadowService：USMT 使用 VSS (卷影) 。

Type:	FileAccessType
Accepted values:	Normal, VolumeCopyShadowService
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

-ModeOption

USMT 可在两种模式下运行：

• Standard：使用标准选项捕获所有用户配置文件。 此选项为默认选项。

• Customize：自定义如何捕获用户配置文件。 如果指定此选项，请使用 ConfigFile 参数指定自定义 XML 配置文件。

Type:	ModeType
Accepted values:	Standard, Customize
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-OfflineUserState

指定 时 -FileAccessOption Normal ，将此参数设置为以脱机模式在 $true WINDOWS PE 中捕获。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Package

为 USMT 程序包指定对象。 若要获取此对象，请使用 Get-CMPackage cmdlet。

Type:	IResultObject
Aliases:	UserStateMigrationToolPackage
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipEncryptedFile

设置此参数 $true 以跳过使用 EFS (加密文件系统) 。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseHardLinks

指定 时 -FileAccessOption Normal ，请设置此参数以使用 $true NTFS 硬链接在本地捕获。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-VerboseLogging

设置此参数 $true 以启用 USMT 详细日志记录。

Type:	Boolean
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-名称

指定此步骤的名称以在任务序列中标识它。

Type:	String
Aliases:	StepName
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-描述

指定此任务序列步骤的可选说明。

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

输入

无

输出

IResultObject

备注

有关此返回对象及其属性的信息，请参阅SMS_TaskSequence_CaptureUserStateAction WMI 类。

相关链接

• Get-CMTSStepCaptureUserState
• Remove-CMTSStepCaptureUserState
• Set-CMTSStepCaptureUserState
• 关于任务序列步骤：捕获用户状态