New-CMTaskSequenceDeployment

  • Artigo

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.

Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remover-CMTaskSequenceDeployment

Get-CMTaskSequence

Implementar uma sequência de tarefas