Start-CMTaskSequenceDeployment

(En desuso) Inicie una implementación de secuencia de tareas.

Sintaxis

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InputObject] <IResultObject>
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-TaskSequencePackageId] <String>
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Importante

Este cmdlet está en desuso. Use New-CMTaskSequenceDeployment en su lugar.

Use este cmdlet para iniciar una implementación de secuencia de tareas. Una implementación de secuencia de tareas asigna una secuencia de tareas a una colección de equipos. Para obtener más información, consulte Implementación de una secuencia de tareas en 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: Iniciar una implementación de secuencia de tareas con opciones predeterminadas

Este comando inicia una implementación de secuencia de tareas mediante el nombre de la implementación de la secuencia de tareas y el nombre de una colección.

Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"

Ejemplo 2: Inicio de una implementación de secuencia de tareas con opciones configuradas

Este comando inicia una implementación de secuencia de tareas con varias opciones configuradas.

Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True

Parámetros

-AlertDateTime

Al configurar la implementación para crear una alerta para una implementación correcta, use este parámetro para especificar un objeto DateTime . Configuration Manager crea una alerta de implementación cuando el umbral es inferior a PercentSuccess después de esta fecha.

Para obtener este objeto, use el cmdlet integrado Get-Date .

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

-AlertDay

Este parámetro está en desuso. Use AlertDateTime.

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

-AlertTime

Este parámetro está en desuso. Use AlertDateTime.

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

-AllowFallback

Permitir que los clientes usen puntos de distribución del grupo de límites de sitio predeterminado.

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

-AllowSharedContent

Permitir a los clientes usar puntos de distribución de un grupo de límites vecino.

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

-Availability

Especifique si esta secuencia de tareas está disponible para los clientes de Configuration Manager y si está disponible para ejecutarse al implementar un sistema operativo mediante medios de arranque, medios preconfigurados o PXE.

Si especifica Clients, el valor predeterminado del parámetro DeploymentOption es DownloadAllContentLocallyBeforeStartingTaskSequence. Si especifica ClientsMediaAndPxe, MediaAndPxeo MediaAndPxeHidden, el valor predeterminado del parámetro DeploymentOption es DownloadContentLocallyWhenNeededByRunningTaskSequence.

Tipo:MakeAvailableToType
Alias:MakeAvailableTo
Valores aceptados:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Collection

Especifique un objeto de colección en el que se implementa esta secuencia de tareas. Para obtener este objeto, use el cmdlet Get-CMCollection .

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

-CollectionId

Especifique el identificador de la colección en la que se implementa esta secuencia de tareas.

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

-CollectionName

Especifique el nombre de la colección en la que se implementa esta secuencia de tareas.

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

-Comment

Especifique un comentario opcional para la implementación de 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

-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

-DeploymentAvailableDateTime

Especifique un objeto DateTime para cuando esta implementación esté disponible. Para obtener este objeto, use el cmdlet integrado Get-Date .

Use DeploymentExpireDateTime para especificar cuándo expira la implementación y Programar para especificar la asignación de implementación o la fecha límite.

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

-DeploymentAvailableDay

Este parámetro está en desuso. Use DeploymentAvailableDateTime.

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

-DeploymentAvailableTime

Este parámetro está en desuso. Use DeploymentAvailableDateTime.

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

-DeploymentExpireDateTime

Especifique un objeto DateTime para cuando expire esta implementación. Para obtener este objeto, use el cmdlet integrado Get-Date .

Use DeploymentAvailableDateTime para especificar cuándo está disponible la implementación y Programar para especificar la asignación de implementación o la fecha límite.

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

-DeploymentExpireDay

Este parámetro está en desuso. Use DeploymentExpireDateTime.

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

-DeploymentExpireTime

Este parámetro está en desuso. Use DeploymentExpireDateTime.

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

-DeploymentOption

Especifique cómo interactúan los clientes con los puntos de distribución para obtener contenido para la secuencia de tareas. No todas las opciones están disponibles en escenarios específicos. Para obtener más información, consulte Implementación de una secuencia de tareas: opciones de implementación.

