New-CMTSStepApplyDataImage

  • Referencia
Módulo:
ConfigurationManager

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

Syntax

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.

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

-Confirm

Solicitará confirmación antes de ejecutar el cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:DestinationType
Accepted values:NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:DestinationLogicalDrive
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:DestinationVariableName
Position:Named
Default value:None
Required:False
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
Required:False
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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

Type:IResultObject
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ImagePackageIndex

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

Type:Int32
Position:Named
Default value:None
Required:True
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
Required:True
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
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Boolean
Aliases:WipePartitionBeforeApplyImage
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.