Set-CMTaskSequence

  • Referencia
Módulo:
ConfigurationManager

Establece una secuencia de tareas de Configuration Manager.

Sintaxis

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   -InputObject <IResultObject>
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceId <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceName <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

El cmdlet Set-CMTaskSequence modifica una secuencia de tareas de Configuration Manager.

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: Obtener una secuencia de tareas y cambiar su nombre

PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Set-CMTaskSequence -InputObject $TaskSequence -NewName "NewTS01"

El primer comando obtiene el objeto de secuencia de tareas denominado TaskSequence01 y almacena el objeto en la variable $TaskSequence.

El segundo comando cambia el nombre de la secuencia de tareas almacenada en $TaskSequence a NewTS01.

Ejemplo 2: Pasar una secuencia de tareas y cambiar su nombre

PS XYZ:\> Get-CMTaskSequence -Name "TaskSequence02" | Set-CMTaskSequence -NewName "NewTS02"

Este comando obtiene el objeto de secuencia de tareas denominado TaskSequence02 y usa el operador de canalización para pasar el objeto a Set-CMTaskSequence, que cambia el nombre del objeto de secuencia de tareas a NewTS02.

Parámetros

-AddSupportedOperatingSystemPlatform

Agrega un objeto de plataforma de sistema operativo compatible a la secuencia de tareas. Para obtener un objeto de plataforma de sistema operativo compatible, use el cmdlet Get-CMSupportedPlatform .

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

-BootImageId

Especifica el identificador de una imagen de arranque.

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

-Category

Especifica una categoría para la secuencia de tareas. Puede usar categorías para agrupar secuencias de tareas.

Tipo:String
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomText

Especifica texto personalizado para la secuencia de tareas. El texto personalizado aparece en el cuadro de diálogo de notificación de progreso mientras se ejecuta la secuencia de tareas.

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

-DeploymentPackageId

Especifica el identificador de un paquete. Si especifica un valor de $True para el parámetro RunAnotherProgram , el paquete especificado se ejecuta antes de que se ejecute la secuencia de tareas.

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

-Description

Especifica una descripción para la secuencia de tareas.

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

-DisableTaskSequence

Indica si se va a deshabilitar esta secuencia de tareas.

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

-EnableNotification

Indica si se deben habilitar las notificaciones para esta secuencia de tareas.

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

-EnableTaskSequence

Indica si se va a habilitar esta secuencia de tareas.

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

-HighPerformance

Use este parámetro para establecer la siguiente opción en la página Rendimiento de las propiedades de secuencia de tareas: Ejecutar como plan de energía de alto rendimiento.

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

-InputObject

Especifica un objeto de secuencia de tareas. Para obtener un objeto de secuencia de tareas, use el cmdlet Get-CMTaskSequence .

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

-MaxRunTimeMins

Especifica, en minutos, el tiempo máximo de ejecución de la secuencia de tareas.

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

-NewName

Especifica un nuevo nombre para la secuencia de tareas.

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

-PassThru

Devuelve el objeto de trabajo actual. De forma predeterminada, este cmdlet no genera resultados.

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

-ProgramName

Especifica el nombre de un programa que se va a ejecutar desde un paquete de software de Configuration Manager especificado por el parámetro DeploymentPackageId .

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

-RemoveSupportedOperatingSystemPlatform

Quita un objeto de plataforma de sistema operativo compatible de la secuencia de tareas. Para obtener un objeto de plataforma de sistema operativo compatible, use el cmdlet Get-CMSupportedPlatform .

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

-RunAnotherProgram

Indica si se debe ejecutar otro programa antes de ejecutar la secuencia de tareas. Especifique el programa mediante el parámetro DeploymentPackageId y el parámetro ProgramName .

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

-RunEveryTime

Indica si el programa especificado en el parámetro ProgramName se ejecuta cada vez que se ejecuta la secuencia de tareas. Si especifica un valor de $False, el programa no se ejecuta si se ha ejecutado correctamente en el pasado.

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

-RunOnAnyPlatform

Indica que la secuencia de tareas se ejecuta en cualquier plataforma del sistema operativo.

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

-SuppressNotification

Indica si se deben suprimir las notificaciones de esta secuencia de tareas.

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

-TaskSequenceId

Especifica el identificador de una secuencia de tareas.

Tipo:String
Alias:Id, TaskSequencePackageId
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-TaskSequenceName

Especifica el nombre de una secuencia de tareas.

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

-UseBootImage

Indica si la secuencia de tareas usa la imagen de arranque especificada mediante el parámetro BootImageID .

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

-UseDefaultText

Indica si se debe usar texto predeterminado en el cuadro de diálogo de notificación de progreso mientras se ejecuta la secuencia de tareas. Si selecciona un valor de $False para este parámetro, asegúrese de especificar texto personalizado mediante el parámetro CustomText .

Tipo:Boolean
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:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

System.Object