New-CMTaskSequenceDeployment
SYNOPSIS
Criar uma implementação de sequência de tarefa.
SYNTAX
SearchByValueMandatory (Padrão)
New-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>] [-Availability <MakeAvailableToType>] [-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>] [-DeployPurpose <DeployPurposeType>] [-InputObject] <IResultObject>
[-InternetOption <Boolean>] [-PercentFailure <Int32>] [-PercentSuccess <Int32>]
[-RerunBehavior <RerunBehaviorType>] [-RunFromSoftwareCenter <Boolean>] [-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>] [-ShowTaskSequenceProgress <Boolean>] [-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>] [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>]
[-DistributeCollectionName <String>] [-DistributeContent] [-DistributionPointGroupName <String>]
[-DistributionPointName <String>] [-AvailableDateTime <DateTime>] [-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>] [-SendWakeupPacket <Boolean>] [-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
SearchPackageByIdMandatory
New-CMTaskSequenceDeployment [-AlertDateTime <DateTime>] [-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>] [-Availability <MakeAvailableToType>] [-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>] [-DeployPurpose <DeployPurposeType>] [-InternetOption <Boolean>]
[-PercentFailure <Int32>] [-PercentSuccess <Int32>] [-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>] [-Schedule <IResultObject[]>] [-ScheduleEvent <ScheduleEventType[]>]
[-ShowTaskSequenceProgress <Boolean>] [-SoftwareInstallation <Boolean>] [-SystemRestart <Boolean>]
[-TaskSequencePackageId] <String> [-UseUtcForAvailableSchedule <Boolean>] [-UseUtcForExpireSchedule <Boolean>]
[-DistributeCollectionName <String>] [-DistributeContent] [-DistributionPointGroupName <String>]
[-DistributionPointName <String>] [-AvailableDateTime <DateTime>] [-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>] [-SendWakeupPacket <Boolean>] [-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>] [-CollectionId <String>] [-CollectionName <String>] [-DisableWildcardHandling]
[-ForceWildcardHandling] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
O cmdlet new-CMTaskSequenceDeployment cria uma implementação de sequência de tarefa. Uma implementação de sequência de tarefa atribui uma sequência de tarefa a uma coleção de computadores.
Nota
Executar cmdlets do Gestor de Configuração a partir da unidade do site do Gestor de Configuração, por exemplo PS XYZ:\> . Para mais informações, consulte a partida.
EXAMPLES
Exemplo 1: Implementar uma sequência de tarefas com muitos parâmetros comuns
Este exemplo faz as seguintes ações:
- Utilize o cmdlet Get-CMTaskSequence para obter o objeto da sequência de tarefas para implantar, e guarde-o na variável $DeployTS
- Defina a coleção como o alvo da implantação na variável $DeployCollection
- Defina a hora disponível de implantação às 20:00 de 25 de novembro de 2025, na variável $DeployAvailableTime
- Defina o prazo de validade de implementação às 20:00 de 25 de janeiro de 2026, na variável $DeployExpireTime
- Defina o prazo de implantação às 20:00 horas de 25 de dezembro de 2025, na variável $ScheduleDateTime
- Utilize o cmdlet New-CMSchedule para criar um objeto de programação para o prazo com um horário diário recorrente.
- Implementar a sequência de tarefas
$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTime
PARAMETERS
- AlertDateTime
Se ativar um alerta de implantação, utilize este parâmetro para especificar uma hora para o alerta.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Permitir o Retorno
Permitir que os clientes utilizem pontos de distribuição do grupo de fronteira do site padrão.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Permitir PartilharContent
Permitir que os clientes utilizem pontos de distribuição de um grupo de fronteira vizinho.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUseRemoteDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Disponibilidade
Especificar se deve disponibilizar esta sequência de tarefas aos clientes do Gestor de Configuração e se está disponível para executar quando implementar um SISTEMA utilizando o boot media, os meios de comunicação ou o PXE.
Type: MakeAvailableToType
Parameter Sets: (All)
Aliases: MakeAvailableTo
Accepted values: Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-AvailableDateTime
Especificar quando esta implementação está disponível.
Utilizar -DeadlineDateTime para especificar quando a implementação expira, e -Agendar para especificar a atribuição de implantação, ou prazo.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Coleção
Especifique um objeto de recolha como o alvo para esta implementação da sequência de tarefas. Para obter este objeto, utilize o cmdlet Get-CMCollection.
Type: IResultObject
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-CollectionId
Especifique um ID de recolha como o alvo para esta implementação da sequência de tarefa.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome de coleção
Especifique um nome de recolha como o alvo para esta implementação da sequência de tarefas.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: True
-Comentário
Especifique um comentário opcional para a implementação da sequência de tarefa.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
Solicita a sua confirmação antes de executar o cmdlet.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- DeadlineDateTime
Utilize este parâmetro para especificar quando a implantação expira.
Utilizar -AvailableDateTime para especificar quando a implementação está disponível, e -Agendar para especificar a atribuição de implementação, ou prazo.
Type: DateTime
Parameter Sets: (All)
Aliases: DeploymentExpireDateTime
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ImplementarPurpose
Especificar se esta implementação está disponível para os utilizadores instalarem ou se é necessário instalar no prazo.
Type: DeployPurposeType
Parameter Sets: (All)
Aliases:
Accepted values: Available, Required
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DeploymentOption
Especificar 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 Implementar uma sequência de tarefas - Opções de implementação.
Type: DeploymentOptionType
Parameter Sets: (All)
Aliases:
Accepted values: DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DisableWildcardHandling
Este parâmetro trata os caracteres wildcard como valores de caracteres literais. Não pode combiná-lo com ForceWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Distribuir Nome decolecção
O site distribui conteúdo aos grupos de pontos de distribuição que estão associados a este nome de coleção.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistribuirContent
Adicione este parâmetro para distribuir o conteúdo da sequência de tarefas quando criar esta implementação. Os clientes não podem instalar a sequência de tarefas até que distribua conteúdo para pontos de distribuição a que os clientes possam aceder.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-DistributionPointGroupName
O site distribui conteúdo a este grupo de pontos de distribuição.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Nome do Ponto de Distribuição
O site distribui conteúdo a este ponto de distribuição.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ForceWildcardHandling
Este parâmetro processa caracteres wildcard e pode levar a um comportamento inesperado (não recomendado). Não é possível combiná-lo com DisableWildcardHandling.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-InputObject
Especifica um objeto de sequência de tarefa para implantar. Para obter um objeto de sequência de tarefa, utilize o cmdlet Get-CMTaskSequence.
Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases: TaskSequence
Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False
-InternetOption
Permitir que a sequência de tarefas corra para os clientes na internet.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PercentFailure
Se criar um alerta para implementações falhadas, o site gera um alerta quando a percentagem de implementações falhadas é superior a este número.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: 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.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-PersistOnWriteFilterDevice
Configure a forma como o cliente lida com o filtro de escrita em Windows dispositivos incorporados.
$true: Esprovação de alterações no prazo ou durante uma janela de manutenção. É necessário reiniciar.$false: Aplicar conteúdo sobre a sobreposição e comprometer-se mais tarde.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RerunBehavior
Especificar se a sequência de tarefas se repetiu num computador se foi previamente realizada antes da hora obrigatória programada. Por predefinição, a sequência de tarefas é sempre reexecutada.
Type: RerunBehaviorType
Parameter Sets: (All)
Aliases:
Accepted values: NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-RunFromSoftwareCenter
Permitir que os utilizadores executem o programa independentemente das atribuições.
Type: Boolean
Parameter Sets: (All)
Aliases: AllowUsersRunIndependently
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Horário
Utilize este parâmetro para especificar a atribuição de implantação, ou prazo.
Utilize -AvailableDateTime para especificar quando a implementação está disponível, e -DeadlineDateTime para especificar quando a implementação expira.
Especifique uma série de objetos de agendamento. Um objeto de agenda define o calendário de atribuição obrigatório para uma implantação. Para criar um objeto de agenda, utilize o cmdlet New-CMSchedule.
Type: IResultObject[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-HoráriosEvento
Especifica uma série de eventos que determinam quando a implementação da sequência de tarefas é executado.
Type: ScheduleEventType[]
Parameter Sets: (All)
Aliases:
Accepted values: AsSoonAsPossible, LogOn, LogOff
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SendWakeupPacket
Indica se deve enviar um pacote de despertar para os computadores antes do início da implantação. Se este valor $True for, o Gestor de Configuração acorda um computador do sono. Se este valor $False for, não desperta os computadores do sono. Para que os computadores acordem, primeiro configurar Wake On LAN.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-ShowTaskSequenceProgress
Indica se deve mostrar um diálogo de processo para uma sequência de tarefas.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Instalação de Software
Quando o prazo de instalação for atingido, desloque este parâmetro $true para permitir que a sequência de tarefas seja instalada fora da janela de manutenção.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SystemRestart
Quando o prazo de instalação for atingido, desloque este parâmetro $true para permitir o reinício do sistema, se necessário, fora da janela de manutenção.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-TaskSequencePackageId
Especificar o ID da sequência de tarefas a implementar.
Type: String
Parameter Sets: SearchPackageByIdMandatory
Aliases: PackageId, TaskSequenceId
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseMeteredNetwork
Indica se permite que os clientes de uma ligação à Internet medido descarreguem conteúdo após o prazo de instalação, o que poderá incorrer em custos adicionais.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForAvailableSchedule
Indica se os computadores clientes 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
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-UseUtcForExpireSchedule
Indica se os computadores clientes 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
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
- O QueIf
Apresenta o que aconteceria mediante a execução do cmdlet. O comandante não funciona.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction e -WarningVariable. Para mais informações, consulte about_CommonParameters.
INPUTS
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
OUTPUTS
IResultObject#SMS_Advertisement
NOTAS
Certifique-se de que utiliza os parâmetros de programação adequadamente:
-Disponível101teTime: Especificar quando esta implementação está disponível.
-DeadlineDateTime: Especificar quando a implantação expira.
-Agendamento: Especificar a atribuição de implantação, ou prazo.
RELATED LINKS
Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remover-CMTaskSequenceDeployment