Compartir a través de

New-CMTSStepRestoreUserState

  • Referencia
Módulo:
ConfigurationManager

Cree un paso Restaurar estado de usuario , que puede agregar a una secuencia de tareas.

Sintaxis

New-CMTSStepRestoreUserState
   [-ConfigFile <String[]>]
   [-ContinueOnRestore <Boolean>]
   [-ModeOption <ModeType>]
   -Package <IResultObject>
   [-Password <SecureString>]
   [-RestoreLocalAccount <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 Restaurar 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: Restaurar estado de usuario.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio Configuration Manager, por ejemploPS 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 Restaurar 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-CMTSStepRestoreUserState -Name "Restore User State" -Package $pkgUsmt -ModeOption Standard -VerboseLogging $true -ContinueOnRestore $true -RestoreLocalAccount $false

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

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

Pará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 restauran 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

-ContinueOnRestore

Establezca este parámetro $true en para continuar restaurando el estado del usuario y la configuración, incluso si USMT no puede restaurar 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

-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: restaure todos los perfiles de usuario capturados con opciones estándar. Esta es la opción predeterminada.

  • Customize: personalice cómo se restauran 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

-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

-Password

Si habilita el parámetro RestoreLocalAccount , use este parámetro para asignar una nueva contraseña a las cuentas de usuario locales restauradas. USMT no puede migrar las contraseñas originales. Especifique una cadena segura para la contraseña de la cuenta local.

Tipo:SecureString
Alias:NewPasswordForLocalAccount
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RestoreLocalAccount

Establezca este parámetro $true en para restaurar los perfiles de usuario del equipo local. Estos perfiles no son para usuarios de dominio. USMT no puede migrar las contraseñas originales. Para asignar nuevas contraseñas a las cuentas de usuario locales restauradas, use el parámetro Password .

Tipo:Boolean
Alias:RestoreLocalComputerUserProfile
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_RestoreUserStateAction clase WMI de servidor.