Set-CMTaskSequence

SYNOPSIS

Define uma sequência de tarefas do Gestor de Configuração.

SYNTAX

SetByValue (Padrão)

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

SetById

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

SetByName

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 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: Obtenha uma sequência de tarefa e mude o seu nome

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

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

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

Exemplo 2: Passar uma sequência de tarefas e alterar o seu nome

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

Este comando obtém o objeto da sequência de tarefas denominado TaskSequence02 e utiliza o operador do gasoduto para passar o objeto para Set-CMTaskSequence, que altera o nome do objeto da sequência de tarefas para NewTS02.

PARAMETERS

-AddSupportedOperatingSystemPlatform

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

Type: IResultObject[]
Parameter Sets: (All)
Aliases: AddSupportedOperatingSystemPlatforms

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

-BootImageId

Especifica a identificação de uma imagem de arranque.

Type: String
Parameter Sets: (All)
Aliases:

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

-Categoria

Especifica uma categoria para a sequência de tarefas. Pode utilizar categorias para agrupar sequências de tarefas.

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

-Texto personalizado

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 é executado.

Type: String
Parameter Sets: (All)
Aliases:

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

-DeploymentPackageId

Especifica a identificação de um pacote. Se especificar um valor de $True para o parâmetro RunAnotherProgram, o pacote especificado funciona antes da sequência de tarefas ser executada.

Type: String
Parameter Sets: (All)
Aliases:

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

-Descrição

Especifica uma descrição para a sequência de tarefas.

Type: String
Parameter Sets: (All)
Aliases:

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

-DisableTaskSequence

Indica se desativa esta 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

-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

-ActivarNotificação

Indica se deve permitir notificações para esta sequência de tarefas.

Type: Boolean
Parameter Sets: (All)
Aliases: EnableNotifications

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

-EnableTaskSequence

Indica se ativa esta 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

-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

-HighPerformance

A partir da versão 1910, utilize este parâmetro para definir a seguinte opção na página performance das propriedades da sequência de tarefas: Executar como plano de potência de alto desempenho .

Type: Boolean
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 obter um objeto de sequência de tarefa, utilize o cmdlet Get-CMTaskSequence.

Type: IResultObject
Parameter Sets: SetByValue
Aliases: TaskSequence

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

-MaxRunTimeMins

Especifica, em minutos, o tempo máximo de funcionamento para a sequência de tarefas.

Type: Int64
Parameter Sets: (All)
Aliases: Duration

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

-Novo Nome

Especifica um novo nome para a sequência de tarefas.

Type: String
Parameter Sets: (All)
Aliases:

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

- PassThru

Devolve o objeto de trabalho atual. Por predefinição, este cmdlet não gera quaisquer dados.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

- Nome do Programa

Especifica o nome de um programa a ser executado a partir de um pacote de software Do Gestor de Configuração especificado pelo parâmetro DeploymentPackageId.

Type: String
Parameter Sets: (All)
Aliases:

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

-Remover Sistemas de Operações SuportadosPlatform

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

Type: IResultObject[]
Parameter Sets: (All)
Aliases: RemoveSupportedOperatingSystemPlatforms

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

-RunAnotherProgram

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RunEveryTime

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-RunOnAnyPlatform

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

Type: SwitchParameter
Parameter Sets: (All)
Aliases: ClearSupportedOperatingSystemPlatforms

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

-Suprimir aNotificação

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

-TaskSequenceId

Especifica a identificação de uma sequência de tarefas.

Type: String
Parameter Sets: SetById
Aliases: Id, TaskSequencePackageId

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

- Nome de Tarefasequence

Especifica o nome de uma sequência de tarefas.

Type: String
Parameter Sets: SetByName
Aliases: Name

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

-UseBootImage

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

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UseDefaultText

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

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 cmdlet não é executado.

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

Sistema.Objeto

NOTAS

RELATED LINKS

Nova CMTaskSequence Get-CMTaskSequence Cópia-CMTaskSequence Importação-CMTaskSequence Exportação-CMTaskSequence Remover-CMTaskSequence Get-CMSupportedPlatform