Start-CMTaskSequenceDeployment

Artigo
08/11/2021

SYNOPSIS

(Precatado) Inicie uma implementação de sequência de tarefa.

SYNTAX

SearchByValueMandatory (Padrão)

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>]

SearchPackageByIdMandatory

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 está precotado. Utilize, em vez disso, o Novo CMTaskSequenceDeployment.

Utilize este cmdlet para iniciar 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. Para obter mais informações, consulte implementar uma sequência de tarefas no Gestor de Configuração.

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

Este comando inicia uma implementação de sequência de tarefa utilizando 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 tarefa 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

PARAMETERS

- AlertDateTime

Quando configurar a implementação para criar um alerta para uma implementação bem sucedida, utilize este parâmetro para especificar um objeto DateTime. O Gestor de Configuração cria um alerta de implantação quando o limiar é inferior ao PercentSuccess após esta data.

Para obter este objeto, utilize o cmdlet get-date incorporado.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Dia de Alerta

Este parâmetro está precotado. Utilizar AlertDateTime.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Hora do Alerta

Este parâmetro está precotado. Utilizar AlertDateTime.

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.

Se Clients especificar, o valor predefinido para o parâmetro de Opção de Implantação é DownloadAllContentLocallyBeforeStartingTaskSequence . Se especificar ClientsMediaAndPxe , ou , o valor MediaAndPxe MediaAndPxeHidden predefinido para o parâmetro de Opção de Implantação é DownloadContentLocallyWhenNeededByRunningTaskSequence .

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

-Coleção

Especifique um objeto de recolha para o qual esta sequência de tarefas é implantada. 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

Especificar o ID da coleção para a qual esta sequência de tarefas é implantada.

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

Especificar o nome da coleção para a qual esta sequência de tarefas é implantada.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-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: False
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

-Implementação Disponível10001teTime

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

Utilizar a DeploymentExpireDateTime para especificar quando a implementação expira, e Agendar para especificar a atribuição de implementação, ou prazo.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Dia disponível

Este parâmetro está precotado. Utilizar a implementação DisponívelDa hora .

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Tempo disponível de implementação

Este parâmetro está precotado. Utilizar a implementação DisponívelDa hora .

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentExpireDateTime

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

Utilizar a Implementação DisponívelDa hora 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:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentExpireDay

Este parâmetro está precotado. Utilizar DeploymentExpireDateTime.

Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-DeploymentExpireTime

Este parâmetro está precotado. Utilizar DeploymentExpireDateTime.

Type: DateTime
Parameter Sets: (All)
Aliases:

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.

Se especificar Clients para o parâmetro Disponibilidade, o valor predefinido para este parâmetro é DownloadAllContentLocallyBeforeStartingTaskSequence . Se especificar ClientsMediaAndPxe , ou para o parâmetro MediaAndPxe MediaAndPxeHidden Disponibilidade, o valor padrão para este parâmetro é DownloadContentLocallyWhenNeededByRunningTaskSequence .

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

-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

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

Type: IResultObject
Parameter Sets: SearchByValueMandatory
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-InternetOption

Indica se a sequência de tarefas é de clientes que se conectam através da internet.

Type: Boolean
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

- PassThru

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

Type: SwitchParameter
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 o Tempo de Tempo Disponível para especificar quando a implementação está disponível e o 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

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: False
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

Novo CMTaskSequenceDeployment Get-CMTaskSequenceDeployment Set-CMTaskSequenceDeployment Remover-CMTaskSequenceDeployment

Implementar uma sequência de tarefas no Gestor de Configuração

Partilhar via