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
, MediaAndPxe
ou 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
, MediaAndPxe
ou 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