Set-CMTaskSequenceDeployment
Configure uma implantação de sequência de tarefas.
Syntax
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 implantação de sequência de tarefas. Uma implantaçã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 na unidade de site do Configuration Manager, por PS XYZ:\>
exemplo. Para obter mais informações, consulte getting started.
Exemplos
Exemplo 1: Configurar uma implantação para mostrar o progresso
Esse comando configura a implantação da sequência de tarefas usando o nome da sequência de tarefas e o nome da coleção. Ele 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 implantação de sequência de tarefas
Esse comando reconfigura a maioria das configurações para uma implantaçã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 agendamento a ser acrescentado à implantação. Para criar um objeto schedule, use o cmdlet New-CMSchedule.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddScheduleEvent
Especifique um dos eventos de agenda aceitos para adicionar à implantação.
Type: | ScheduleEventType[] |
Accepted values: | AsSoonAsPossible, LogOn, LogOff |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertDateTime
Especifica uma data de alerta.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowFallback
Indica se os clientes podem usar um local de origem de fallback para o conteúdo.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSharedContent
Indica se é possível permitir conteúdo compartilhado.
Type: | Boolean |
Aliases: | AllowUseRemoteDistributionPoint |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowUsersRunIndependently
Indica se os usuários podem executar o programa independentemente de seu status de atribuição.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearSchedule
Adicione esse parâmetro para remover todos os agendamentos da implantação.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClearScheduleEvent
Adicione esse parâmetro para remover todos os eventos de agendamento da implantação.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Especifica um objeto collection como o destino da implantação.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifica a ID de uma coleção como o destino da implantação.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifica um nome de uma coleção designada para receber uma implantação de sequência de tarefas.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Comentário
Especifica um comentário opcional para a implantação da sequência de tarefas para ajudar a descrevê-lo.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreateAlertOnFailure
Indica se será criado um alerta sobre a falha.
Type: | Boolean |
Aliases: | CreateAlertBaseOnPercentFailure |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreateAlertOnSuccess
Indica se será criado um alerta sobre o sucesso.
Type: | Boolean |
Aliases: | CreateAlertBaseOnPercentSuccess |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableDateTime
Especifica a data de implantação disponível.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireDateTime
Especifica a data de expiração da implantação.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentOption
Especifica se os clientes baixam todo o conteúdo antes de iniciar a sequência de tarefas ou baixam o conteúdo conforme necessário pela sequência de tarefas em execução.
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parâmetro trata caracteres curinga como valores literais de caracteres. Não é possível combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifica um objeto de implantação de sequência de tarefas. Para obter um objeto de sequência de tarefas, use o cmdlet Get-CMTaskSequenceDeployment.
Type: | IResultObject |
Aliases: | Deployment, DeploymentSummary, TaskSequence, Advertisement |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InternetOption
Indica se a sequência de tarefas é executado em clientes que se conectam pela Internet.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MakeAvailableTo
Especifica se essa sequência de tarefas será disponibilizada para clientes do Configuration Manager e se ela será disponibilizada quando você implantar um sistema operacional usando mídia de inicialização, mídia prestada ou PXE.
Type: | MakeAvailableToType |
Accepted values: | Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Retorna o objeto de trabalho atual. Por padrão, esse cmdlet não gera nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PercentFailure
Especifica uma porcentagem de limite para implantação de sequência de tarefas com falha.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PercentSuccess
Especifica uma porcentagem de limite para implantação bem-sucedida da sequência de tarefas.
Type: | Int32 |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Indica se será instalada uma sequência de tarefas na sobreposição temporária e confirmação de alterações posteriormente ou se as alterações serão feitas em um prazo de instalação ou em uma janela de manutenção. Essa configuração se aplica a dispositivos que executam uma edição incorporada do Windows com um filtro de gravação.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveSchedule
Especifique um objeto de token de agendamento a ser removido da implantação. Para criar um objeto schedule, use o cmdlet New-CMSchedule.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveScheduleEvent
Especifique um dos eventos de agenda aceitos a ser removido da implantação.
Type: | ScheduleEventType[] |
Accepted values: | AsSoonAsPossible, LogOn, LogOff |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RerunBehavior
Especifica se a sequência de tarefas será reprisada em um computador se ela tiver sido antes da hora obrigatória agendada. Por padrão, a sequência de tarefas sempre é reprisada.
Type: | RerunBehaviorType |
Accepted values: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Especifica uma matriz de objetos CMSchedule. Um objeto CMSchedule define o cronograma de atribuição obrigatório para uma implantação. Para criar um objeto CMSchedule, use o cmdlet New-CMSchedule.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleEvent
Especifica uma matriz de eventos que determinam quando a implantação da sequência de tarefas é executado.
Type: | ScheduleEventType[] |
Accepted values: | AsSoonAsPossible, LogOn, LogOff |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica se um pacote de alerta deve ser enviado para computadores antes do início da implantação. Se esse valor for $True
, o Configuration Manager acordará um computador do sono. Se esse valor for $False
, ele não acordará computadores do sono. Para que os computadores acordem, primeiro configure Wake On LAN.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowTaskSequenceProgress
Indica se uma caixa de diálogo de processo deve ser exibida para uma sequência de tarefas.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Indica se o aplicativo deve ser instalado, mesmo que a instalação ocorra fora de uma janela de manutenção.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SystemRestart
Indica se um programa anunciado deve ser reiniciado, mesmo que a reinicialização ocorra fora de uma janela de manutenção.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequenceDeploymentId
Especifica uma ID para uma implantação de sequência de tarefas a ser configurada.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequenceName
Especifica um nome para a sequência de tarefas a ser implantada.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequencePackageId
Especifica uma ID para uma sequência de tarefas a ser implantada.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Indica se é possível permitir que os clientes em uma conexão de Internet com metros baixem conteúdo após o prazo de instalação, o que pode incorrer em custos adicionais.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
Indica se os computadores cliente usam o tempo UTC para determinar a disponibilidade de um programa. O tempo UTC disponibiliza a sequência de tarefas ao mesmo tempo para todos os computadores.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForExpireSchedule
Indica se os computadores cliente usam o tempo UTC para determinar a expiração de um programa. O tempo UTC disponibiliza a sequência de tarefas ao mesmo tempo para todos os computadores.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject