New-CMTaskSequenceDeployment

  • Referência
Módulo:
ConfigurationManager

Criar uma implementação de sequência de tarefas.

Sintaxe

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

O cmdlet New-CMTaskSequenceDeployment cria uma implementação de sequência de tarefas. Uma implementação de sequência de tarefas atribui uma sequência de tarefas a uma coleção de computadores.

Observação

Execute cmdlets do Configuration Manager a partir da unidade do site do Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, veja Introdução.

Exemplos

Exemplo 1: Implementar uma sequência de tarefas com muitos parâmetros comuns

Este exemplo faz as seguintes ações:

  • Utilize o cmdlet Get-CMTaskSequence para obter o objeto de sequência de tarefas a implementar e guarda-o na variável $DeployTS
  • Definir a coleção como o destino da implementação na variável $DeployCollection
  • Defina a hora de implementação disponível às 20:00 de 25 de novembro de 2025, na variável $DeployAvailableTime
  • Defina a hora de expiração da implementação às 20:00 de 25 de janeiro de 2026, na variável $DeployExpireTime
  • Defina o prazo de implementação às 20:00 de 25 de dezembro de 2025, na variável $ScheduleDateTime
  • Utilize o cmdlet New-CMSchedule para criar um objeto de agendamento para o prazo com uma agenda periódica diária.
  • Implementar a sequência de tarefas
$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 $DeployExpireTime

Parâmetros

-AlertDateTime

Se ativar um alerta de implementação, utilize este parâmetro para especificar uma hora para o alerta.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowFallback

Permitir que os clientes utilizem pontos de distribuição do grupo de limites do site predefinido.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AllowSharedContent

Permitir que os clientes utilizem pontos de distribuição de um grupo de limites vizinho.

Tipo:Boolean
Aliases:AllowUseRemoteDistributionPoint
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Availability

Especifique se pretende disponibilizar esta sequência de tarefas aos clientes do Configuration Manager e se está disponível para execução quando implementa um SO com suportes de dados de arranque, suportes de dados pré-configurados ou PXE.

Tipo:MakeAvailableToType
Aliases:MakeAvailableTo
Valores aceitos:Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AvailableDateTime

Especifique quando esta implementação está disponível.

Utilize -DeadlineDateTime para especificar quando a implementação expira e -Schedule para especificar a atribuição de implementação ou o prazo.

Tipo:DateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Collection

Especifique um objeto de coleção como destino para esta implementação de sequência de tarefas. Para obter este objeto, utilize o cmdlet Get-CMCollection .

Tipo:IResultObject
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionId

Especifique um ID de coleção como destino para esta implementação de sequência de tarefas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CollectionName

Especifique um nome de coleção como destino para esta implementação de sequência de tarefas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

-Comment

Especifique um comentário opcional para a implementação da sequência de tarefas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeadlineDateTime

Utilize este parâmetro para especificar quando a implementação expira.

Utilize -AvailableDateTime para especificar quando a implementação está disponível e -Schedule para especificar a atribuição de implementação ou o prazo.

Tipo:DateTime
Aliases:DeploymentExpireDateTime
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeploymentOption

Especifique como os clientes interagem com os pontos de distribuição para obter conteúdo para a sequência de tarefas. Nem todas as opções estão disponíveis em cenários específicos. Para obter mais informações, veja Implementar uma sequência de tarefas – Opções de implementação.

Tipo:DeploymentOptionType
Valores aceitos:DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DeployPurpose

Especifique se esta implementação está disponível para instalação por parte dos utilizadores ou se é necessário instalar no prazo.

Tipo:DeployPurposeType
Valores aceitos:Available, Required
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DisableWildcardHandling

Este parâmetro trata os carateres universais como valores de carateres literais. Não pode combiná-lo com ForceWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributeCollectionName

O site distribui conteúdo para os grupos de pontos de distribuição associados a este nome de coleção.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributeContent

Adicione este parâmetro para distribuir o conteúdo da sequência de tarefas quando criar esta implementação. Os clientes não podem instalar a sequência de tarefas até distribuir conteúdo por pontos de distribuição aos quais os clientes podem aceder.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributionPointGroupName

