New-CMTSStepCaptureUserState
Cree un paso Capturar estado de usuario, que puede agregar a una secuencia de tareas.
Syntax
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>]
Description
Este cmdlet crea un nuevo objeto de paso Capturar estado de usuario. A continuación, use el cmdlet Add-CMTaskSequenceStep para agregar el paso a una secuencia de tareas. Para obtener más información sobre este paso, vea About task sequence steps: Capture User State.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1
En este ejemplo se obtiene primero un objeto de paquete para la Herramienta de migración de estado de usuario (USMT). La siguiente línea crea un objeto para el paso Capturar estado de usuario, que usa ese paquete USMT y configura varias opciones de paso. A continuación, obtiene un objeto de secuencia de tareas y agrega este nuevo paso a la secuencia de tareas en el índice 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
Parámetros
- Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Condition
Especifique un objeto de condición que se usará con este paso. Para obtener este objeto, use uno de los cmdlets de condición de secuencia de tareas. Por ejemplo, Get-CMTSStepConditionVariable.
Type: | IResultObject[] |
Aliases: | Conditions |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigFile
Cuando especifique para personalizar cómo se capturan los perfiles de usuario, use este parámetro para especificar los nombres de archivo de los archivos de configuración -ModeOption Customize
XML personalizados. Estos archivos deben estar en el paquete USMT.
Type: | String[] |
Aliases: | ConfigFiles |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnError
Agregue este parámetro para habilitar la opción de paso Continuar con el error. Al habilitar esta opción, si se produce un error en el paso, la secuencia de tareas continúa.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinueOnLockedFile
Cuando especifique , establezca este parámetro para permitir que USMT continúe -FileAccessOption Normal
si algunos archivos no se pueden $true
capturar.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Description
Especifique una descripción opcional para este paso de secuencia de tareas.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Disable
Agregue este parámetro para deshabilitar este paso de secuencia de tareas.
Type: | SwitchParameter |
Aliases: | DisableThisStep |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FileAccessOption
Hay dos opciones para obtener acceso a USMT al sistema de archivos:
Normal
: USMT usa el acceso al sistema de archivos estándar. Al especificar esta opción, también puede habilitar ContinueOnLockedFile, OfflineUserStatey - .VolumeCopyShadowService
: USMT usa los Servicios de instantáneas de copia por volumen (VSS).
Type: | FileAccessType |
Accepted values: | Normal, VolumeCopyShadowService |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ModeOption
Existen dos modos en los que USMT puede funcionar:
Standard
: capture todos los perfiles de usuario mediante opciones estándar. Esta es la opción predeterminada.Customize
: personalice cómo se capturan los perfiles de usuario. Si especifica esta opción, use el parámetro ConfigFile para especificar los archivos de configuración XML personalizados.
Type: | ModeType |
Accepted values: | Standard, Customize |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Especifique un nombre para este paso para identificarlo en la secuencia de tareas.
Type: | String |
Aliases: | StepName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OfflineUserState
Cuando especifique , establezca este parámetro en para capturar en modo sin -FileAccessOption Normal
$true
conexión en Windows PE.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Package
Especifique un objeto para el paquete USMT. Para obtener este objeto, use el cmdlet Get-CMPackage.
Type: | IResultObject |
Aliases: | UserStateMigrationToolPackage |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipEncryptedFile
Establezca este parámetro para $true
omitir los archivos que usan el sistema de archivos de cifrado (EFS).
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseHardLinks
Cuando especifique -FileAccessOption Normal
, establezca este parámetro en para capturar $true
localmente mediante vínculos duros NTFS.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VerboseLogging
Establezca este parámetro para habilitar el registro detallado de $true
USMT.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Ninguno
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_CaptureUserStateAction server WMI class.