Set-CMTaskSequenceDeployment

Referência

Módulo:: ConfigurationManager

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

Sintaxe

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   -InputObject <IResultObject>
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceDeploymentId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequenceName <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequenceDeployment
   [-AlertDateTime <DateTime>]
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-AllowUsersRunIndependently <Boolean>]
   [-Comment <String>]
   [-CreateAlertOnFailure <Boolean>]
   [-CreateAlertOnSuccess <Boolean>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-DeploymentOption <DeploymentOptionType>]
   [-InternetOption <Boolean>]
   [-MakeAvailableTo <MakeAvailableToType>]
   [-PercentFailure <Int32>]
   [-PercentSuccess <Int32>]
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-ClearSchedule]
   [-RemoveSchedule <IResultObject[]>]
   [-AddSchedule <IResultObject[]>]
   [-Schedule <IResultObject[]>]
   [-ClearScheduleEvent]
   [-RemoveScheduleEvent <ScheduleEventType[]>]
   [-AddScheduleEvent <ScheduleEventType[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-ShowTaskSequenceProgress <Boolean>]
   [-SoftwareInstallation <Boolean>]
   [-SystemRestart <Boolean>]
   -TaskSequencePackageId <String>
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMTaskSequenceDeployment configura 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: Configurar uma implementação para mostrar o progresso

Este comando configura a implementação da sequência de tarefas com o nome da sequência de tarefas e o nome da coleção. Define o comentário e permite que o cliente mostre o progresso da sequência de tarefas.

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Systems" -Comment "Task sequence test" -ShowTaskSequenceProgress $True

Exemplo 2: Reconfigurar uma implementação de sequência de tarefas

Este comando reconfigura a maioria das definições para uma implementação de sequência de tarefas.

Set-CMTaskSequenceDeployment -TaskSequenceName "Task Sequence 1333" -CollectionName "All Desktop and Server Clients" -Comment "Task sequence test" -SendWakeupPacket $True -UseMeteredNetwork $True -DeploymentExpireDateTime $(Get-Date) -ScheduleEvent LogOff -RerunBehavior NeverRerunDeployedProgram -AllowUsersRunIndependently $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -InternetOption $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowFallback $True -AllowSharedContent $True

Parâmetros

-AddSchedule

Especifique um objeto de token de agenda para adicionar à 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

-AddScheduleEvent

Especifique um dos eventos de agendamento aceites a adicionar à implementação.

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

-AlertDateTime

Especifica uma data/hora de alerta.

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

-AllowFallback

Indica se pretende permitir que os clientes utilizem uma localização de origem de contingência para o conteúdo.

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

-AllowSharedContent

Indica se pretende permitir conteúdo partilhado.

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

-AllowUsersRunIndependently

Indica se deve permitir que os utilizadores executem o programa de forma independente, independentemente do respetivo estado de atribuição.

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

-ClearSchedule

Adicione este parâmetro para remover todas as agendas da implementação.

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

-ClearScheduleEvent

Adicione este parâmetro para remover todos os eventos de agendamento da implementação.

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

-Collection

Especifica um objeto de coleção como o destino da implementação.

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

-CollectionId

Especifica o ID de uma coleção como o destino da implementação.

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

-CollectionName

Especifica um nome de uma coleção designada para receber uma 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

Especifica um comentário opcional para a implementação da sequência de tarefas para ajudar a descrevê-lo.

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:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CreateAlertOnFailure

Indica se pretende criar um alerta sobre a falha.

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

-CreateAlertOnSuccess

Indica se pretende criar um alerta com êxito.

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

-DeploymentAvailableDateTime

Especifica a data/hora da implementação disponível.

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

-DeploymentExpireDateTime

Especifica a data de expiração da implementação.

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

-DeploymentOption

Especifica se os clientes transferem todo o conteúdo antes de iniciar a sequência de tarefas ou se transferem conteúdo conforme necessário pela sequência de tarefas em execuçã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

-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

-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 implementação de sequência de tarefas. Para obter um objeto de sequência de tarefas, utilize o cmdlet Get-CMTaskSequenceDeployment .

Tipo:	IResultObject
Aliases:	Deployment, DeploymentSummary, TaskSequence, Advertisement
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-InternetOption

Indica se a sequência de tarefas é executada em clientes que se ligam através da Internet.

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

-MakeAvailableTo

Especifica se pretende disponibilizar esta sequência de tarefas aos clientes do Configuration Manager e se deve disponibilizá-la quando implementa um SO com suportes de dados de arranque, suportes de dados pré-configurados ou PXE.

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

-PassThru

Devolve o objeto de trabalho atual. Por predefinição, este cmdlet não gera nenhuma saída.

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

-PercentFailure

Especifica uma percentagem de limiar para a implementação da sequência de tarefas falhada.

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

-PercentSuccess

Especifica uma percentagem de limiar para uma implementação de sequência de tarefas bem-sucedida.

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

-PersistOnWriteFilterDevice

Indica se deve instalar uma sequência de tarefas na sobreposição temporária e consolidar as alterações mais tarde ou consolidar as alterações num prazo de instalação ou numa janela de manutenção. Esta definição aplica-se a dispositivos com uma edição incorporada do Windows com um filtro de escrita.

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

-RemoveSchedule

Especifique um objeto de token de agenda para remover da 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

-RemoveScheduleEvent

Especifique um dos eventos de agenda aceites a remover da implementação.

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

-RerunBehavior

Especifica se a sequência de tarefas será novamente executada 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

-Schedule

Especifica uma matriz de objetos CMSchedule . Um objeto CMSchedule define a agenda de atribuição obrigatória para uma implementação. Para criar um objeto CMSchedule , 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

Indica se deve permitir a instalação da aplicação, mesmo que a instalação ocorra fora de uma 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

Indica se pretende permitir que um programa anunciado reinicie o sistema, mesmo que o reinício ocorra fora de uma 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

-TaskSequenceDeploymentId

Especifica um ID para uma implementação de sequência de tarefas a configurar.

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

-TaskSequenceName

Especifica um nome para a sequência de tarefas a implementar.

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

-TaskSequencePackageId

Especifica um ID para uma sequência de tarefas a implementar.

Tipo:	String
Cargo:	Named
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:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Compartilhar via