Start-CMTaskSequenceDeployment
(Preterido) Inicie uma implantação de sequência de tarefas.
Syntax
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 é preterido. Em vez disso, use New-CMTaskSequenceDeployment .
Use esse cmdlet para iniciar 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. Para obter mais informações, confira Implantar uma sequência de tarefas no Configuration Manager.
Observação
Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>
. Para obter mais informações, confira introdução.
Exemplos
Exemplo 1: iniciar uma implantação de sequência de tarefas com opções padrão
Esse comando inicia uma implantação de sequência de tarefas usando o nome da implantaçã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 implantação de sequência de tarefas com opções configuradas
Esse comando inicia uma implantaçã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
Ao configurar a implantação para criar um alerta para implantação bem-sucedida, use esse parâmetro para especificar um objeto DateTime . Configuration Manager cria um alerta de implantação quando o limite é menor que o PercentSuccess após essa data.
Para obter esse objeto, use o cmdlet interno Get-Date .
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertDay
Esse parâmetro foi preterido. Use AlertDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AlertTime
Esse parâmetro foi preterido. Use AlertDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowFallback
Permitir que os clientes usem pontos de distribuição do grupo de limites do site padrão.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowSharedContent
Permitir que os clientes usem pontos de distribuição de um grupo de limites vizinho.
Type: | Boolean |
Aliases: | AllowUseRemoteDistributionPoint |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Availability
Especifique se essa sequência de tarefas está disponível para Configuration Manager clientes e se ela está disponível para ser executada quando você implanta um sistema operacional usando mídia de inicialização, mídia prestaged ou PXE.
Se você especificar Clients
, o valor padrão para o parâmetro DeploymentOption será DownloadAllContentLocallyBeforeStartingTaskSequence
.
Se você especificar ClientsMediaAndPxe
, MediaAndPxe
ou MediaAndPxeHidden
, o valor padrão para o parâmetro DeploymentOption será DownloadContentLocallyWhenNeededByRunningTaskSequence
.
Type: | MakeAvailableToType |
Aliases: | MakeAvailableTo |
Accepted values: | Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Collection
Especifique um objeto de coleção ao qual essa sequência de tarefas é implantada. Para obter esse objeto, use o cmdlet Get-CMCollection .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionId
Especifique a ID da coleção à qual essa sequência de tarefas é implantada.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CollectionName
Especifique o nome da coleção para a qual essa sequência de tarefas é implantada.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Comment
Especifique um comentário opcional para a implantação da sequência de tarefas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableDateTime
Especifique um objeto DateTime para quando essa implantação estiver disponível. Para obter esse objeto, use o cmdlet interno Get-Date .
Use DeploymentExpireDateTime para especificar quando a implantação expirar e Agendar para especificar a atribuição de implantação ou o prazo final.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableDay
Esse parâmetro foi preterido. Use DeploymentAvailableDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentAvailableTime
Esse parâmetro foi preterido. Use DeploymentAvailableDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireDateTime
Especifique um objeto DateTime para quando essa implantação expirar. Para obter esse objeto, use o cmdlet interno Get-Date .
Use DeploymentAvailableDateTime para especificar quando a implantação estiver disponível e Agendar para especificar a atribuição de implantação ou o prazo.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireDay
Esse parâmetro foi preterido. Use DeploymentExpireDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeploymentExpireTime
Esse parâmetro foi preterido. Use DeploymentExpireDateTime.
Type: | DateTime |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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, consulte Implantar uma sequência de tarefas – opções de implantação.
Se você especificar Clients
para o parâmetro Disponibilidade , o valor padrão para este parâmetro será DownloadAllContentLocallyBeforeStartingTaskSequence
.
Se você especificar ClientsMediaAndPxe
, MediaAndPxe
ou MediaAndPxeHidden
para o parâmetro Disponibilidade , o valor padrão para este parâmetro será DownloadContentLocallyWhenNeededByRunningTaskSequence
.
Type: | DeploymentOptionType |
Accepted values: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DeployPurpose
Especifique se essa implantação está disponível para os usuários instalarem ou se é necessário instalar no prazo final.
Type: | DeployPurposeType |
Accepted values: | Available, Required |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
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). Você não pode combiná-lo com DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Especifique um objeto de implantação de sequência de tarefas. Para obter esse objeto, use o cmdlet Get-CMTaskSequenceDeployment .
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-InternetOption
Indica se a sequência de tarefas é executada em clientes que se conectam pela Internet.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PercentFailure
Se você criar um alerta para implantações com falha, o site gerará um alerta quando o percentual de implantações com falha é maior que esse número.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PercentSuccess
Se você criar um alerta para implantações bem-sucedidas, o site gerará um alerta quando o percentual de implantações bem-sucedidas for menor que esse número.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
Configure como o cliente lida com o filtro de gravação em dispositivos Windows Embedded.
$true
: confirmar alterações no prazo ou durante uma janela de manutenção. Uma reinicialização é necessária.$false
: aplicar conteúdo na sobreposição e confirmar posteriormente.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RerunBehavior
Especifique se a sequência de tarefas será executada novamente em um computador se ela foi executada anteriormente antes da hora obrigatória agendada. Por padrão, a sequência de tarefas sempre é executada novamente.
Type: | RerunBehaviorType |
Accepted values: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunFromSoftwareCenter
Permitir que os usuários executem o programa independentemente de atribuições.
Type: | Boolean |
Aliases: | AllowUsersRunIndependently |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Use esse parâmetro para especificar a atribuição de implantação ou o prazo.
Use AvailableDateTime para especificar quando a implantação está disponível e DeadlineDateTime para especificar quando a implantação expirar.
Especifique uma matriz de objetos de agendamento. Um objeto de agendamento define o agendamento de atribuição obrigatório para uma implantação. Para criar um objeto de agendamento, use o cmdlet New-CMSchedule .
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScheduleEvent
Especifica uma matriz de eventos que determina quando a implantação da sequência de tarefas é executada.
Type: | ScheduleEventType[] |
Accepted values: | AsSoonAsPossible, LogOn, LogOff |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SendWakeupPacket
Indica se é necessário enviar um pacote de despertar para computadores antes do início da implantação. Se esse valor for $True
, Configuration Manager acordará um computador do sono. Se esse valor for $False
, ele não acordará os computadores do sono. Para os computadores acordarem, primeiro configure Wake On LAN.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowTaskSequenceProgress
Indica se deve mostrar uma caixa de diálogo de processo para uma sequência de tarefas.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SoftwareInstallation
Quando o prazo de instalação for atingido, defina esse parâmetro para $true
permitir que a sequência de tarefas seja instalada fora da janela de manutenção.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SystemRestart
Quando o prazo de instalação for atingido, defina esse parâmetro para permitir a $true
reinicialização do sistema, se necessário, fora da janela de manutenção.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-TaskSequencePackageId
Especifique a ID da sequência de tarefas a ser implantada.
Type: | String |
Aliases: | PackageId |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseMeteredNetwork
Indica se é necessário permitir que clientes em uma conexão de Internet limitada baixem conteúdo após o prazo de instalação, o que pode incorrer em custos extras.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
Indica se os computadores cliente usam 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUtcForExpireSchedule
Indica se os computadores cliente usam 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 |
Required: | False |
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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Saídas
IResultObject
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de