Compartir a través de

New-CMTSStepUpgradeOperatingSystem

  • Referencia
Módulo:
ConfigurationManager

Cree un paso actualizar sistema operativo , que puede agregar a una secuencia de tareas.

Sintaxis

New-CMTSStepUpgradeOperatingSystem
   [-DriverPackage <IResultObject>]
   [-DynamicUpdateSetting <DynamicUpdateOption>]
   [-EditionIndex <Int32>]
   [-IgnoreMessage <Boolean>]
   [-ProductKey <String>]
   [-ScanOnly <Boolean>]
   [-SetupTimeout <Int32>]
   [-SourcePath <String>]
   [-StagedContent <String>]
   [-UpgradePackage <IResultObject>]
   [-SoftwareUpdate <IResultObject[]>]
   [-Condition <IResultObject[]>]
   [-ContinueOnError]
   [-Description <String>]
   [-Disable]
   -Name <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Este cmdlet crea un nuevo objeto de paso actualizar el 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 Acerca de los pasos de secuencia de tareas: Actualización 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-CMOperatingSystemInstaller para obtener un objeto para el paquete de actualización del sistema operativo. Guarda este objeto en la variable $osUpgPkg . En el paso siguiente se crea un objeto para el paso Actualizar sistema operativo , utilizando el objeto $osUpgPkg como paquete de actualización del sistema operativo.

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

$osUpgPkg = Get-CMOperatingSystemInstaller -Name "OSUpgradePkg01"
$step = New-CMTSStepUpgradeOperatingSystem -Name "Upgrade OS" -UpgradePackage $osUpgPkg -EditionIndex 1

$tsNameOsd = "Default OS upgrade"
$tsUpg = Get-CMTaskSequence -Name $tsNameOsd -Fast

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

-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

-DriverPackage

Especifique un objeto de paquete de controlador para proporcionar su contenido de controlador al programa de instalación de Windows durante la actualización. Para obtener este paquete, use el cmdlet Get-CMDriverPackage .

Use el parámetro StagedContent para especificar la ubicación del contenido del controlador.

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

-DynamicUpdateSetting

Use este parámetro para actualizar dinámicamente el programa de instalación de Windows con Windows Update.

  • DisablePolicy: no use la actualización dinámica
  • UsingPolicy: habilite el programa de instalación para usar la actualización dinámica, como las actualizaciones de búsqueda, descarga e instalación.
  • OverridePolicy: invalide temporalmente la directiva local en tiempo real para ejecutar operaciones de actualización dinámica. El equipo obtiene actualizaciones de Windows Update.
Tipo:DynamicUpdateOption
Valores aceptados:DisablePolicy, UsingPolicy, OverridePolicy
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EditionIndex

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

Tipo:Int32
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

-IgnoreMessage

Establezca este parámetro $true en para especificar que el programa de instalación de Windows complete la instalación, omitiendo los mensajes de compatibilidad descartables.

Tipo:Boolean
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

-ProductKey

Especifique la clave de producto que se va a aplicar al proceso de actualización.

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

-ScanOnly

Establezca este parámetro $true en para ejecutar el examen de compatibilidad del programa de instalación de Windows sin iniciar la actualización.

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

-SetupTimeout

Especifique el número de minutos antes de que Configuration Manager produzca un error en este paso. Esta opción es útil si el programa de instalación de Windows deja de procesarse, pero no finaliza.

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

-SoftwareUpdate

A partir de la versión 2107, especifique un objeto de actualización de software para actualizar el sistema operativo Windows de un cliente mediante una actualización de características. Para obtener este objeto, use el cmdlet Get-CMSoftwareUpdate .

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

-SourcePath

Especifique una ruta de acceso local o de red a los medios de Windows que usa el programa de instalación de Windows.

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

-StagedContent

Use este parámetro con DriverPackage para especificar la ubicación del contenido del controlador. Puede especificar una carpeta local, una ruta de acceso de red o una variable 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

-UpgradePackage

Especifique un objeto de paquete de actualización del sistema operativo. Use el parámetro EditionIndex para establecer la edición.

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

Tipo:IResultObject
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_UpgradeOperatingSystemAction clase WMI de servidor.