Compartir a través de

New-CMTSStepApplyOperatingSystem

  • Referencia
Módulo:
ConfigurationManager

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

Sintaxis

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 Apply OS 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 del sistema operativo.

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

$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

-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

-ConfigFileName

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

Tipo:String
Alias:AnswerFileName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:IResultObject
Alias:AnswerFilePackage
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 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 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 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 .

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:False
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:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

Tipo:IResultObject
Alias:UpgradePackage
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 .

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

-LayeredDriver

A partir de la versión 2107, use este parámetro para seleccionar otros tipos de teclados que sean comunes a 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 .

Tipo:OsdLayeredDriver
Alias:KeyboardDriver
Valores aceptados:DoNotSpecify, Driver1, Driver2, Driver3, Driver4, Driver5, Driver6
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

-RunFromNet

Establezca este parámetro $true en para 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, consulte Acceso al contenido directamente desde el punto de distribución.

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