Set-CMTaskSequence

Módulo:

ConfigurationManager

Define uma sequência de tarefas do Configuration Manager.

Sintaxe

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   -InputObject <IResultObject>
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceId <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceName <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-CMTaskSequence modifica uma sequência de tarefas do 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: Obter uma sequência de tarefas e alterar o respetivo nome

PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Set-CMTaskSequence -InputObject $TaskSequence -NewName "NewTS01"

O primeiro comando obtém o objeto de sequência de tarefas com o nome TaskSequence01 e armazena o objeto na variável $TaskSequence.

O segundo comando altera o nome da sequência de tarefas armazenada no $TaskSequence para NewTS01.

Exemplo 2: transmitir uma sequência de tarefas e alterar o respetivo nome

PS XYZ:\> Get-CMTaskSequence -Name "TaskSequence02" | Set-CMTaskSequence -NewName "NewTS02"

Este comando obtém o objeto de sequência de tarefas com o nome TaskSequence02 e utiliza o operador de pipeline para transmitir o objeto para Set-CMTaskSequence, que altera o nome do objeto de sequência de tarefas para NewTS02.

Parâmetros

-AddSupportedOperatingSystemPlatform

Adiciona um objeto de plataforma de sistema operativo suportado à sequência de tarefas. Para obter um objeto de plataforma de sistema operativo suportado, utilize o cmdlet Get-CMSupportedPlatform .

Tipo:	IResultObject[]
Aliases:	AddSupportedOperatingSystemPlatforms
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BootImageId

Especifica o ID de uma imagem de arranque.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Category

Especifica uma categoria para a sequência de tarefas. Pode utilizar categorias para agrupar sequências 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

-CustomText

Especifica texto personalizado para a sequência de tarefas. O texto personalizado aparece na caixa de diálogo de notificação de progresso enquanto a sequência de tarefas é executada.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DeploymentPackageId

Especifica o ID de um pacote. Se especificar um valor de $True para o parâmetro RunAnotherProgram , o pacote especificado é executado antes da execuçã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

-Description

Especifica uma descrição para a 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

-DisableTaskSequence

Indica se pretende desativar esta 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

-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

-EnableNotification

Indica se pretende ativar notificações para esta sequência de tarefas.

Tipo:	Boolean
Aliases:	EnableNotifications
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EnableTaskSequence

Indica se pretende ativar esta 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

-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

-HighPerformance

Utilize este parâmetro para definir a seguinte opção na página Desempenho das propriedades da sequência de tarefas: Executar como um esquema de energia de alto desempenho.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-InputObject

Especifica um objeto de sequência de tarefas. Para obter um objeto de sequência de tarefas, utilize o cmdlet Get-CMTaskSequence .

Tipo:	IResultObject
Aliases:	TaskSequence
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	True
Aceitar caracteres curinga:	False

-MaxRunTimeMins

Especifica, em minutos, o tempo máximo de execução da sequência de tarefas.

Tipo:	Int64
Aliases:	Duration
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-NewName

Especifica um novo nome para a 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

-PassThru

Devolve o objeto de trabalho atual. Por padrão, esse cmdlet não gera saída.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ProgramName

Especifica o nome de um programa a executar a partir de um pacote de software do Configuration Manager especificado pelo parâmetro DeploymentPackageId .

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RemoveSupportedOperatingSystemPlatform

Remove um objeto de plataforma de sistema operativo suportado da sequência de tarefas. Para obter um objeto de plataforma de sistema operativo suportado, utilize o cmdlet Get-CMSupportedPlatform .

Tipo:	IResultObject[]
Aliases:	RemoveSupportedOperatingSystemPlatforms
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RunAnotherProgram

Indica se deve executar outro programa antes de executar a sequência de tarefas. Especifique o programa com o parâmetro DeploymentPackageId e o parâmetro ProgramName .

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RunEveryTime

Indica se o programa especificado no parâmetro ProgramName é executado sempre que a sequência de tarefas é executada. Se especificar um valor de $False, o programa não será executado se tiver sido executado com êxito no passado.

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-RunOnAnyPlatform

Indica que a sequência de tarefas é executada em qualquer plataforma do sistema operativo.

Tipo:	SwitchParameter
Aliases:	ClearSupportedOperatingSystemPlatforms
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-SuppressNotification

Indica se pretende suprimir notificações para esta 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

-TaskSequenceId

Especifica o ID de uma sequência de tarefas.

Tipo:	String
Aliases:	Id, TaskSequencePackageId
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TaskSequenceName

Especifica o nome de uma sequência de tarefas.

Tipo:	String
Aliases:	Name
Cargo:	Named
Valor padrão:	None
Obrigatório:	True
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UseBootImage

Indica se a sequência de tarefas utiliza a imagem de arranque especificada com o parâmetro BootImageID .

Tipo:	Boolean
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-UseDefaultText

Indica se deve utilizar texto predefinido na caixa de diálogo de notificação de progresso enquanto a sequência de tarefas é executada. Se selecionar um valor de $False para este parâmetro, certifique-se de que especifica texto personalizado com o parâmetro CustomText .

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

System.Object

Links Relacionados

• New-CMTaskSequence
• Get-CMTaskSequence
• Copy-CMTaskSequence
• Import-CMTaskSequence
• Export-CMTaskSequence
• Remove-CMTaskSequence
• Get-CMSupportedPlatform