New-CMTSStepUpgradeOperatingSystem

  • Referencia
Módulo:
ConfigurationManager

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

Syntax

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: Actualizar sistema operativo.

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-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.

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

-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

-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.

Type:IResultObject
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.
Type:DynamicUpdateOption
Accepted values:DisablePolicy, UsingPolicy, OverridePolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 .

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

-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.

Type:Boolean
Position:Named
Default value:None
Required:False
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

-ProductKey

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

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

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

-SetupTimeout

Especifique el número de minutos antes de Configuration Manager se 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.

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

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

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

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

Type:IResultObject
Position:Named
Default value:None
Required:False
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

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.