O site distribui conteúdo para este grupo de pontos de distribuição.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DistributionPointName

O site distribui conteúdo para este ponto de distribuição.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ForceWildcardHandling

Este parâmetro processa carateres universais e pode levar a um comportamento inesperado (não recomendado). Não pode combiná-lo com DisableWildcardHandling.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Especifica um objeto de sequência de tarefas a implementar. Para obter um objeto de sequência de tarefas, utilize o cmdlet Get-CMTaskSequence .

Tipo:IResultObject
Aliases:TaskSequence
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-InternetOption

Permitir que a sequência de tarefas seja executada para clientes na Internet.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PercentFailure

Se criar um alerta para implementações com falhas, o site gera um alerta quando a percentagem de implementações falhadas é superior a este número.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PercentSuccess

Se criar um alerta para implementações bem-sucedidas, o site gera um alerta quando a percentagem de implementações bem-sucedidas é inferior a este número.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PersistOnWriteFilterDevice

Configure a forma como o cliente processa o filtro de escrita em dispositivos Windows Embedded.

  • $true: consolidar alterações no prazo ou durante uma janela de manutenção. É necessário reiniciar.
  • $false: aplique conteúdo sobreposto e consolide mais tarde.
Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RerunBehavior

Especifique se a sequência de tarefas é executada novamente num computador se tiver sido executada anteriormente antes da hora obrigatória agendada. Por predefinição, a sequência de tarefas é sempre executada novamente.

Tipo:RerunBehaviorType
Valores aceitos:NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunFromSoftwareCenter

Permitir que os utilizadores executem o programa independentemente das atribuições.

Tipo:Boolean
Aliases:AllowUsersRunIndependently
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Schedule

Utilize este parâmetro para especificar a atribuição de implementação ou o prazo.

Utilize -AvailableDateTime para especificar quando a implementação está disponível e -DeadlineDateTime para especificar quando a implementação expira.

Especifique uma matriz de objetos de agendamento. Um objeto de agendamento define a agenda de atribuição obrigatória para uma implementação. Para criar um objeto de agendamento, utilize o cmdlet New-CMSchedule .

Tipo:IResultObject[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScheduleEvent

Especifica uma matriz de eventos que determina quando a implementação da sequência de tarefas é executada.

Tipo:ScheduleEventType[]
Valores aceitos:AsSoonAsPossible, LogOn, LogOff
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SendWakeupPacket

Indica se pretende enviar um pacote de reativação para computadores antes do início da implementação. Se este valor for $True, o Configuration Manager reativa um computador do modo de suspensão. Se este valor for $False, não reativa os computadores do modo de suspensão. Para que os computadores reativam, configure primeiro a Reativação por LAN.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShowTaskSequenceProgress

Indica se pretende mostrar uma caixa de diálogo de processo para uma sequência de tarefas.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SoftwareInstallation

Quando o prazo de instalação for atingido, defina este parâmetro como para $true permitir que a sequência de tarefas seja instalada fora da janela de manutenção.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SystemRestart

Quando o prazo de instalação for atingido, defina este parâmetro para $true permitir o reinício do sistema, se necessário fora da janela de manutenção.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TaskSequencePackageId

Especifique o ID da sequência de tarefas a implementar.

Tipo:String
Aliases:PackageId, TaskSequenceId
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseMeteredNetwork

Indica se pretende permitir que os clientes numa ligação à Internet com tráfego limitado transfiram conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseUtcForAvailableSchedule

Indica se os computadores cliente utilizam a hora UTC para determinar a disponibilidade de um programa. A hora UTC disponibiliza a sequência de tarefas ao mesmo tempo para todos os computadores.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UseUtcForExpireSchedule

Indica se os computadores cliente utilizam a hora UTC para determinar a expiração de um programa. A hora UTC disponibiliza a sequência de tarefas ao mesmo tempo para todos os computadores.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Observações

Certifique-se de que utiliza os parâmetros de agenda adequadamente:

  • -AvailableDateTime: especifique quando esta implementação está disponível.

  • -DeadlineDateTime: especifique quando a implementação expirar.

  • -Agenda: especifique a atribuição de implementação ou o prazo.