New-CMTaskSequenceDeployment
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 $DeployExpireTimeParâ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.