New-CMTaskSequenceDeployment
Cree una implementación de secuencia de tareas.
Sintaxis
New-CMTaskSequenceDeployment
[-AlertDateTime <DateTime>]
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Availability <MakeAvailableToType>]
[-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>]
[-InputObject] <IResultObject>
[-InternetOption <Boolean>]
[-PercentFailure <Int32>]
[-PercentSuccess <Int32>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequenceDeployment
[-AlertDateTime <DateTime>]
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Availability <MakeAvailableToType>]
[-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>]
[-InternetOption <Boolean>]
[-PercentFailure <Int32>]
[-PercentSuccess <Int32>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>]
[-TaskSequencePackageId] <String>
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
El cmdlet New-CMTaskSequenceDeployment crea 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.
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: Implementación de una secuencia de tareas con muchos parámetros comunes
En este ejemplo se hacen las siguientes acciones:
- Use el cmdlet Get-CMTaskSequence para obtener el objeto de secuencia de tareas que se va a implementar y lo guarda en la variable $DeployTS .
- Defina la colección como destino de la implementación en la variable $DeployCollection
- Defina la hora de implementación disponible a las 8:00 p.m. del 25 de noviembre de 2025, en la variable $DeployAvailableTime
- Defina la hora de expiración de la implementación a las 8:00 p.m. del 25 de enero de 2026, en la variable $DeployExpireTime
- Defina la fecha límite de implementación a las 8:00 p.m. del 25 de diciembre de 2025, en la variable $ScheduleDateTime
- Use el cmdlet New-CMSchedule para crear un objeto de programación para la fecha límite con una programación periódica diaria.
- Implementación de la secuencia de tareas
$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTimeParámetros
-AlertDateTime
Si habilita una alerta de implementación, use este parámetro para especificar una hora para la alerta.
| 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.
| 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 |
-AvailableDateTime
Especifique cuándo está disponible esta implementación.
Use -DeadlineDateTime para especificar cuándo expira la implementación y -Schedule 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 |
-Collection
Especifique un objeto de colección como destino para esta implementación de 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 un identificador de colección como destino para esta implementación 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 |
-CollectionName
Especifique un nombre de colección como destino para esta implementación de secuencia de tareas.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | True |
-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: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DeadlineDateTime
Use este parámetro para especificar cuándo expira la implementación.
Use -AvailableDateTime para especificar cuándo está disponible la implementación y -Schedule para especificar la asignación de implementación o la fecha límite.
| Tipo: | DateTime |
| Alias: | DeploymentExpireDateTime |
| 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.
| 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 |
-DistributeCollectionName
El sitio distribuye contenido a los grupos de puntos de distribución asociados a este nombre de colección.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DistributeContent
Agregue este parámetro para distribuir el contenido de la secuencia de tareas al crear esta implementación. Los clientes no pueden instalar la secuencia de tareas hasta que distribuya contenido a puntos de distribución a los que los clientes puedan acceder.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DistributionPointGroupName
El sitio distribuye contenido a este grupo de puntos de distribución.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DistributionPointName
El sitio distribuye contenido a este punto de distribución.
| Tipo: | String |
| 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
Especifica un objeto de secuencia de tareas que se va a implementar. Para obtener un objeto de secuencia de tareas, use el cmdlet Get-CMTaskSequence .
| Tipo: | IResultObject |
| Alias: | TaskSequence |
| Posición: | 0 |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | True |
| Aceptar caracteres comodín: | False |
-InternetOption
Permitir que la secuencia de tareas se ejecute para los clientes en Internet.
| Tipo: | Boolean |
| 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, TaskSequenceId |
| 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: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Salidas
IResultObject
Notas
Asegúrese de usar los parámetros de programación correctamente:
-AvailableDateTime: especifique cuándo está disponible esta implementación.
-DeadlineDateTime: especifique cuándo expira la implementación.
-Programación: especifique la asignación de implementación o la fecha límite.