New-CMTSStepCaptureUserState
Cree un paso Capturar estado de usuario , que puede agregar a una secuencia de tareas.
Sintaxis
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 Acerca de los pasos de secuencia de tareas: Capturar estado de usuario.
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.
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 11Parámetros
-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.
| Tipo: | IResultObject[] |
| Alias: | Conditions |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ConfigFile
Cuando especifique -ModeOption Customize 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 XML personalizados. Estos archivos deben estar en el paquete USMT.
| Tipo: | String[] |
| Alias: | ConfigFiles |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ContinueOnError
Agregue este parámetro para habilitar la opción de paso Continuar en caso de error. Al habilitar esta opción, si se produce un error en el paso, la secuencia de tareas continúa.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ContinueOnLockedFile
Cuando especifique -FileAccessOption Normal, establezca este parámetro $true en para permitir que USMT continúe si no se pueden capturar algunos archivos.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Description
Especifique una descripción opcional para este paso de secuencia de tareas.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Disable
Agregue este parámetro para deshabilitar este paso de secuencia de tareas.
| Tipo: | SwitchParameter |
| Alias: | DisableThisStep |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FileAccessOption
Hay dos opciones para el acceso de USMT al sistema de archivos:
Normal: USMT usa el acceso estándar al sistema de archivos. Al especificar esta opción, también puede habilitar ContinueOnLockedFile, OfflineUserState y -.VolumeCopyShadowService: USMT usa Volume Copy Shadow Services (VSS).
| Tipo: | FileAccessType |
| Valores aceptados: | Normal, VolumeCopyShadowService |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ModeOption
Hay dos modos en los que USMT puede funcionar:
Standard: capture todos los perfiles de usuario mediante las 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.
| Tipo: | ModeType |
| Valores aceptados: | Standard, Customize |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Especifique un nombre para este paso para identificarlo en la secuencia de tareas.
| Tipo: | String |
| Alias: | StepName |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-OfflineUserState
Cuando especifique -FileAccessOption Normal, establezca este parámetro $true en para capturarlo en modo sin conexión en Windows PE.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Package
Especifique un objeto para el paquete USMT. Para obtener este objeto, use el cmdlet Get-CMPackage .
| Tipo: | IResultObject |
| Alias: | UserStateMigrationToolPackage |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-SkipEncryptedFile
Establezca este parámetro $true en para omitir los archivos que usan el sistema de cifrado de archivos (EFS).
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-UseHardLinks
Cuando especifique -FileAccessOption Normal, establezca este parámetro $true en para capturar localmente mediante vínculos duros NTFS.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VerboseLogging
Establezca este parámetro $true en para habilitar el registro detallado de USMT.
| Tipo: | Boolean |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_CaptureUserStateAction clase WMI de servidor.