Compartir a través de

New-CMTSStepApplyDataImage

  • Referencia
Módulo:
ConfigurationManager

Cree un paso Aplicar imagen de datos , que puede agregar a una secuencia de tareas.

Sintaxis

New-CMTSStepApplyDataImage
   [-Destination <DestinationType>]
   [-DestinationDisk <Int32>]
   [-DestinationDriveLetter <String>]
   [-DestinationPartition <Int32>]
   [-DestinationVariable <String>]
   -ImagePackage <IResultObject>
   -ImagePackageIndex <Int32>
   [-WipePartition <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet crea un nuevo objeto de paso Apply Data Image . 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: Aplicar imagen de datos.

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 usa primero el cmdlet Get-CMOperatingSystemImage para obtener un objeto para el paquete de imagen de datos. Guarda este objeto en la variable $pkgDataImg . En el paso siguiente se crea un objeto para el paso Aplicar imagen de datos , utilizando el objeto $pkgDataImg como paquete de imagen.

A continuación, obtiene un objeto de secuencia de tareas y agrega este nuevo paso a la secuencia de tareas en el índice 11.

$pkgDataImg = Get-CMOperatingSystemImage -Name "Data image"
$step = New-CMTSStepApplyDataImage -Name "Apply data image" -ImagePackage $pkgDataImg -ImagePackageIndex 1

$tsName = "Custom task sequence"
$ts = Get-CMTaskSequence -Name $tsName -Fast

$ts | 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

-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

-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

-Destination

Especifique la ubicación donde desea aplicar esta imagen de datos. Si no especifica este parámetro, el valor predeterminado es NextAvailableFormattedPartition.

  • NextAvailableFormattedPartition: use la siguiente partición secuencial que aún no tiene como destino un paso Aplicar sistema operativo o Aplicar imagen de datos en esta secuencia de tareas.

  • SpecificDiskAndPartition: especifique el número de disco con el parámetro DestinationDisk y el número de partición con el parámetro DestinationPartition .

  • SpecificLogicalDriverLetter: use el parámetro DestinationDriveLetter para especificar la letra de unidad lógica asignada a la partición por Windows PE. Esta letra de unidad puede ser diferente de la letra de unidad asignada por el sistema operativo recién implementado.

  • LogicalDriverLetterInVariable: use el parámetro DestinationVariable para especificar la variable de secuencia de tareas que contiene la letra de unidad asignada a la partición por Windows PE. Esta variable se establece normalmente con el parámetro DiskNumberVariable del paso de secuencia de tareas Set-CMTSStepPartitionDisk o New-CMTSStepPartitionDisk para el paso de secuencia de tareas Formato y disco de partición .

Tipo:DestinationType
Valores aceptados:NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DestinationDisk

Cuando use -Destination SpecificDiskAndPartition, use este parámetro para especificar el número de disco. Especifique un entero de 0 a 99. Use también el parámetro DestinationPartition .

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

-DestinationDriveLetter

Cuando use -Destination SpecificLogicalDriverLetter, use este parámetro para especificar la letra de unidad lógica. Especifique una letra de unidad de C a Z.

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

-DestinationPartition

Cuando use -Destination SpecificDiskAndPartition, use este parámetro para especificar el número de partición. Especifique un entero de 1 a 99. Use también el parámetro DestinationDisk .

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

-DestinationVariable

Cuando use -Destination LogicalDriverLetterInVariable, use este parámetro para especificar la variable de secuencia de tareas con la letra de unidad lógica. El nombre de la variable debe ser alfanumérico sin espacios y menos de 256 caracteres.

Tipo:String
Alias:DestinationVariableName
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

-ImagePackage

Especifique un objeto de paquete de imagen de datos. El paso aplica los datos de esta imagen. Use el parámetro ImagePackageIndex para establecer el índice de imagen.

Para obtener este objeto, use el cmdlet Get-CMOperatingSystemImage .

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ImagePackageIndex

Especifique un valor entero del índice de imagen. Use este parámetro con el parámetro ImagePackage .

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
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

-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

-WipePartition

Esta configuración está habilitada de forma predeterminada, lo que elimina todo el contenido de la partición antes de aplicar la imagen.

Establezca este parámetro $false en para no eliminar el contenido anterior de la partición. Esta acción se puede usar para aplicar más contenido a una partición de destino anterior.

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