Compartilhar via


Start-CMTaskSequenceDeployment

(Preterido) Iniciar uma implementação de sequência de tarefas.

Sintaxe

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InputObject] <IResultObject>
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-TaskSequencePackageId] <String>
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

Importante

Este cmdlet foi preterido. Em alternativa, utilize New-CMTaskSequenceDeployment .

Utilize este cmdlet para iniciar 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. Para obter mais informações, veja Implementar uma sequência de tarefas no Configuration Manager.

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: Iniciar uma implementação de sequência de tarefas com opções predefinidas

Este comando inicia uma implementação de sequência de tarefas com o nome da implementação da sequência de tarefas e o nome de uma coleção.

Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"

Exemplo 2: Iniciar uma implementação de sequência de tarefas com opções configuradas

Este comando inicia uma implementação de sequência de tarefas com várias opções configuradas.

Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True

Parâmetros

-AlertDateTime

Quando configurar a implementação para criar um alerta para uma implementação com êxito, utilize este parâmetro para especificar um objeto DateTime . O Configuration Manager cria um alerta de implementação quando o limiar é inferior ao PercentSuccess após esta data.

Para obter este objeto, utilize o cmdlet incorporado Get-Date .

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

-AlertDay

Este parâmetro foi preterido. Utilize AlertDateTime.

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

-AlertTime

Este parâmetro foi preterido. Utilize AlertDateTime.

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.

Se especificar Clients, o valor predefinido para o parâmetro DeploymentOption é DownloadAllContentLocallyBeforeStartingTaskSequence. Se especificar ClientsMediaAndPxe, MediaAndPxeou MediaAndPxeHidden, o valor predefinido para o parâmetro DeploymentOption é DownloadContentLocallyWhenNeededByRunningTaskSequence.

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

-Collection

Especifique um objeto de coleção para o qual esta sequência de tarefas é implementada. 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 o ID da coleção na qual esta sequência de tarefas é implementada.

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

-CollectionName

Especifique o nome da coleção na qual esta sequência de tarefas é implementada.

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

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

-DeploymentAvailableDateTime

Especifique um objeto DateTime para quando esta implementação estiver disponível. Para obter este objeto, utilize o cmdlet incorporado Get-Date .

Utilize DeploymentExpireDateTime para especificar quando a implementação expira e Agendar 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

-DeploymentAvailableDay

Este parâmetro foi preterido. Utilize DeploymentAvailableDateTime.

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

-DeploymentAvailableTime

Este parâmetro foi preterido. Utilize DeploymentAvailableDateTime.

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

-DeploymentExpireDateTime

Especifique um objeto DateTime para quando esta implementação expirar. Para obter este objeto, utilize o cmdlet incorporado Get-Date .

Utilize DeploymentAvailableDateTime para especificar quando a implementação está disponível e Agendar 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

-DeploymentExpireDay

Este parâmetro foi preterido. Utilize DeploymentExpireDateTime.

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

-DeploymentExpireTime

Este parâmetro foi preterido. Utilize DeploymentExpireDateTime.

Tipo:DateTime
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.

Se especificar Clients para o parâmetro Disponibilidade , o valor predefinido para este parâmetro é DownloadAllContentLocallyBeforeStartingTaskSequence. Se especificar ClientsMediaAndPxe, MediaAndPxeou MediaAndPxeHidden para o parâmetro Disponibilidade , o valor predefinido para este parâmetro é DownloadContentLocallyWhenNeededByRunningTaskSequence.

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

-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

Especifique um objeto de implementação de sequência de tarefas. Para obter este objeto, utilize o cmdlet Get-CMTaskSequenceDeployment .

Tipo:IResultObject
Cargo:0
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

-PassThru

Adicione este parâmetro para devolver um objeto que representa o item com o qual está a trabalhar. Por predefinição, este cmdlet pode não gerar qualquer saída.

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

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject