New-CMTSStepApplyOperatingSystem

  • Referencia
Módulo:
ConfigurationManager

Cree un paso Aplicar imagen del sistema operativo, que puede agregar a una secuencia de tareas.

Syntax

New-CMTSStepApplyOperatingSystem
   [-ConfigFileName <String>]
   [-ConfigFilePackage <IResultObject>]
   [-Destination <DestinationType>]
   [-DestinationDisk <Int32>]
   [-DestinationDriveLetter <String>]
   [-LayeredDriver <OsdLayeredDriver>]
   [-DestinationPartition <Int32>]
   [-DestinationVariable <String>]
   [-ImagePackage <IResultObject>]
   [-ImagePackageIndex <Int32>]
   [-InstallPackage <IResultObject>]
   [-InstallPackageIndex <Int32>]
   [-RunFromNet <Boolean>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet crea un nuevo objeto de paso Aplicar imagen del sistema operativo. 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: Apply OS Image.

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 usa primero el cmdlet Get-CMOperatingSystemImage para obtener un objeto para el paquete de imagen del sistema operativo. Guarda este objeto en la $osImgPkg variable. El siguiente paso crea un objeto para el paso Aplicar imagen del sistema operativo, usando el $osImgPkg como el 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.

$osImgPkg = Get-CMOperatingSystemImage -Name "OSImagePkg01"
$step = New-CMTSStepApplyOperatingSystem -Name "Apply OS image" -ImagePackage $osImgPkg -ImagePackageIndex 1

$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

-ConfigFileName

Especifique el nombre de archivo de un archivo de respuesta desatendido o sysprep que se usará para una instalación personalizada. Use este parámetro con el parámetro ConfigFilePackage.

Type:String
Aliases:AnswerFileName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ConfigFilePackage

Especifique un objeto de paquete que incluya el archivo de respuesta desatendido o Sysprep que se usará para una instalación personalizada. Para obtener este objeto, use el cmdlet Get-CMPackage. Use este parámetro con el parámetro ConfigFileName.

Type:IResultObject
Aliases:AnswerFilePackage
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

-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

-Destination

Especifique la ubicación en la que desea aplicar este sistema operativo. Si no especifica este parámetro, el valor predeterminado es NextAvailableFormattedPartition .

  • NextAvailableFormattedPartition: use la siguiente partición secuencial que aún no está dirigida por 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 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 normalmente se establece con el parámetro DiskNumberVariable de los cmdlets Set-CMTSStepPartitionDisk o New-CMTSStepPartitionDisk para el paso de secuencia de tareas Format y Partition Disk.

Type:DestinationType
Accepted values:NextAvailableFormattedPartition, SpecificDiskAndPartition, SpecificLogicalDriverLetter, LogicalDriverLetterInVariable
Position:Named
Default value:None
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 número entero de 0 a 99 . También use el parámetro DestinationPartition.

Type:Int32
Position:Named
Default value:None
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 Z a .

Type:String
Aliases:DestinationLogicalDrive
Position:Named
Default value:None
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 número entero de 1 a 99 . También use el parámetro DestinationDisk.

Type:Int32
Position:Named
Default value:None
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 variable debe ser alfanumérico sin espacios y con menos de 256 caracteres.

Type:String
Aliases:DestinationVariableName
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

-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

-ImagePackage

Especifique un objeto de paquete de imagen del sistema operativo. El paso aplica el sistema operativo desde 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
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
Accept pipeline input:False
Accept wildcard characters:False

-InstallPackage

Especifique un objeto de paquete de actualización del sistema operativo. El paso aplica el sistema operativo desde este origen de instalación original. Use el parámetro InstallPackageIndex para establecer la edición.

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

Type:IResultObject
Aliases:UpgradePackage
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InstallPackageIndex

Especifique un valor entero de la edición del paquete de actualización del sistema operativo. Use este parámetro con el parámetro InstallPackage.

Type:Int32
Aliases:UpgradePackageIndex
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-LayeredDriver

A partir de la versión 2107, use este parámetro para seleccionar otros tipos de teclados que son comunes con los idiomas japonés y coreano. Especifique un valor entero para que el controlador en capas se instale con Windows. Use los mismos valores que la variable de secuencia de tareas OsdLayeredDriver.

Type:OsdLayeredDriver
Aliases:KeyboardDriver
Accepted values:DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6
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

-RunFromNet

Establezca este parámetro para $true permitir que la secuencia de tareas aplique la imagen del sistema operativo directamente desde el punto de distribución.

Para mayor seguridad, se recomienda no habilitar esta configuración. Esta opción está diseñada para su uso en dispositivos con capacidad de almacenamiento limitada. Para obtener más información, vea Access content directly from the distribution point.

Type:Boolean
Aliases:AllowAccessFromDistributionPoint
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_ApplyOperatingSystemAction server WMI class.