Si especifica Clients para el parámetro Availability , el valor predeterminado para este parámetro es DownloadAllContentLocallyBeforeStartingTaskSequence. Si especifica ClientsMediaAndPxe, MediaAndPxeo MediaAndPxeHidden para el parámetro Availability , el valor predeterminado para este parámetro es DownloadContentLocallyWhenNeededByRunningTaskSequence.

Tipo:DeploymentOptionType
Valores aceptados:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DeployPurpose

Especifique si esta implementación está disponible para que los usuarios lo instalen o si es necesario instalarla en la fecha límite.

Tipo:DeployPurposeType
Valores aceptados:Available, Required
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

-InputObject

Especifique un objeto de implementación de secuencia de tareas. Para obtener este objeto, use el cmdlet Get-CMTaskSequenceDeployment .

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

-InternetOption

Indica si la secuencia de tareas se ejecuta en los clientes que se conectan a través de Internet.

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

-PassThru

Agregue este parámetro para devolver un objeto que represente el elemento con el que está trabajando. De forma predeterminada, este cmdlet no puede generar ninguna salida.

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

-PercentFailure

Si crea una alerta para implementaciones con errores, el sitio genera una alerta cuando el porcentaje de implementaciones con errores es mayor que este número.

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

-PercentSuccess

Si crea una alerta para implementaciones correctas, el sitio genera una alerta cuando el porcentaje de implementaciones correctas es menor que este número.

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

-PersistOnWriteFilterDevice

Configure cómo controla el cliente el filtro de escritura en dispositivos Windows Embedded.

  • $true: confirme los cambios en la fecha límite o durante una ventana de mantenimiento. Se requiere un reinicio.
  • $false: aplique contenido en la superposición y confirme más adelante.
Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RerunBehavior

Especifique si la secuencia de tareas se vuelve a ejecutar en un equipo si se ejecutó anteriormente antes de la hora obligatoria programada. De forma predeterminada, la secuencia de tareas siempre se vuelve a ejecutar.

Tipo:RerunBehaviorType
Valores aceptados:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunFromSoftwareCenter

Permitir que los usuarios ejecuten el programa independientemente de las asignaciones.

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

-Schedule

Use este parámetro para especificar la asignación de implementación o la fecha límite.

Use AvailableDateTime para especificar cuándo está disponible la implementación y DeadlineDateTime para especificar cuándo expira la implementación.

Especifique una matriz de objetos de programación. Un objeto schedule define la programación de asignación obligatoria para una implementación. Para crear un objeto de programación, use el cmdlet New-CMSchedule .

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

-ScheduleEvent

Especifica una matriz de eventos que determinan cuándo se ejecuta la implementación de la secuencia de tareas.

Tipo:ScheduleEventType[]
Valores aceptados:AsSoonAsPossible, LogOn, LogOff
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SendWakeupPacket

Indica si se va a enviar un paquete de reactivación a los equipos antes de que comience la implementación. Si este valor es $True, Configuration Manager reactiva un equipo de suspensión. Si este valor es $False, no reactiva los equipos de suspensión. Para que los equipos se activen, configure primero Wake On LAN.

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

-ShowTaskSequenceProgress

Indica si se va a mostrar un cuadro de diálogo de proceso para una secuencia de tareas.

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

-SoftwareInstallation

Cuando se alcance la fecha límite de instalación, establezca este parámetro en para $true permitir que la secuencia de tareas se instale fuera de la ventana de mantenimiento.

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

-SystemRestart

Cuando se alcance la fecha límite de instalación, establezca este parámetro en para $true permitir el reinicio del sistema si es necesario fuera de la ventana de mantenimiento.

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

-TaskSequencePackageId

Especifique el identificador de la secuencia de tareas que se va a implementar.

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

-UseMeteredNetwork

Indica si se permite que los clientes de una conexión a Internet de uso medido descarguen contenido después de la fecha límite de instalación, lo que podría suponer costos adicionales.

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

-UseUtcForAvailableSchedule

Indica si los equipos cliente usan la hora UTC para determinar la disponibilidad de un programa. La hora UTC hace que la secuencia de tareas esté disponible al mismo tiempo para todos los equipos.

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

-UseUtcForExpireSchedule

Indica si los equipos cliente usan la hora UTC para determinar la expiración de un programa. La hora UTC hace que la secuencia de tareas esté disponible al mismo tiempo para todos los equipos.

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

IResultObject